Using the Source Code Generator

Documentation Author(s):
Keith Visco
Arnaud Blandin

API Reference: The Source Builder API

Since release 1.0.2, the Castor source generator supports the generation of Java 5.0 compliant code. The generated code -- with the new feature enabled -- will make use of the following Java 5.0-specific artifacts:

To enable this feature (off by default), please add or uncomment the following property in your custom castorbuilder.properties file:

# Specifies whether the sources generated should be source compatible with
# Java 1.4 or Java 5.  Legal values are "1.4" and "5.0".  When "5.0" is
# selected, generated source will use Java 5 features such as generics and
# annotations.
# Defaults to "1.4".
#
org.exolab.castor.builder.javaVersion=5.0
        

Castor's Source Code Generator creates a set of Java classes which represent an object model for an XML Schema (W3C XML Schema 1.0 Second Edition, Recommendation)¹, as well as the necessary Class Descriptors used by the marshaling framework to obtain information about the generated classes.

Note

The generated source files will need to be compiled. A later release may add an Ant taskdef to handle this automatically.

The XML code generator can be invoked in many ways, including by command line, via an Ant task and via Maven. Please follow the below links for detailed instructions on each invocation mode.

The input file for the source code generator is an XML Schema². The currently supported version is the W3C XML Schema 1.0, Second Edition Recommendation¹. For more information about XML Schema Support, check the XML Schema page