Mandato schemagen para aplicaciones JAXB

Utilice la herramienta de generador de esquemas, schemagen, para generar un esquema XML utilizando JAXB (Java™ Architecture for XML Binding).

Utilices las herramientas y las API de JAXB para establecer correlaciones entre un esquema XML y clases Java. Los esquemas XML describen los elementos de datos y las relaciones de un documento XML. Después de un enlace o una correlación de datos, puede convertir documentos XML en objetos Java, y viceversa. Ahora puede acceder a datos almacenados en un documento XML sin la necesidad de comprender la estructura de los datos.

Puede generar un archivo de esquema a partir de clases Java utilizado la herramienta de generador de esquema schemagen para crear el esquema XML. Una vez exista la correlación entre el esquema XML y las clases Java, los documentos de instancia XML pueden convertirse en y desde objetos Java mediante el uso de la API de tiempo de ejecución de enlace JAXB. Las clases Java resultantes contienen toda la información necesaria que el tiempo de ejecución de JAXB necesita a fin de analizar el XML para clasificar y desclasificar. Puede utilizar las clases JAXB en las aplicaciones JAX-WS (Java API for XML Web Services) o en las aplicaciones Java que no sean JAX-WS, para procesar datos XML.

Supported configurations Supported configurations: Las herramientas de línea de mandatos wsimport, wsgen, schemagen y xjc no tienen soporte en la plataforma z/OS. Esta funcionalidad la proporcionan las herramientas de ensamblaje proporcionadas con WebSphere Application Server que se ejecutan en la plataforma z/OS. Obtenga información sobre estas herramientas de línea de mandatos para las aplicaciones JAX-WS para obtener más información sobre estas herramientas. sptcfg
Best practice Best practice: WebSphere Application Server proporciona la API Java para servicios web basados en XML (JAX-WS) y las herramientas de arquitectura Java para enlaces XML (JAXB). Las herramientas de línea de mandatos wsimport, wsgen, schemagen y xjc se encuentran en el directorio raíz_servidor_aplicaciones\bin\ de WebSphere Application Server tradicional. Los mandatos xjc y schemagen se encuentran en el directorio raíz_servidor_aplicaciones\jaxb\bin\ del perfil Liberty. En algunas ocasiones, los artefactos generados por las herramientas que proporcionan WebSphere Application Server y JDK dan soporte a los mismos niveles de las especificaciones. En general, los artefactos generados por las herramientas JDK tienen portabilidad en otros entornos de ejecución compatibles. Sin embargo, es más recomendable utilizar las herramientas que se proporcionan con este producto para alcanzar una integración sin interrupciones dentro del entorno de WebSphere Application Server y aprovechar las características que puedan estar soportadas únicamente en WebSphere Application Server. Para aprovechar las herramientas de JAX-WS y JAXB V2.2, utilice las herramientas que se proporcionan con el servidor de aplicaciones y que se encuentran en el directorio raíz_servidor_aplicaciones\bin\.bprac
Avoid trouble Avoid trouble: Al ejecutar la herramienta schemagen para procesar JavaBeans, el generador de esquemas procesará automáticamente las anotaciones @XmlSchema de los archivos package-info.class existentes para obtener targetNamespaces. Para garantizar que la herramienta schemagen procese correctamente los valores de espacios de nombres, utilice uno de los métodos siguientes:
  • Especifique explícitamente el archivo de origen package-info.java en la invocación de schemagen; por ejemplo:
    schemagen sample.Address sample\package-info.java
  • Utilice el atributo namespace de la anotación @XmlType dentro de los JavaBeans para especificar un espacio de nombres; por ejemplo:
    @XmlType(namespace="http://myNameSpace")
    public class Address {...}
gotcha

Además de utilizar la herramienta schemagen desde la línea de mandatos, puede invocar esta herramienta JAXB desde entornos de compilación Ant. Utilice la tarea de Ant com.sun.tools.jxc.SchemaGenTask desde el entorno de compilación Ant para invocar la herramienta del generador de esquemas schemagen. Para funcionar correctamente, esta tarea Ant necesita que se invoque Ant utilizando el script ws_ant.

Sintaxis

La sintaxis de la línea de mandatos es:

[Windows]
raíz_servidor_aplicaciones\bin\schemagen.bat [opciones] <archivos_java>
[AIX][HP-UX][Linux][Solaris]
raíz_servidor_aplicaciones/bin/schemagen.sh [opciones] <archivos_java>
[IBM i]
raíz_servidor_aplicaciones/bin/schemagen [opciones] <archivos_java>

Parámetros

Los siguientes parámetros son opcionales para el mandato schemagen:

-classpath <vía_acceso>
Especifica la ubicación de los archivos de clase o de origen Java.
-cp <vía_acceso>
Especifica la ubicación de los archivos de clase o de origen Java.
-d <vía_acceso>
Especifica la ubicación en la que se coloca el procesador y los archivos de clase Java generados.
-episode<nombre_archivo>
Especifica generar un archivo de episodio para la compilación separada.
-encoding <encoding>
Especifica que se debe utilizar la codificación al invocar la herramienta -apt o -javac. Esta propiedad es aplicable para JAXB 2.2 y posterior.
-help
Muestra el menú de ayuda.
-version
Imprime la información de versión. Si especifica esta opción, sólo se incluye en la salida la información de la versión y no se produce el habitual proceso de mandatos.

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_schemagen
File name: rwbs_schemagen.html