JAXBContext 类提供客户端的JAXB API入口点。 它为管理实现JAXB绑定框架操作所必需的XML / Java绑定信息提供了一个抽象：unmarshal，marshal和validate。

客户端应用程序通常使用newInstance方法的这两种样式之一获取此类的新实例，尽管还有其他专门的方法可用：

规范要求： 提供者必须提供一个包含以下方法签名的实现类：

  public static JAXBContext createContext( String contextPath, ClassLoader classLoader, Map<String,Object> properties ) throws JAXBException
 public static JAXBContext createContext( Class[] classes, Map<String,Object> properties ) throws JAXBException 

以下JAXB 1.0要求仅适用于模式到java接口/实现绑定。 它不适用于JAXB注释类。 JAXB提供商必须在每个包含模式派生类的包中生成一个 jaxb.properties 文件。 属性文件必须包含一个名为 javax.xml.bind.context.factory 的属性，其值是实现 createContext API的类的名称。

提供者提供的类不需要分配给 javax.xml.bind.JAXBContext ，它只需要提供一个实现 createContext API的类。

此外，提供者必须在任何客户端调用元组和解组件方法之前调用 DatatypeConverter.setDatatypeConverter api。 这是配置在这些操作期间将使用的数据类型转换器所必需的。

Unmarshaller 类为客户端应用程序提供将XML数据转换为Java内容对象树的能力。 unmarshal方法允许在模式中声明的任何全局XML元素作为实例文档的根解组。 此外，unmarshal方法允许一个无法识别的根元素，该元素的xsi：type属性的值引用在模式中声明的类型定义作为实例文档的根而被解组。 JAXBContext 对象允许在一组模式（ contextPath 中列出）中合并全局元素和类型定义。 由于模式集中的每个模式都可以属于不同的命名空间，所以将模式统一到解组上下文应该与命名空间无关。 这意味着客户端应用程序能够解组是任何在 contextPath 列出的模式实例的XML文档。 例如：

  JAXBContext jc = JAXBContext.newInstance( "com.acme.foo:com.acme.bar" );
        Unmarshaller u = jc.createUnmarshaller();
        FooObject fooObj = (FooObject)u.unmarshal( new File( "foo.xml" ) ); // ok
        BarObject barObj = (BarObject)u.unmarshal( new File( "bar.xml" ) ); // ok
        BazObject bazObj = (BazObject)u.unmarshal( new File( "baz.xml" ) ); // error, "com.acme.baz" not in contextPath 

客户端应用程序也可以显式生成Java内容树，而不是解组现有的XML数据。 对于所有JAXB注释的值类，应用程序可以使用构造函数创建内容。 对于模式导出的接口/实现类以及创建未绑定到JAXB注释类的元素，应用程序需要具有对每个包含的java包中存在的每个模式派生的 ObjectFactory 类的访问和知识 contextPath 。 对于每个模式派生的java类，都有一个静态工厂方法来生成该类型的对象。 例如，假设在编译模式之后，您有一个包含 PurchaseOrder 的模式导出接口的包 com.acme.foo 。 为了创建该类型的对象，客户端应用程序将使用如下所示的工厂方法：

  com.acme.foo.PurchaseOrder po =
           com.acme.foo.ObjectFactory.createPurchaseOrder(); 

一旦客户端应用程序具有模式派生对象的实例，它可以使用mutator方法来设置内容。

有关生成的 ObjectFactory 类的更多信息，请参见 规范的 第4.2节 Java包 。

规范要求： 提供程序必须在每个包中生成一个类，其中包含名为ObjectFactory的包的所有必需对象工厂方法以及静态 newInstance( javaContentInterface ) 方法

Marshaller 类为客户端应用程序提供将Java内容树转换回XML数据的能力。 编组使用工厂方法手动创建的内容树和编组作为 unmarshal 操作的结果的内容树之间没有区别。 客户端可以将Java内容树编组回到XML数据到 java.io.OutputStream 或 java.io.Writer 。 编组过程可以替代地将SAX2事件流生成到注册的 ContentHandler 或生成DOM节点对象。 客户端应用程序可以控制输出编码以及是否将XML数据编组为完整的文档或片段。

