Network Deployment (Distributed operating systems), v8.0 > Reference > Command-line utilities
xjc command for JAXB applications
Use the Java Architecture for XML Binding (JAXB) tools to generate Java classes from an XML schema with the xjc schema compiler tool.
JAXB is an XML-to-Java binding technology that enables transformation between schema and Java objects and between XML instance documents and Java object instances. JAXB technology consists of a runtime API and accompanying tools that simplify access to XML documents. We can use JAXB APIs and tools to establish mappings between Java classes and XML schema. An XML schema defines the data elements and structure of an XML document. JAXB technology provides a runtime environment to enable you to convert your XML documents to and from Java objects. Data stored in an XML document is accessible without the need to understand the XML data structure.
We can generate fully annotated Java classes from an XML schema file by using the JAXB schema compiler, xjc command-line tool. Use the xjc schema compiler tool to start with an XML schema definition (XSD) to create a set of JavaBeans that map to the elements and types defined in the XSD schema. Once the mapping between XML schema and Java classes exists, XML instance documents can be converted to and from Java objects through the use of the JAXB binding runtime API. The resulting annotated Java classes contains all the necessary information that the JAXB runtime requires to parse the XML for marshaling and unmarshaling. We can use the resulting JAXB classes within Java API for XML Web Services (JAX-WS) applications or in your non-JAX-WS Java applications for processing XML data.
The wsimport, wsgen, schemagen and xjc command-line tools are not supported on the z/OS platform. This functionality is provided by the assembly tools provided with WAS running on the z/OS platform. Read about these command-line tools for JAX-WS applications to learn more about these tools.
WAS provides Java API for XML-Based Web Services (JAX-WS) and Java Architecture for XML Binding (JAXB) tooling. The wsimport, wsgen, schemagen and xjc command-line tools are located in...
WAS_HOME\bin\Similar tooling is provided by the Java SE Development Kit (JDK) 6. On some occasions, the artifacts generated by both the tooling provided by WAS and the JDK support the same levels of the specifications. In general, the artifacts generated by the JDK tools are portable across other compliant runtime environments. However, it is a best practice to use the tools provided with this product to achieve seamless integration within the WAS environment and to take advantage of the features that may be only supported in WAS.
To take advantage of JAX-WS and JAXB V2.2 tooling, use the tools provided with the application server that are located in the WAS_HOME\bin\ directory.
In addition to using the xjc tool from the command line, you can invoke this JAXB tool from within the Ant build environments. Use the com.sun.tools.xjc.XJCTask Ant task from within the Ant build environment to invoke the xjc schema compiler tool.
To function properly, this Ant task requires that you invoke Ant using the ws_ant script. If you are using the xjc Ant task, use the destdir parameter to specify the destination directory instead of the target option. Specifying the target option when using the xjc Ant task causes an error.
The command-line syntax is:
(Windows)
WAS_HOME\bin\xjc.bat [options] <schema_file/URL/directory_or_jar> ...[-b <binding_information>] ...(AIX)
(Solaris)
WAS_HOME/bin/xjc.sh [options] <schema_file/URL/directory_or_jar> ...[-b <binding_information>] ...
If a directory is specified, all schema files in the directory are compiled.
Parameters
The schema file/URL JAR file name or location of the directory is the only parameter that is required. The following parameters are optional for the xjc command:
Use JAXB for XML data binding
Related
schemagen command for JAXB applications
Web services specifications and APIs