JAXB的应用:JavaBean和XML相互转换

在过去的项目中存储数据与数据库是分不开的，但一些新创建的数据（如个人信息，菜单，权限等）不涉及任何数据库操作。这里无意比较优缺点，因为数据库存储和XML存储有不同的场景，一味的没有意义，只是因为业务的需要，没有什么更多的。来第一个概念 – XML，可扩展标记语言，设计用来传输数据，而不是显示的数据，按照W3C标准的公共数据交换格式，具有强大的平台和数据无需转换，所以如果你想跨平台的数据传输，那么存储在XML文件中的数据是不错的。当然这里要解释一下，因为XML只是作为一个文档存储模型来构建的，所以不适用于大量的数据存储。有迹象表明，可以处理XML的DOM，SAX和JDOM DOM4J不过，如果你只想节点JavaBean组件和XML转换不涉及动态XML处理许多Java库，然后JAXB绝对是一个不错的选择。在jdk的最新版本中，JAXB是jdk包的扩展，javax自带了一个类库，不需要引入第三方的jar包。

二 JAXB使用基础介绍

　　① 常用API

• JAXBContext类，是应用的入口，通过该类创建序列化和反序列化对象，也即编组对象和解组对象；

• Marshaller 编组接口，将Java对象序列化为XML数据；

• Unmarshaller 解组接口，将XML数据反序列化为Java对象。

　　② 常用注解

• @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文件中将不出现此元素。

　　③ 实际应用中注意的问题

　　① 如果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注解的元素排序规则将失效；

三 应用实际

先准备好测试用的工具方法：

　① 简单对象处理

简单对象处理起来比较简单，譬如人员对象User中包含菜单Menu,只需将定义的普通Menu对象也按照JAXB的注解进行标注，在User对象中当成普通字段一样的定义即可——

　　② 集合处理

实际应用场景中集合应用要更常见一些，比如上面的用户菜单，一个用户肯定会有多个不同的菜单，所以，我们来将上面的菜单改用集合处理——

View Code

View Code

View Code

上面的菜单中似乎少了点层次关系，这个时候可以使用集合包装器注解@XmlElementWrapper自定义一个包装节点，这样产生的XML文档才更有层次：

最终产生的XML文档就是这样的：

　　③ 格式化处理

　　业务数据中日期、数值通常是必不可少的，在数据存储的时候，这些数据通常都需要做格式化处理，比如将日期格式化，货币型数值处理等等。JAXB中格式化处理需要继承适配器抽象类XmlAdapter，并覆写其序列化和反序列化的方法，这里仅用常用的日期格式化为例：

将该适配器通过注解应用到User类表时间的date字段上：

　　最后的时间就是按照格式化输出——

四 问题补充

　　上述博文中描述的工具方法仅仅是出于学习中追根问本的目的写得稍微冗余了些，实际上，我所知道的是最迟从jdk1.7开始，JAXB就对解组和编组的方法进行了更简单的封装，所以，实际项目中除非自己要进行个性化设置，否则大可不用自己再创建JAXBContext实例，直接通过JAXB静态调用相应的工具方法就行了，有兴趣的看官稍微跟踪一下源码就能了然，于是上面的工具方法可以写得更简单——