Package com.sun.tools.xjc.api

API for programmatic invocation of XJC and schemagen.

See: Description

Interface Summary

Interface	Description
ClassNameAllocator	Callback interface that allows the driver of the XJC API to rename JAXB-generated classes/interfaces/enums.
ErrorListener	Implemented by the driver of the compiler engine to handle errors found during the compiliation.
J2SJAXBModel	JAXBModel that exposes additional information available only for the java -> schema direction.
JavaCompiler	Java-to-Schema compiler.
JAXBModel	The in-memory representation of the JAXB binding.
Mapping	JAXB-induced mapping between a Java class and an XML element declaration.
Property	Represents a property of a wrapper-style element.
S2JJAXBModel	JAXBModel that exposes additional information available only for the schema -> java direction.
SchemaCompiler	Schema-to-Java compiler.
TypeAndAnnotation	Java type and associated JAXB annotations.

Class Summary

Class	Description
Reference	Reference to a JAXB type (from JAX-RPC.)
XJC	Entry point to the programatic API to access schema compiler (XJC) and schema generator (schemagen).

Enum Summary

Enum	Description
SpecVersion	Represents the spec version constant.

Package com.sun.tools.xjc.api Description

API for programmatic invocation of XJC and schemagen.

This package provides a way to invoke XJC from within another program. The primary target of this API is the JAX-WS RI, but we hope that this API would be useful for other integration purposes as well.

Getting Started: Using XJC

To invoke XJC, a typical client would do something like this:

    SchemaCompiler sc = XJC.createSchemaCompiler();
    sc.parseSchema(new InputSource(schema1Url.toExternalForm()));
    sc.parseSchema(new InputSource(schema2Url.toExternalForm()));
    ...
    S2JModel model = sc.bind();
 

The bind operation causes XJC to do the bulk of the work, such as figuring out what classes to generate, what methods/fields to generate, etc. The obtained model contains useful introspective information about how the binding was performed (such as the mapping between XML types and generated Java classes)

Once the model is obtained, generate the code into the file system as follows:

   JCodeModel cm = model.generateCode( null, ... );
   cm.build(new FileCodeWriter(outputDir));
 

Implementation Note

This package shouldn't contain any implementation code.