这是一个简单的示例，它解组XML文档，然后将其重新编排出来：

  JAXBContext jc = JAXBContext.newInstance( "com.acme.foo" );
        // unmarshal from foo.xml
        Unmarshaller u = jc.createUnmarshaller();
        FooObject fooObj = (FooObject)u.unmarshal( new File( "foo.xml" ) );
        // marshal to System.out
        Marshaller m = jc.createMarshaller();
        m.marshal( fooObj, System.out ); 

自JAXB 1.0以来，验证已经发生了重大变化。 Validator 类已被弃用，可选。 这意味着建议您不要使用此类，实际上，根据您的JAXB提供程序，它可能甚至不可用。 使用JAXB 1.0运行时系统部署时，依赖于 Validator的 JAXB 1.0客户端应用程序仍将正常工作。 在JAXB 2.0中， Unmarshaller 包含了方便的方法来暴露JAXP 1.3 javax.xml.validation 框架。 有关详细信息，请参阅 Unmarshaller.setSchema(javax.xml.validation.Schema) API。

JAXB运行时绑定框架兼容性

以下JAXB 1.0限制仅适用于绑定到接口/实现类的模式。 由于此绑定不需要常见的运行时系统，JAXB客户端应用程序不得尝试从不同的提供程序混合运行时对象（ JAXBContext, Marshaller 等）。 这并不意味着客户端应用程序不可移植，它只是意味着客户端必须使用由用于编译模式的同一提供程序提供的运行时系统。

发现JAXB实现

当调用其中一个 newInstance 方法时，将通过以下步骤发现JAXB实现。

一旦发现提供者工厂类，将调用其 public static JAXBContext createContext(String,ClassLoader,Map) 方法（参见 参数语义 参见 newInstance(String, ClassLoader, Map) ）或 public static JAXBContext createContet(Class[],Map) 方法（参见 newInstance(Class[], Map) 参见参数语义），以创建 JAXBContext 。

public static JAXBContext newInstance(String contextPath)
                               throws JAXBException

public static JAXBContext newInstance(String contextPath,
                                      ClassLoader classLoader)
                               throws JAXBException

jaxb.index的格式

该文件包含一个换行的类名列表。 空格和制表符字符以及空白行将被忽略。 注释字符为'＃'（0x23）; 在每行上，忽略第一个注释字符之后的所有字符。 文件必须以UTF-8编码。 类，可达，如在定义 newInstance(Class...) ，从列出的类也与JAXBContext中注册。

在 jaxb.index 文件中出现的类名的 限制 是：

为了保持与JAXB 1.0模式到Java接口/实现绑定的兼容性，通过模式定制 <jaxb:globalBindings valueClass="false"> 启用，JAXB提供程序将确保上下文路径上的每个包都有一个 jaxb.properties 文件，其中包含 javax.xml.bind.context.factory 属性的值，并且所有值都解析为同一供应商。 此要求不适用于JAXB注释类。

如果在contextPath上列出的各种软件包之间存在任何全局XML元素名称 冲突 ， 那么 将抛出一个 JAXBException 。

在同一上下文路径中混合来自多个JAXB提供程序的生成的接口/ impl绑定可能会导致抛出 JAXBException 。

发现JAXB实现涉及的步骤在类javadoc中讨论。

public static JAXBContext newInstance(String contextPath,
                                      ClassLoader classLoader,
                                      Map<String,?> properties)
                               throws JAXBException

public static JAXBContext newInstance(类... classesToBeBound)
                               throws JAXBException

  class Foo {
      @XmlTransient FooBar c;
      Bar b;
 class Bar { int x; }
 class Zot extends Bar { int y; }
 class FooBar { } 

public static JAXBContext newInstance(类[] classesToBeBound,
                                      Map<String,?> properties)
                               throws JAXBException

public abstract Unmarshaller createUnmarshaller()
                                         throws JAXBException

public void generateSchema(SchemaOutputResolver outputResolver)
                    throws IOException