Puede utilizar las tareas ANT TaskCompileXPath, TaskCompileXQuery i
TaskCompileXSLT como alternativas a la utilización de los mandatos CompileXPath,
CompileXQueryy CompileXSLT.
Acerca de esta tarea
Elementos de tareas ANT:
- argType
- Este elemento indica los tipos de argumentos de funciones expresados en términos de localpart y namespaceURI.
Parámetros especificados como elementos anidados:- localpart
- Se debe especificar un elemento localpart para proporcionar la parte local del nombre calificado.
- namespaceURI
- Se puede especificar un elemento namespaceURI anidado para indicar namespaceURI.
Ejemplo:
<argType>
<localpart>boolean</localpart>
<namespaceURI>"http://www.w3.org/2001/XMLSchema"</namespaceURI>
</argType>
- baseURI
- Este elemento especifica el URI base del elemento que lo contiene.
Ejemplo:
<baseURI>"http://www.ibm.com/Los Angeles"</baseURI>
- bsp
- Este elemento especifica la política de espacio de límites.
Los valores válidos incluyen:
- 1 = conservar espacios en blanco
- 2 = quitar espacios en blanco
El valor predeterminado es 2 (quitar espacios en blanco).
- cnmi
- Este elemento especifica la parte heredada de los espacios de copy-namespaces.
Los valores válidos incluyen:
- 1 = heredar
La modalidad Heredar se debería utilizar en la asignación de enlaces de espacios de nombres cuando un constructor de elementos copia el nodo de elemento existente.
- 2 = sin heredar
La modalidad Sin heredar se debería utilizar en la asignación de enlaces de espacios de nombres cuando un constructor de elementos copia un nodo de elemento existente.
El valor predeterminado es 1 (heredar).
- cnmp
- Este elemento especifica la parte que se debe conservar de copy-namespaces.
Los valores válidos incluyen:
- 1 = conservar
La modalidad Conservar se debería utilizar en la asignación de enlaces de espacios de nombres cuando un constructor de elementos copia el nodo de elemento existente.
- 2 = no conservar
La modalidad No conservar se debería utilizar en la asignación de enlaces de espacios de nombres cuando un constructor de elementos copia un nodo de elemento existente.
El valor predeterminado es 1 (conservar).
- cpm
- Este elemento especifica una modalidad de compatibilidad XPath alternativa.
Los valores válidos son:
Por ejemplo: utilice 1.0 para que haya compatibilidad con la versión 1.0 de
XPath.
El valor predeterminado es 2.0.
- csm
- Este elemento especifica la modalidad de construcción.
Los valores válidos incluyen:
- 1 = conservar
El tipo de un nodo de elemento construido es xs:anyType, y todos los nodos de atributos y elementos copiados durante la construcción de nodos conservan sus tipos originales.
- 2 = quitar
El tipo de un nodo de elemento construido es xs:untyped, todos los nodos de elementos copiados durante la construcción del nodo reciben el tipo xs:untyped, y todos los nodos de atributos copiados durante la construcción del nodo reciben el tipo xs:untypedAtomic.
El valor predeterminado es 1 (conservar).
- dir
- Este elemento especifica un directorio de destino para los ejecutables.
El valor predeterminado es el directorio de trabajo actual.
Si el valor contiene un espacio en blanco, escríbalo entre comillas.
Ejemplo:
<dir>C:/precompiledXSLT</dir>
- dnet
- Este elemento especifica un URI de espacio de nombres predeterminado para los nombres de elemento y de tipo.
El URI de espacio de nombres, si existe, lo utiliza el valor QName no prefijado que aparece en una posición en la que se espera un nombre de elemento o de tipo.
Ejemplo:
<dnet>http://example.org/ibm</dnet>
- dnf
- Este elemento especifica un URI de espacio de nombres predeterminado para los nombres de función.
El URI de espacio de nombres, si existe, lo utiliza el valor
QName no prefijado que aparece en una posición en la que se espera un nombre de función.
Ejemplo:
<dnf>http://my.org</dnf>
- eso
- Este elemento especifica el orden de secuencia vacío.
Los valores válidos incluyen:
El valor predeterminado es 2 (la menor cantidad de secuencias vacías).
- función
- Para las tareas CompileXSLT, CompileXPath y CompileXQuery, este elemento define y enlaza una función al contexto estático para un solo elemento. Observe que solamente se declara la función y que también debe haber un objeto de método para la función que esté enlazado al contexto dinámico. Nota:
este elemento se puede especificar diversas veces.
Parámetros especificados como elementos anidados:
- name
- Se debe especificar un elemento con nombre anidado para indicar el nombre de la función.
- type
- Se debe especificar un elemento de tipo anidado para indicar el tipo de la función.
- argType
- Se puede especificar un elemento argTye anidado para indicar los tipos de argumentos de la función.
Este elemento es opcional y se puede especificar diversas veces.
Ejemplo:
<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
- Este elemento establece la modalidad de coincidencia de enteros, que es una constante que representa el nivel de precisión necesario y si es necesaria la detección de un desbordamiento cuando se trabaja con valores xs:integer.
Los valores válidos incluyen:
- 1 = valores necesarios solamente dan soporte a la mínima precisión necesaria para un procesador de conformación mínimo (18 dígitos)
- 2 = valores deberían dar soporte a una cantidad arbitraria de dígitos de precisión; no se debería producir el desbordamiento
- 3 = valores necesarios solamente dan soporte a la mínima precisión necesaria para un procesador de conformación mínimo (18 dígitos) pero se debería detectar cualquier condición de desbordamiento y se debería llegar al error FOAR0002.
- inputfile
- Este elemento especifica la vía de acceso completa a un archivo que contiene un XSL, XPath o XQuery que se debe compilar.
Ejemplo:
<inputfile>C:/XSLT/simple.xsl</inputfile>
- localpart
- Este elemento indica la parte local de un nombre calificado.
Ejemplo:
<localpart>la</localpart>
- name
- Este elemento indica el nombre de la función o variable (expresada en término de localpart y namespaceURI).
En el caso de una
variable que no esté en espacio de nombres, se deberá omitir el URI de espacio de nombres.
Parámetros especificados como elementos anidados:
- localpart
- Se debe especificar un elemento localpart para proporcionar la parte local del nombre calificado.
- namespaceURI
- Se puede especificar un elemento namespaceURI anidado para indicar namespaceURI.
Ejemplo:
<name>
<localpart>la</localpart>
<namespaceURI>"http://www.ibm.com/Los Angeles"</namespaceURI>
</name>
- namespaceURI
- Este elemento indica la parte namespaceURI de un nombre calificado.
Si el valor contiene un espacio en blanco escríbalo entre comillas.
Ejemplo:
<namespaceURI>"http://www.ibm.com/Los Angeles"</namespaceURI>
- ns
- Este elemento especifica un espacio de nombres para utilizarlo durante el proceso estático.
El valor se debería especificar como
prefix=URI.
Si el valor contiene un espacio en blanco, escríbalo entre comillas.
Este elemento se puede utilizar diversas veces.
Ejemplo:
<ns>my=http://www.example.com/examples</ns>
- ordm
- Este elemento especifica la modalidad de ordenación.
Los valores válidos incluyen:
- 1 = los resultados ordenados los deben devolver ciertas expresiones de vía de acceso, unión, intersección y expresiones de excepción, y las expresiones FLWOR que no tienen ningún orden especificado mediante la cláusula
- 2 = los resultados sin ordenar los deben devolver ciertas expresiones de vía de acceso, unión, intersección y expresiones de excepción, y las expresiones FLWOR que no tienen ningún orden especificado mediante la cláusula
El valor predeterminado es 1 (ordenado).
- out
- Este elemento especifica el nombre del ejecutable generado.
El nombre del ejecutable predeterminado es
XSLTModule, XPathModule o XQueryModule dependiendo de la tarea correspondiente.
Esta opción se ignora si se compilan varios archivos.
Ejemplo:
<out>sample</out>
- dir
- Este elemento especifica un directorio de destino para los ejecutables.
El valor predeterminado es el directorio de trabajo actual.
Si el valor contiene un espacio en blanco, escríbalo entre comillas.
Ejemplo:
<pkg>com.mycompany.precompiled</pkg>
- esquema
- Este elemento especifica un documento de esquema que se utilizará para rellenar las definiciones de esquema en el ámbito.
Este elemento se puede utilizar diversas veces.
Ejemplo:
<schema>C:/samples/xpath/variousTypesNodeTest.xsd</schema>
- type
- Este elemento indica el tipo de la función o variable expresado en términos de localpart y namespaceURI.
Parámetros especificados como elementos anidados:
- localpart
- Se debe especificar un elemento localpart para proporcionar la parte local del nombre calificado.
- namespaceURI
- Se puede especificar un elemento namespaceURI anidado para indicar namespaceURI.
Ejemplo:
<type>
<localpart>boolean</localpart>
<namespaceURI>"http://www.w3.org/2001/XMLSchema"</namespaceURI>
</type>
- variable
- Este elemento define y enlaza una variable al contexto estático para un solo elemento.
Esta acción solamente declara la variable, y debe haber un valor que enlace al contexto dinámico.
Este elemento se puede especificar diversas veces.
Parámetros especificados como elementos anidados:
- name
- Se debe especificar un elemento con nombre anidado para indicar el nombre de la variable.
- type
- Se debe especificar un elemento de tipo anidado para indicar el tipo de la variable.
Ejemplo:
<variable>
<name>
<localpart>booleanVar</localpart>
</name>
<type>
<localpart>boolean</localpart>
<namespaceURI>http://www.w3.org/2001/XMLSchema</namespaceURI>
</type>
</variable>
Procedimiento
- Utilizar TaskCompileXPath
Esta tarea se puede utilizar para precompilar una o varias expresiones
XPath. La salida será un conjunto de clases Java™ que se pueden utilizar posteriormente para ejecutar las expresiones sin la sobrecarga de rendimiento de la compilación dinámica.
Parámetros especificados como elementos anidados:
- out
- Un valor out anidado especifica el nombre del ejecutable generado.
El nombre del ejecutable predeterminado es
XPathModule.
- dir
- Un valor dir anidado especifica un directorio de destino para los ejecutables.
El valor predeterminado es el directorio de trabajo actual.
- pkg
- Un valor pkg anidado especifica un prefijo de nombre de paquete para todas las clases generadas.
El valor predeterminado es el paquete predeterminado
Java.
- cpm
- Un valor cpm anidado especifica una modalidad de compatibilidad XPath alternativa.
- ns
- Un valor ns anidado especifica un espacio de nombres para utilizarlo durante un proceso estático.
- esquema
- Un valor schema anidado especifica un documento de esquema que se utilizará para llenar las definiciones de esquema en el ámbito.
- función
- Se puede especificar una definición de function anidada.
Este valor creará una función que enlazará al contexto estático de un solo elemento.
- variable
- Se puede especificar una definición de variable anidada.
Este valor añadirá una variable que enlazará al contexto estático de un solo elemento.
- baseURI
- Un valor baseURI anidado especifica el URI base del elemento que lo contiene.
- dnet
- Un valor dnet anidado especifica un URI de espacio de nombres predeterminado para los nombres de elemento y de tipo.
- dnf
- Un valor dnf anidado especifica un URI de espacio de nombres predeterminado par los nombres de función.
- imm
- Un valor imm anidado establece la modalidad de coincidencia de enteros, que es una constante que representa el nivel de precisión necesario y si es necesaria la detección de un desbordamiento cuando se trabaja con valores xs:integer.
- inputfile
- Un valor inputfile anidado especifica la vía de acceso completa a un archivo que contiene la expresión
XPath que se debe compilar.
Nota: Este elemento es necesario y se puede utilizar diversas veces.
Ejemplo: <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>
- Utilizar TaskCompileXQuery
Esta tarea se puede utilizar para precompilar una o varias expresiones
XQuery. La salida será un conjunto de clases Java que se pueden utilizar posteriormente para ejecutar las expresiones sin la sobrecarga de rendimiento de la compilación dinámica.
Parámetros especificados como elementos anidados:
- out
- Un valor out anidado especifica el nombre del ejecutable generado.
El nombre del ejecutable predeterminado es
XQueryModule.
- dir
- Un valor dir anidado especifica un directorio de destino para los ejecutables.
El valor predeterminado es el directorio de trabajo actual.
- pkg
- Un valor pkg anidado especifica un prefijo de nombre de paquete para todas las clases generadas.
El valor predeterminado es el paquete predeterminado
Java.
- función
- Se puede especificar una definición de function anidada.
Este valor creará una función que enlazará al contexto estático de un solo elemento.
- baseURI
- Un valor baseURI anidado especifica el URI base del elemento que lo contiene.
- dnet
- Un valor dnet anidado especifica un URI de espacio de nombres predeterminado para los nombres de elemento y de tipo.
- dnf
- Un valor dnf anidado especifica un URI de espacio de nombres predeterminado par los nombres de función.
- imm
- Un valor imm anidado establece la modalidad de coincidencia de enteros, que es una constante que representa el nivel de precisión necesario y si es necesaria la detección de un desbordamiento cuando se trabaja con valores xs:integer.
- bsp
- Un valor bsp anidado especifica la política de espacio de límite.
- csm
- Un valor csm anidado especifica la modalidad de construcción.
- cnmi
- Un valor cnmi anidado especifica la parte heredada de copy-namespaces.
- cnmp
- Un valor cnmp anidado especifica la parte conservada de copy-namespaces.
- eso
- Un valor eso anidado especifica el orden de secuencia vacía.
- ordm
- Un valor ordm anidado especifica le modalidad de ordenación.
- inputfile
- Un valor inputfile anidado especifica la vía de acceso completa a un archivo que contiene una expresión
XQuery que se debe compilar. Nota: este elemento es necesario y se puede utilizar diversas veces.
Ejemplo: <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>
- Utilizar TaskCompileXSLT
Esta tarea se puede utilizar para precompilar una o varias hojas de estilo. La salida será un conjunto de clases Java que se pueden utilizar posteriormente para ejecutar transformaciones sin la sobrecarga de rendimiento de la compilación dinámica.
Parámetros especificados como elementos anidados:
- out
- Un valor out anidado especifica el nombre del ejecutable generado.
El nombre del ejecutable predeterminado es
XSLTModule.
Este elemento se ignora si se compilan diversas hojas de estilo.
- dir
- Un valor dir anidado especifica un directorio de destino para los ejecutables.
El valor predeterminado es el directorio de trabajo actual.
- pkg
- Un valor pkg anidado especifica un prefijo de nombre de paquete para todas las clases generadas.
El valor predeterminado es el paquete predeterminado
Java.
- función
- Se puede especificar una definición de function anidada.
Este valor creará una función que enlazará al contexto estático de un solo elemento.
- baseURI
- Un valor baseURI anidado especifica el URI base del elemento que lo contiene.
- imm
- Un valor imm anidado establece la modalidad de coincidencia de enteros, que es una constante que representa el nivel de precisión necesario y si es necesaria la detección de un desbordamiento cuando se trabaja con valores xs:integer.
- inputfile
- Un valor inputfile anidado especifica la vía de acceso completa a un archivo que contiene una hoja de estilo
XSL que se debe compilar.
Nota: Este elemento es necesario y se puede utilizar diversas veces.
Ejemplo: <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>