vous pouvez utiliser les tâches Ant TaskCompileXPath, TaskCompileXQuery et TaskCompileXSLT comme alternatives aux commandes CompileXPath, CompileXQuery et CompileXSLT.
Pourquoi et quand exécuter cette tâche
Eléments des tâches ANT :
- argType
- Cet élément indique le type des arguments de fonction tels que localpart et namespaceURI.
Paramètres spécifiés en tant qu'éléments imbriqués :- localpart
- Un élément localpart imbriqué doit être spécifié pour indiquer la partie locale du nom qualifié.
- namespaceURI
- Un élément namespaceURI imbriqué peut être spécifié pour indiquer l'URI de l'espace de noms.
Exemple :
<argType>
<localpart>boolean</localpart>
<namespaceURI>"http://www.w3.org/2001/XMLSchema"</namespaceURI>
</argType>
- baseURI
- Cet élément indique l'URI de base de l'élément conteneur.
Exemple :
<baseURI>"http://www.ibm.com/Los Angeles"</baseURI>
- bsp
- Cet élément indique les règles de l'espace de limite.
Les valeurs valides sont les suivantes :
- 1 = conserver les espaces
- 2 = supprimer les espaces
La valeur par défaut est 2 (supprimer les espaces).
- cnmi
- Cet élément indique la partie héritage des espaces de noms de copie.
Les valeurs valides sont les suivantes :
- 1 = héritage
Le mode héritage doit être utilisé dans l'affectation des liens d'espace de nom quand un noeud d'élément existant est copié par un constructeur d'élément.
- 2 = sans héritage
Le mode sans héritage doit être utilisé dans l'affectation des liens d'espace de nom quand un noeud d'élément existant est copié par un constructeur d'élément.
La valeur par défaut est 1 (héritage).
- cnmp
- Cet élément indique la partie conservation des espaces de noms de copie.
Les valeurs valides sont les suivantes :
- 1 = conservation
Le mode conservation doit être utilisé dans l'affectation des liens d'espace de nom quand un noeud d'élément existant est copié par un constructeur d'élément.
- 2 = sans conservation
Le mode sans conservation doit être utilisé dans l'affectation des liens d'espace de nom quand un noeud d'élément existant est copié par un constructeur d'élément.
La valeur par défaut est 1 (conservation).
- cpm
- Cet élément indique un mode de compatibilité alternatif pour XPath.
Les valeurs admises sont les suivantes :
Par exemple, entrez 1.0 pour définir la compatibilité avec XPath version 1.0.
La valeur par défaut est 2.0.
- csm
- Cet élément indique le mode de construction.
Les valeurs valides sont les suivantes :
- 1 = conservation
Le type d'un noeud d'élément de construction est xs:anyType et tous les noeuds d'attribut et d'élément copiés pendant la construction du noeud conservent leur type d'origine.
- 2 = suppression
Le type d'un noeud d'élément de construction est xs:untyped. Tous les noeuds d'élément copiés pendant la construction du noeud reçoivent le type
xs:untyped et tous les noeuds d'attribut copiés pendant la construction du noeud reçoivent le type xs:untypedAtomic.
La valeur par défaut est 1 (conservation).
- dir
- Cet élément indique un répertoire de destination pour les fichiers exécutables.
La valeur par défaut est le répertoire de travail en cours.
Si la valeur contient un espace, encadrez-la avec des guillemets.
Exemple :
<dir>C:/precompiledXSLT</dir>
- dnet
- Cet élément indique un URI d'espace de noms par défaut pour le nom de l'élément et le nom du type.
S'il est spécifié, l'URI d'espace de nom est utilisé pour remplacer tout
QName avec préfixe qui apparaît à une position où un nom d'élément ou de type est attendu.
Exemple :
<dnet>http://example.org/ibm</dnet>
- dnf
- Cet élément indique un URI d'espace de noms par défaut pour les noms de fonction.
S'il est spécifié, l'URI d'espace de nom est utilisé pour remplacer tout
QName avec préfixe qui apparaît à une position où un nom de fonction est attendu.
Exemple :
<dnf>http://my.org</dnf>
- eso
- Cet élément indique l'ordre des séquences vides.
Les valeurs admises sont les suivantes :
- 1 = en premier
- 2 = en dernier
La valeur par défaut est 2 (séquences vides en dernier)
- function
- Pour les tâches CompileXSLT, CompileXPath et CompileXQuery, cet élément définit une fonction et la relie avec le contexte statique pour un élément déterminé. Notez que cet élément déclare uniquement la fonction et qu'un objet de méthode doit également être lié au contexte dynamique pour cette fonction. Cet élément peut être spécifié plusieurs fois.
Paramètres spécifiés en tant qu'éléments imbriqués :
- name
- Un élément imbriqué name doit être spécifié pour indiquer le nom de la fonction.
- type
- Un élément imbriqué type doit être spécifié pour indiquer le type de la fonction.
- argType
- Un élément imbriqué argType peut être spécifié pour indiquer le type des arguments de la fonction.
Cet élément est facultatif. Il peut être spécifié plusieurs fois.
Exemple :
<function>
<name>
<localpart>la</localpart>
<namespaceURI>"http://www.ibm.com/Los Angeles"</namespaceURI>
</name>
<type>
<localpart>boolean</localpart>
<namespaceURI>http://www.w3.org/2001/XMLSchema</namespaceURI>
</type>
</function>
- imm
- Cet élément définit le mode mathématique integer, qui correspond à une constante indiquant le niveau de précision demandé et si la détection du dépassement de capacité est requise quand des valeurs xs:integer sont utilisées.
Les valeurs valides sont les suivantes :
- 1 = les valeurs doivent respecter la précision minimale requise pour un processeur conforme à minima (18 chiffres).
- 2 = les valeurs peuvent comprendre un nombre arbitraire d'unités de précision et aucun dépassement de capacité ne doit avoir lieu.
- 3 = les valeurs doivent respecter la précision minimale requise pour un processeur conforme à minima (18 chiffres) et les dépassement de capacité doivent être détectés et déclencher une erreur FOAR0002.
- inputfile
- Cet élément indique le chemin complet d'un fichier contenant un code XSL, XPath ou XQuery à compiler.
Exemple :
<inputfile>C:/XSLT/simple.xsl</inputfile>
- localpart
- Cet élément indique la partie locale d'un nom qualifié.
Exemple :
<localpart>la</localpart>
- name
- Cet élément indique le nom de la fonction ou de la variable (localpart et namespaceURI).
Dans le cas d'une
variable, c'est-à-dire sans espace de nom, l'URI d'espace de nom ne doit pas être spécifié.
Paramètres spécifiés en tant qu'éléments imbriqués :
- localpart
- Un élément localpart imbriqué doit être spécifié pour indiquer la partie locale du nom qualifié.
- namespaceURI
- Un élément namespaceURI imbriqué peut être spécifié pour indiquer l'URI de l'espace de noms.
Exemple :
<name>
<localpart>la</localpart>
<namespaceURI>"http://www.ibm.com/Los Angeles"</namespaceURI>
</name>
- namespaceURI
- Cet élément indique la partie URI d'espace de nom d'un nom qualifié.
Si la valeur contient un espace, placez-la entre guillemets.
Exemple :
<namespaceURI>"http://www.ibm.com/Los Angeles"</namespaceURI>
- ns
- Cet élément indique un espace de nom à utiliser pendant le traitement statique.
La valeur doit être spécifiée sous la forme prefix=URI.
Si la valeur contient un espace, encadrez-la avec des guillemets.
Cet élément peut être spécifié plusieurs fois.
Exemple :
<ns>my=http://www.example.com/examples</ns>
- ordm
- Cet élément indique le mode d'ordonnancement.
Les valeurs valides sont les suivantes :
- 1 = les résultats doivent être renvoyés ordonnés pour certaines expressions path, pour les expressions union, intersect et except ainsi que pour les expressions FLWOR n'ayant pas de clause
order by.
- 2 = les résultats doivent être renvoyés non ordonnés pour certaines expressions path, pour les expressions union, intersect et except ainsi que pour les expressions FLWOR n'ayant pas de clause order by.
La valeur par défaut est 1 (ordonné).
- out
- Cet élément indique le nom du fichier exécutable généré.
Le nom par défaut d'un fichier exécutable est XSLTModule, XPathModule ou XQueryModule, selon la tâche utilisée.
Cette option est ignorée si vous compilez plusieurs fichiers en même temps.
Exemple :
<out>sample</out>
- dir
- Cet élément indique un répertoire de destination pour les fichiers exécutables.
La valeur par défaut est le répertoire de travail en cours.
Si la valeur contient un espace, encadrez-la avec des guillemets.
Exemple :
<pkg>com.mycompany.precompiled</pkg>
- schéma
- Cet élément indique un document de schéma qui sera utilisé pour renseigner les définitions de schéma par portée.
Cet élément peut être spécifié plusieurs fois.
Exemple :
<schema>C:/samples/xpath/variousTypesNodeTest.xsd</schema>
- type
- Cet élément indique le type de la fonction ou de la variable (localpart et namespaceURI).
Paramètres spécifiés en tant qu'éléments imbriqués :
- localpart
- Un élément localpart imbriqué doit être spécifié pour indiquer la partie locale du nom qualifié.
- namespaceURI
- Un élément namespaceURI imbriqué peut être spécifié pour indiquer l'URI de l'espace de noms.
Exemple :
<type>
<localpart>boolean</localpart>
<namespaceURI>"http://www.w3.org/2001/XMLSchema"</namespaceURI>
</type>
- variable
- Cet élément définit une
variable et la relie au contexte statique pour un élément déterminé.
Cet élément déclare uniquement la variable et une valeur doit être liée au contexte dynamique.
Cet élément peut être spécifié plusieurs fois.
Paramètres spécifiés en tant qu'éléments imbriqués :
- name
- Un élément imbriqué name doit être spécifié pour indiquer le nom de la variable.
- type
- Un élément imbriqué type doit être spécifié pour indiquer le type de la variable.
Exemple :
<variable>
<name>
<localpart>booleanVar</localpart>
</name>
<type>
<localpart>boolean</localpart>
<namespaceURI>http://www.w3.org/2001/XMLSchema</namespaceURI>
</type>
</variable>
Procédure
- Utiliser TaskCompileXPath
Vous pouvez utiliser cette tâche pour précompiler une ou plusieurs expressions XPath. Vous obtiendrez un ensemble de
classes Java™ que vous pourrez utiliser ensuite pour exécuter les expressions en évitant la charge d'une compilation dynamique.
Paramètres spécifiés en tant qu'éléments imbriqués :
- out
- Un élément imbriqué out indique le nom du fichier exécutable généré.
Le nom par défaut d'un fichier exécutable est XPathModule.
- dir
- Un élément imbriqué dir indique un répertoire de destination pour les fichiers exécutables.
La valeur par défaut est le répertoire de travail en cours.
- pkg
- Un élément imbriqué pkg indique le préfixe d'un nom du module pour toutes les classes générées.
La valeur par défaut est le module par défaut Java.
- cpm
- Un élément imbriqué cpm indique un mode de compatibilité alternatif pour XPath.
- ns
- Un élément imbriqué ns indique un espace de nom à utiliser pendant le traitement statique.
- schéma
- Un élément imbriqué schema indique un document de schéma qui sera utilisé pour renseigner les définitions de schéma par portée.
- function
- Vous pouvez spécifier une définition function imbriquée.
Cet élément crée une liaison de fonction avec le contexte statique pour un élément déterminé.
- variable
- Vous pouvez spécifier une définition variable imbriquée.
Cet élément ajoute une liaison de variable avec le contexte statique pour un élément déterminé.
- baseURI
- Un élément imbriqué baseURI indique l'URI de base de l'élément conteneur.
- dnet
- Un élément imbriqué dnet indique un URI d'espace de noms par défaut pour le nom de l'élément et le nom du type.
- dnf
- Un élément imbriqué dnf indique un URI d'espace de noms par défaut pour les noms de fonction.
- imm
- Un élément imbriqué imm indique le mode mathématique integer, qui correspond à une constante indiquant le niveau de précision demandé et si la détection du dépassement de capacité est requise quand des valeurs xs:integer sont utilisées.
- inputfile
- Un élément imbriqué inputfile indique le chemin complet d'un fichier contenant une expression XPath à compiler.
Remarque : Cet élément est obligatoire. Il peut être spécifié plusieurs fois.
Exemple :<target name="testXPath">
<taskdef name="compileXPath" classname="com.ibm.xml.xapi.ant.TaskCompileXPath"/>
<compileXPath>
<out>sample</out>
<dir>"C:/precompiledXPath"</dir>
<pkg>com.mycompany.precompiled</pkg>
<variable>
<name>
<localpart>booleanVar</localpart>
</name>
<type>
<localpart>boolean</localpart>
<namespaceURI>http://www.w3.org/2001/XMLSchema</namespaceURI>
</type>
</variable>
<inputfile>C:/XPath/xpath.txt</inputfile>
</compileXPath>
</target>
- Utiliser TaskCompileXQuery
Vous pouvez utiliser cette tâche pour précompiler une ou plusieurs expressions XQuery. Vous obtiendrez un ensemble de
classes Java que vous pourrez utiliser ensuite pour exécuter les expressions en évitant la charge d'une compilation dynamique.
Paramètres spécifiés en tant qu'éléments imbriqués :
- out
- Un élément imbriqué out indique le nom du fichier exécutable généré.
Le nom par défaut d'un fichier exécutable est XQueryModule.
- dir
- Un élément imbriqué dir indique un répertoire de destination pour les fichiers exécutables.
La valeur par défaut est le répertoire de travail en cours.
- pkg
- Un élément imbriqué pkg indique le préfixe d'un nom du module pour toutes les classes générées.
La valeur par défaut est le module par défaut Java.
- function
- Vous pouvez spécifier une définition function imbriquée.
Cet élément crée une liaison de fonction avec le contexte statique pour un élément déterminé.
- baseURI
- Un élément imbriqué baseURI indique l'URI de base de l'élément conteneur.
- dnet
- Un élément imbriqué dnet indique un URI d'espace de noms par défaut pour le nom de l'élément et le nom du type.
- dnf
- Un élément imbriqué dnf indique un URI d'espace de noms par défaut pour les noms de fonction.
- imm
- Un élément imbriqué imm indique le mode mathématique integer, qui correspond à une constante indiquant le niveau de précision demandé et si la détection du dépassement de capacité est requise quand des valeurs xs:integer sont utilisées.
- bsp
- Un élément imbriqué bsp indique les règles de l'espace de limite.
- csm
- Un élément imbriqué csm indique le mode de construction.
- cnmi
- Un élément imbriqué cnmi indique la partie héritage des espaces de noms de copie.
- cnmp
- Un élément imbriqué cnmp indique la partie conservation des espaces de noms de copie.
- eso
- Un élément imbriqué eso indique l'ordre des séquences vides.
- ordm
- Un élément imbriqué ordm indique le mode d'ordonnancement.
- inputfile
- Un élément imbriqué inputfile indique le chemin complet d'un fichier contenant une expression XQuery à compiler. Cet élément est obligatoire. Il peut être spécifié plusieurs fois.
Exemple :<target name="testXQuery">
<taskdef name="compileXQuery" classname="com.ibm.xml.xapi.ant.TaskCompileXQuery"/>
<compileXQuery>
<out>sample</out>
<dir>"C:/precompiledXQuery"</dir>
<pkg>com.mycompany.precompiled</pkg>
<inputfile>C:/XQuery/xquery.sq</inputfile>
</compileXQuery>
</target>
- Utiliser TaskCompileXSLT
Vous pouvez utiliser cette tâche pour précompiler une ou plusieurs feuilles de style. Vous obtiendrez un ensemble de
classes Java que vous pourrez utiliser ensuite pour exécuter des transformations en évitant la charge d'une compilation dynamique.
Paramètres spécifiés en tant qu'éléments imbriqués :
- out
- Un élément imbriqué out indique le nom du fichier exécutable généré.
Le nom par défaut d'un fichier exécutable est XSLTModule.
Cet élément est ignoré si vous compilez plusieurs feuilles de style en même temps.
- dir
- Un élément imbriqué dir indique un répertoire de destination pour les fichiers exécutables.
La valeur par défaut est le répertoire de travail en cours.
- pkg
- Un élément imbriqué pkg indique le préfixe d'un nom du module pour toutes les classes générées.
La valeur par défaut est le module par défaut Java.
- function
- Vous pouvez spécifier une définition function imbriquée.
Cet élément crée une liaison de fonction avec le contexte statique pour un élément déterminé.
- baseURI
- Un élément imbriqué baseURI indique l'URI de base de l'élément conteneur.
- imm
- Un élément imbriqué imm indique le mode mathématique integer, qui correspond à une constante indiquant le niveau de précision demandé et si la détection du dépassement de capacité est requise quand des valeurs xs:integer sont utilisées.
- inputfile
- Un élément imbriqué inputfile indique le chemin complet d'un fichier contenant une feuille de style XSL à compiler.
Remarque : Cet élément est obligatoire. Il peut être spécifié plusieurs fois.
Exemple :<target name="testXSLT">
<taskdef name="compileXSLT" classname="com.ibm.xml.xapi.ant.TaskCompileXSLT"/>
<compileXSLT>
<out>sample</out>
<dir>"C:/precompiledXSLT"</dir>
<pkg>com.mycompany.precompiled</pkg>
<function>
<name>
<localpart>la</localpart>
<namespaceURI>"http://www.ibm.com/Los Angeles"</namespaceURI>
</name>
<type>
<localpart>boolean</localpart>
<namespaceURI>http://www.w3.org/2001/XMLSchema</namespaceURI>
</type>
</function>
<inputfile>C:/XSLT/simple.xsl</inputfile>
</compileXSLT>
</target>