文章21 | 阅读 8236 | 点赞0
摘要: JAXB 作为JDK的一部分,能便捷地将Java对象与XML进行相互转换,本教程从实际案例出发来讲解JAXB 2 的那些事儿。完整版目录
JAXBContext
是整个 JAXB API 的入口。主要用来构建 JAXB 实例(newInstance()
),并提供与XML/Java绑定信息相关的抽象,如编组(createMarshaller())、解组(createUnmarshaller()
)和验证(createValidator()
)。其中与验证相关的方法已废弃(Deprecated),被Validator
所替代。
应用程序可以通过多种途径获得 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");
完整包名之间使用冒号分隔开
创建一个Marshaller
对象,用于将Java内容转换为XML数据。
对使用工厂方法手动创建的内容进行编组与unmarshal
操作结果的内容进行编组没有本质区别。客户端可以将Java内容编组成java.io.OutputStream
或者java.io.Writer
的XML数据。编组程序可以生成已经注册号的SAX2事件流,也可以生成一个DOM节点对象。
创建一个可以用来将 XML 数据转换为 java 内容树的 Unmarshaller
对象。
该方法允许将模式中声明的任何全局 XML 元素解组为实例文档的根元素。
创建一个可用于关联/原地解组/编组操作的 Binder 对象。如果不传参数,默认使用W3C DOM创建一个Binder。
javax.xml.bind.JAXB
是2.1版本新增的工具类,其中所有的 public 方法均为静态方法,可以直接通过类名调用。它存在的意义就是帮助使用者简单,快速上手JAXB。
被缓存的JAXBContext
,为了性能上的考虑,将会对JAXBContext
做缓存,不过缓存使用到了WeakReference
,不用担心 GC 问题。
有很多重载的方法,方便使用者传入不同类型的参数。使用者不需要关心实现的细节,传入你需要转换的数据,加上需要生成的类,就能得到需要的数据。
public static <T> T unmarshal( ..., Class<T> type ) {}
返回值使用的是泛型T,可以得到任意对象
同样有很多重载的方法,方便使用者传入不同类型的参数。
public static void marshal( Object jaxbObject, ... ) {}
第一个参数是对象Obj,可以传入任意对象
版权说明 : 本文为转载文章, 版权归原作者所有 版权申明
原文链接 : https://jiangchao.blog.csdn.net/article/details/82355672
内容来源于网络,如有侵权,请联系作者删除!