Creates new instances of classes.
This class is responsible for producing RI JAXBContext objects.
Creates JAXB context.
Place holder for TODOs.
Well-known namespace URIs.
Formats error messages.
This module provides code that implements
Roughly speaking the runtime works like this:
JAXBContextImplbuilds itself by reading the model and composing unmarshallers and marshallers.
The followings are the interesting pieces inside the runtime.
The classes NOT in the
com.sun.xml.bind.v2 package (and its subpackages)
are also used by old JAXB 1.0 clients.
"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 is necessary, as the model is used:
This portion is used by all three running mode of JAXB. The corresponding base-level implementaion is also parameterized.
The runtime model contract and implementation are used only at the run-time. These packages fix the parameterization to the Java reflection, and also exposes additional functionalities to actually do the unmarshalling/marshalling. These classes have "Runtime" prefix.
Finally XJC has its own implementation of the contract in its own package. This package also fixes the parameterization to its own reflection library.
When you work on the code, it is often helpful to know the layer you are in.
The binding model design roughly looks like the following. For more details, see the javadoc of each component.
Model construction happens inside
It's desirable for this step to be fast and consume less memory,
but it's not too performance sensitive.
Code that implements the unmarshaller and the marshaller OTOH needs to be very carefully written to achieve maximum sustaining performance.
The following picture illustrates how the
Copyright © 2021 JBoss by Red Hat. All rights reserved.