JAXB应用实例

JAXB应用实例

过往的项目中数据存储都离不开数据库，不过最近作的一个项目的某些数据（好比人员信息、菜单、权限等等）却彻底没有涉及任何数据库操做，直接XML搞定。这里无心比较优劣，由于数据库存储和XML存储本就有不一样的适用场景，盲目比较毫无心义，只是由于业务须要，仅此而已。先来概念一下——XML，可扩展标记语言，设计宗旨是用来传输数据而非显示数据，其遵循W3C标准，是一种通用的数据交换格式,具备很强的跨平台性，而且数据无需转换，因此，若是你要将数据作跨平台传输，那么把数据保存在 XML 文件中是有好处的。固然，这里要说明，因为XML仅仅是做为一种文档模式的结构化存储，因此并不适用于大数据量的存储。如今的Java中有不少类库好比DOM、SAX、JDOM和DOM4J等等均可以操做XML，但若是仅仅是想作JavaBean和XML节点元素的互相转换，而不涉及动态XML的处理，那么JAXB绝对是一个不错的选择。在比较新的jdk版本中，JAXB都是jdk的扩展包javax中自带的类库，不须要你引入第三方jar包。

1、JavaBean和XML相互转换初体验

2、JAXB使用基础介绍

1. 经常使用API

JAXBContext类，是应用的入口，经过该类建立序列化和反序列化对象，也即编组对象和解组对象； Marshaller 编组接口，将Java对象序列化为XML数据； Unmarshaller 解组接口，将XML数据反序列化为Java对象。

2. 经常使用注解

@XmlRootElement，将Java类或枚举映射成XML元素根节点，是惟一一个必须注解，name属性指定根节点名称，不指定默认为类名的小写；

@XmlElement，将Java类的一个属性映射为XML节点元素，name属性可自定义元素名；

@XmlAttribute，将Java类的一个属性映射为XML节点元素的属性，name属性可自定义属性名；

@XmlType，将Java类或枚举类型映射到XML模式类型，常与@XmlRootElement、@XmlAccessorType共用，propOrder属性定义字段生成的XML节点顺序；

@XmlAccessorType，控制字段或属性的序列化。属性XmlAccessType有4个常量值:FIELD表示JAXB将自动绑定Java类中的每一个非静态的（static）、非瞬态的（由@XmlTransient标注）字段到XML；PROPERTY表示java对象中全部经过getter/setter方式绑定成属性到XML；PUBLIC_MEMBER表示Java对象中全部的public访问权限的成员变量和经过getter/setter方式访问的成员变量，该值为默认值；NONE表示Java对象的全部属性都不映射为XML的元素；

@XmlAccessorOrder，控制JAXB 绑定类中属性和字段的排序，有两个属性，AccessorOrder.ALPHABETICAL——对生成的XML元素按字母书序排序，XmlAccessOrder.UNDEFINED——不排序，默认为该值；

@XmlJavaTypeAdapter，自定义适配器（即扩展抽象类XmlAdapter并覆盖marshal()和unmarshal()方法），解决日期（Date）,数字（Number）格式化问题；

@XmlElementWrapper ，对于数组或集合（即包含多个元素的成员变量），生成一个包装该数组或集合的XML元素（称为包装器），该注解只能用在集合上；

@XmlTransient ，用于标示在由Java对象映射XML时，忽略此属性，在生成的XML文件中将不出现此元素。

3. 实际应用中注意的问题

① 若是JavaBean中定义了有参的构造器，那么必须同时定义无参构造器，不然转XML会抛无默认构造函数的异常;

② 成员变量值为NULL时，将不会映射成对应的XML元素——因为基本数据类型默认值不为空，因此基本数据类型不设值也会映射成XML元素，值为默认值,因此若是模型须要基本数据，在属性定义的时候尽可能使用包装类型；

③ @XmlAccessorType 注解中若是属性值为XmlAccessType.FIELD，则表示经过成员变量来映射，set/get方法上的映射注解就是多余的，因此若是此时set/get方法上再标注元素或者属性映射注解，将抛属性重复性异常；属性值为XmlAccessType.NONE不映射为XML元素的前提是Java字段或set/get方法上都没有映射注解；

④ @XmlType propOrder属性可以自定义字段的排序，该属性若是设置，要么写成{}的形式，不然在就必须将全部@XmlElement标注或者没有@XmlElement标注的但实际上会被映射为XML节点的字段添加到排序列表，否则会抛异常；若是propOrder属性设置有值，@XmlAccessorOrder注解的元素排序规则将失效；