解读JAXBContext类

解读JAXBContext类
JAXBContext是整个JAXB API的入口.主要用来构建JAXB实例(newInstance()),并提供与XML/Java绑定信息相关的抽象方法,如编组(createMarshaller())、解组(createUnmarshaller())和验证(createValidator()).其中与验证相关的方法已废弃(Deprecated),被Validator所替代.
1. newInstance(): 应用程序可以通过多种途径获得JAXBContext实例,它们拥有相同的函数名,只是参数不同.
(1) 创建JAXB实例,最常见的方式是传入特定的class

JAXBContext context = JAXBContext.newInstance(User.class);

(2) 如果存在同名的Java对象,则可以指定完整路径：

JAXBContext context = JAXBContext.newInstance(com.liantuo.contrast.util.jaxb.User.class);

(3) 多个对象需要注册：

1）使用下面方法进行对象构造：

JAXBContext context = JAXBContext.newInstance(User.class,Person.class);

2）对某一个package包下所有的对象编组：

JAXBContext context = JAXBContext.newInstance("com.liantuo.contrast.util.jaxb");

注意需要在指定的目录下添加jaxb.index文件 和 ObjectFactory.java类
jaxb.index 文件如下：

User
Person

ObjectFactory.java类如下：

package com.liantuo.contrast.util.jaxb;
import javax.xml.bind.annotation.XmlRegistry;

@XmlRegistry
public class ObjectFactory {

    public ObjectFactory() {

    }

    public User createUser() {
        return new User();
    }

    public Person createPerson(){
        return new Person();
    }
    
}

测试：

package com.liantuo.contrast.util.jaxb;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;
import java.io.StringReader;

public class demo {
    public static void main(String[] args) throws ClassNotFoundException {
        User user = new User();
        user.setId(1);
        user.setName("lili");
        user.setAge(18);
        JaxbUtil jaxbUtil = new JaxbUtil();
        String xml = jaxbUtil.javaToXml(user);
        System.out.println("User对象转XML的结果：" + xml);

        Person p  = new Person();
        p.setId(2);
        p.setName("lucy");
        p.setAge(19);
        String x = jaxbUtil.javaToXml(p);
        System.out.println("Person对象转XML的结果：" + x);

        try {
            JAXBContext context = JAXBContext.newInstance("com.liantuo.contrast.util.jaxb");
            Unmarshaller unmarshaller = context.createUnmarshaller();
            Object un = unmarshaller.unmarshal(new StringReader(xml));
            System.out.println(un);
            Object un1 = unmarshaller.unmarshal(new StringReader(x));
            System.out.println(un1);
        } catch (JAXBException e) {
            e.printStackTrace();
        }

    }
}

执行结果：

传入完整包名.这时候并不是指定的包中所有的Class都会用来创建JAXBContext.按照JAXB的规范,我们需要在对应的包中创建一个jaxb.index文件,然后在其中指定创建JAXBContext时需要用到的Class,每个Class名称占一行.否则,会报错:"[javax.xml.bind.JAXBException: "com.liantuo.contrast.util.jaxb" 不包含 ObjectFactory.class 或 jaxb.index]" (如下图)

详细参数参考：http://blog.bdoughan.com/2012/07/jaxb-and-root-elements.html

3）对多个package包下所有的对象编组：

JAXBContext instance = JAXBContext.newInstance("com.example.bean:com.example.pojo");

注意：完整包名之间使用冒号分隔开

2. createMarshaller()创建一个Marshaller对象,用于将Java内容转换为XML数据.
对使用工厂方法手动创建的内容进行编组与unmarshal操作结果的内容进行编组没有本质区别.客户端可以将Java内容编组成java.io.OutputStream或者java.io.Writer的XML数据.编组程序可以生成已经注册号的SAX2事件流,也可以生成一个DOM节点对象.
3. createUnmarshaller()创建一个可以用来将XML数据转换为java内容树的Unmarshaller对象.
该方法允许将模式中声明的任何全局XML元素解组为实例文档的根元素.
4. createBinder()创建一个可用于关联/原地解组/编组操作的Binder对象.如果不传参数,默认使用W3C DOM创建一个Binder.
5. JAXBContext 为了性能上的考虑,将会对JAXBContext做缓存,不过缓存使用到了WeakReference,不用担心GC问题. 
后续会对JAXBContext做缓存进行介绍