JAXB 深入显出 - JAXB 教程 解读 JAXBContext

x33g5p2x  于2021-12-28 转载在 其他  
字(1.9k)|赞(0)|评价(0)|浏览(257)

摘要: JAXB 作为JDK的一部分,能便捷地将Java对象与XML进行相互转换,本教程从实际案例出发来讲解JAXB 2 的那些事儿。完整版目录

课前导读

JAXBContext 是整个 JAXB API 的入口。主要用来构建 JAXB 实例(newInstance()),并提供与XML/Java绑定信息相关的抽象,如编组(createMarshaller())、解组(createUnmarshaller())和验证(createValidator())。其中与验证相关的方法已废弃(Deprecated),被Validator所替代。

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。

静态方法提供者 JAXB

javax.xml.bind.JAXB是2.1版本新增的工具类,其中所有的 public 方法均为静态方法,可以直接通过类名调用。它存在的意义就是帮助使用者简单,快速上手JAXB。

JAXBContext

被缓存的JAXBContext,为了性能上的考虑,将会对JAXBContext做缓存,不过缓存使用到了WeakReference,不用担心 GC 问题。

JAXB.unmarshal(…)

有很多重载的方法,方便使用者传入不同类型的参数。使用者不需要关心实现的细节,传入你需要转换的数据,加上需要生成的类,就能得到需要的数据。

public static <T> T unmarshal( ..., Class<T> type ) {}
返回值使用的是泛型T,可以得到任意对象

JAXB.marshal(…)

同样有很多重载的方法,方便使用者传入不同类型的参数。

public static void marshal( Object jaxbObject, ... ) {}
第一个参数是对象Obj,可以传入任意对象

相关文章