Runtime API for the JAX-WS RI

The JAXB 2.0 runtime

Overview

This module provides code that implements JAXBContext . Roughly speaking the runtime works like this:

1. There's a set of classes and interfaces that model JAXB-bound types. You can think of this as a reflection library for JAXB.
2. There's a set of classes that constitute the unmarshaller and marshaller. Each class represents a small portion, and they are composed to perform the operations.
3. JAXBContextImpl builds itself by reading the model and composing unmarshallers and marshallers.

Interesting Pieces inside Runtime

The followings are the interesting pieces inside the runtime.

com.sun.xml.bind.v2.model model

This set of classes and interfaces models JAXB-bound types.

com.sun.xml.bind.v2.runtime XML I/O

This set of classes implements the JAXB API and provides the XML I/O functionality.

The classes NOT in the com.sun.xml.bind.v2 package (and its subpackages) are also used by old JAXB 1.0 clients.

Models

"Model" is the portion of the code that represents JAXB-bound types.

The following picture illustrates the relationship among major packages of the binding model.

The core model contracts are all interfaces, and they are parameterized so that they can be used with different reflection libraries.

This package offers stronger types and additional methods available at the runtime to access objects according to the model.

How it works

Most of the classes in this package are "templates." At run-time, A template class file is slightly modified to match the target Java Bean, then it will be loaded into the VM.

TXW runtime.

Defines a set of annotations that can be used on TypedXmlWriter interfaces.

Package-level Annotation

{@link XmlNamespace} can be used on a package to designate the namespace URI for the whole package.

Interface Annotation

{@link XmlElement} can be used on TypedXmlWriter-derived interfaces to associate a tag name to that interface.

Method Annotations

{@link XmlElement}, {@link XmlAttribute}, or {@link XmlValue} can be used on a method declared on a TypedXmLWriter-derived interface. Those annotations are mutually-exclusive. See their javadoc for details. If none of the above three annotations are specified, {@link XmlElement} is assumed.

Defines XmlSerializer and its built-in implementations.