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: 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: 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: 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 {...}
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]](../images/windows.gif)
raíz_servidor_aplicaciones\bin\schemagen.bat [opciones] <archivos_java>
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
raíz_servidor_aplicaciones/bin/schemagen.sh [opciones] <archivos_java>
![[IBM i]](../images/iseries.gif)
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.
Reference topic