JAXBContext API
JAXBContext 提供了四种静态方法,方便使用者直接调用。为什么是四种而不是四个呢?因为它们有很多重载的方法,名称都是相同的,参数不同而已。
newInstance()
应用程序可以通过多种途径获得
JAXBContext
实例,它们拥有相同的函数名,只是参数不同。
创建 JAXB 实例,最常见的方式是传入特定的class.
JAXBContext instance = JAXBContext.newInstance(Student.class);
使用类名 Xxx.class
如果存在同名的Java对象,则可以指定完整路径:
JAXBContext instance = JAXBContext.newInstance(com.example.bean.Student.class);
使用包路径加上类名 com.x.xx.Xxx.class
如果有多个对象需要注册,则可以:
JAXBContext instance = JAXBContext.newInstance(Student.class, Teacher.class);
多个类之间使用逗号分隔开
或者也可以对某一个package
包下所有的对象编组:
JAXBContext instance = JAXBContext.newInstance("com.example.bean");
传入完整包名。这时候并不是指定的包中所有的Class都会用来创建JAXBContext。按照JAXB的规范,我们需要在对应的包中创建一个jaxb.index文件,然后在其中指定创建JAXBContext时需要用到的Class,每个Class名称占一行。否则,会报错
"com.example.bean" 不包含 ObjectFactory.class 或 jaxb.index
甚至对多个package
包下所有的对象编组:
JAXBContext instance = JAXBContext.newInstance("com.example.bean:com.example.pojo");
完整包名之间使用冒号分隔开
createMarshaller()
创建一个Marshaller
对象,用于将Java内容转换为XML数据。
对使用工厂方法手动创建的内容进行编组与unmarshal
操作结果的内容进行编组没有本质区别。客户端可以将Java内容编组成java.io.OutputStream
或者java.io.Writer
的XML数据。编组程序可以生成已经注册号的SAX2事件流,也可以生成一个DOM节点对象。
createUnmarshaller()
创建一个可以用来将 XML 数据转换为 java 内容树的 Unmarshaller
对象。
该方法允许将模式中声明的任何全局 XML 元素解组为实例文档的根元素。
createBinder()
创建一个可用于关联/原地解组/编组操作的 Binder 对象。如果不传参数,默认使用W3C DOM创建一个Binder。