JAXB(Java Architecture for XML Binding) 是一个业界的标准，是一项可以根据XML Schema产生Java类的技术。该过程中，JAXB也提供了将XML实例文档反向生成Java对象树的方法，并能将Java对象树的内容重新写到XML实例文档。从另一方面来讲，JAXB提供了快速而简便的方法将XML模式绑定到Java表示，从而使得Java开发者在Java应用程序中能方便地结合XML数据和处理函数。

一、先看个简单的例子

实体类：UserInfo.java

packagecom.demo.bean;importjavax.xml.bind.annotation.XmlElement;importjavax.xml.bind.annotation.XmlElementWrapper;importjavax.xml.bind.annotation.XmlRootElement;importjava.util.Arrays;

@XmlRootElementpublic classUserInfo {private intid;privateString name;privateString gender;privateString addr;privateString[] hobbys;publicUserInfo() {

}public UserInfo(intid, String name, String gender, String addr, String[] hobbys) {this.id =id;this.name =name;this.gender =gender;this.addr =addr;this.hobbys =hobbys;

}

@XmlElementpublic intgetId() {returnid;

}public void setId(intid) {this.id =id;

}

@XmlElementpublicString getName() {returnname;

}public voidsetName(String name) {this.name =name;

}

@XmlElementpublicString getGender() {returngender;

}public voidsetGender(String gender) {this.gender =gender;

}

@XmlElementpublicString getAddr() {returnaddr;

}public voidsetAddr(String addr) {this.addr =addr;

}//使用@XmlElementWrapper注解后，将会在原xml结点上再包装一层xml//@XmlElementWrapper仅允许出现在集合属性上

@XmlElementWrapper(name="allhobbys")

@XmlElement(name="hobby")publicString[] getHobbys() {returnhobbys;

}public voidsetHobbys(String[] hobbys) {this.hobbys =hobbys;

}

@OverridepublicString toString() {return "UserInfo{" +

"id=" + id +

", name='" + name + '\'' +

", gender='" + gender + '\'' +

", addr='" + addr + '\'' +

", hobbys=" + Arrays.toString(hobbys) +

'}';

}

}

实战互转方法

importcom.demo.bean.UserInfo;importorg.junit.Test;importjavax.xml.bind.JAXBContext;importjavax.xml.bind.JAXBException;importjavax.xml.bind.Marshaller;importjavax.xml.bind.Unmarshaller;importjava.io.File;importjava.io.StringReader;importjava.io.StringWriter;public classTest01 {

@Testpublic voidtest(){

UserInfo user= new UserInfo(1,"张三","男","杭州",new String[]{"篮球","音乐"});

String xmlStr=objToXML(user);

System.out.println(xmlStr);

System.out.println("---------------------------------------------------------------");

UserInfo getUser= (UserInfo)xmlStrToObj(xmlStr,UserInfo.class);

System.out.println(getUser);

System.out.println("---------------------------------------------------------------");//编组输出到文件中

objToXmlFile(user,"E:\\user.xml");

UserInfo getUser1= (UserInfo)xmlFileToObj("E:\\user.xml",UserInfo.class);

System.out.println(getUser1);

}publicString objToXML(Object obj){try{//根据obj类生成上下文对象

JAXBContext context =JAXBContext.newInstance(obj.getClass());//从上下文中获取Marshaller对象，用作将bean编组(转换)为xml

Marshaller marshaller =context.createMarshaller();//设置编码格式(默认编码就是utf-8)

marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");//GB2312//以下是为生成xml做的一些配置//是否格式化生成的xml，即按标签自动换行，否则就是一行输出

marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.FALSE);//是否省略xml头部信息,默认不省略(false)

marshaller.setProperty(Marshaller.JAXB_FRAGMENT, Boolean.TRUE);

StringWriter stringWriter= newStringWriter();

marshaller.marshal(obj, stringWriter);

StringBuilder stringBuilders= newStringBuilder();returnstringBuilders.append(stringWriter).toString();

}catch(JAXBException e) {

e.printStackTrace();

}return null;

}public voidobjToXmlFile(Object obj,String fileUrl){try{

File file= newFile(fileUrl);//根据obj类生成上下文对象

JAXBContext context =JAXBContext.newInstance(obj.getClass());//从上下文中获取Marshaller对象，用作将bean编组(转换)为xml

Marshaller marshaller =context.createMarshaller();//设置编码格式(默认编码就是utf-8)

marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");//GB2312//以下是为生成xml做的一些配置//是否格式化生成的xml，即按标签自动换行，否则就是一行输出

marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.TRUE);//是否省略xml头部信息,默认不省略(false)

marshaller.setProperty(Marshaller.JAXB_FRAGMENT, Boolean.TRUE);

marshaller.marshal(obj,file);

}catch(JAXBException e) {

e.printStackTrace();

}

}publicObject xmlStrToObj(String xmlStr,Class objClass){try{

JAXBContext jc=JAXBContext.newInstance(objClass);

Unmarshaller unmar=jc.createUnmarshaller();

Object obj= unmar.unmarshal(newStringReader(xmlStr));returnobj;

}catch(JAXBException e) {

e.printStackTrace();

}return null;

}publicObject xmlFileToObj(String xmlFileUrl,Class objClass){try{

File file= newFile(xmlFileUrl);

JAXBContext jc=JAXBContext.newInstance(objClass);

Unmarshaller unmar=jc.createUnmarshaller();

Object obj=unmar.unmarshal(file);returnobj;

}catch(JAXBException e) {

e.printStackTrace();

}return null;

}

}

输出结果：

生成的user.xml文件

二、常用注解解析

1、@XmlRootElement

作用和用法：

类级别的注解，将类映射为xml全局元素，也就是根元素。就像spring配置文件中的beans。上面的例子中我将该注解用在了UserInfo类上，生成了根元素。常与@XmlType，@XmlAccessorType，@XmlAccessorOrder连用。

属性：

该注解含有name和namespace两个属性。namespace属性用于指定生成的元素所属的命名空间。name属性用于指定生成元素的名字，若不指定则默认使用类名小写作为元素名。修改上面的例子，在该注解上使用name属性：

2、@XmlElement

作用和用法：

字段，方法，参数级别的注解。该注解可以将被注解的字段(非静态)，或者被注解的get/set方法对应的字段映射为本地元素，也就是子元素。默认使用字段名或get/set方法去掉前缀剩下部分小写作为元素名(在字段名和get/set方法符合命名规范的情况下)。上面例子中，id、addr、name、gender、hobby 都被映射成了元素的子元素。下文会配合@XmlAccessorType注解详细讲解该注解的用法。常与@XmlValue，@XmlJavaTypeAdapter，@XmlElementWrapper连用。

属性：

该注解的属性常用的属性有有：name、nillable、required、namespace、defaultValue

name属性可以指定生成元素的名字，同@XmlRootElement注解的name属性一样，不再举例。

nillable属性可以指定元素的文本值是否可以为空，默认为false。

required属性可以指定该元素是否必须出现，默认为false。

namespace属性可以指定该元素所属的命名空间。

defaultValue属性可以指定该元素默认的文本值。

3、@XmlAttribute

作用和用法：

字段和方法级别的注解。该注解会将字段或get/set方法对应的字段映射成本类对应元素的属性，属性名默认使用字段名或get/set方法去掉前缀剩下部分首字母小写(在字段名和get/set方法符合命名规范的情况下)。修改上面例子：

属性:

该注解有name，required，namespace三个属性。用法和@XmlElement注解相同。

4、@XmlTransient

作用和用法：

类，字段，方法级别的注解。可使JAXB在映射xml元素时忽略被注解的类，字段，get/set对应字段。需要注意的是该注解与所有其他JAXB注释相互排斥，也就是说与其他注释连用就会报错。修改上面例子：

属性：

该注解没有属性。

5、@XmlJavaTypeAdapter

作用和用法：

包、类、字段，方法、参数级别的注解。解决java日期(Date)，数字(Number)格式化问题。直接看例子，修改UserInfo类，添加一个Date类型字段：

自定义一个适配器来解决这个问题。该注解的用法就是自定义适配器并继承XmlAdapter类，实现里面的marshal和unmarshal方法，并在该注解上引用。修改例子：

自定义的DateAdapter：

public class DateAdapter extends XmlAdapter{private static final SimpleDateFormat SDF = new SimpleDateFormat("yyyy-MM-dd");

@Overridepublic Date unmarshal(String date) throwsException {returnSDF.parse(date);

}

@Overridepublic String marshal(Date date) throwsException {returnSDF.format(date);

}

}

6、@XmlAccessorOrder

作用和用法：

包和类级别的注解。控制生成元素的顺序。

属性：

只有一个value属性，可取的值是一个名为XmlAccessOrder的枚举类型的两个值，XmlAccessOrder.ALPHABETICAL 和 XmlAccessOrder.UNDEFINED。默认为XmlAccessOrder.UNDEFINED，代表按照类中字段的顺序生成元素的顺序。

另一个值则代表按照字母表的顺序对生成的元素排序。但奇怪的是，只有jaxb按照field生成元素时，默认值才会生效，否则总是按照字母表的顺序排序。

7、@XmlAccessorType

作用和用法：

包和类级别的注解。javaEE的API对该注解的解释是：控制字段是否被默认序列化。通俗来讲，就是决定哪些字段或哪些get/set方法对应的字段会被映射为xml元素，需要注意的是字段或get/set方法的访问权限(public/private)会影响字段是否被映射为xml元素，下面会详细讲解。

属性：

该注解只有一个value属性，可取的值是一个名为XmlAccessType的枚举类型里的值，下面详细看一下这几个值分别有什么用：

XmlAccessType.PROPERTY:

1.当使用了该值，只要字段有对应的get/set方法对(注意是成对出现，只有其中一个不会发生映射)，不需要使用@XmlElement注解，不论该方法的访问权限是什么(即使是private)，jaxb就会将该字段映射成xml元素。不过最好加上@XmlElement注解，get/set方法任选一个即可，都加上会报错。

2.若在一个字段有set/get方法对但又在字段上添加@XmlElement注解会报属性重复的错误。

3.若没有set/get方法对，则需要在字段上使用@XmlElement注解才可以映射为xml元素，否则不会发生映射。

4.若get/set方法上使用了@XmlTransient注解，但想要对应字段发生映射，需要在对应字段上添加@XmlElement注解，此时不会报错，并将该字段映射为xml元素。

XmlAccessType.FIELD:

1.每个非静态的字段(无论访问权限如何)都会被jaxb映射为xml元素，即使没有get/set方法对，即使没有使用@XmlElement元素，但最好加上该注解以表明该字段要被映射为xml元素。

2.虽然没有get/set方法对，也会发生映射，但加上get/set方法对也不会报错，因为我们经常会使用这两个方法。但注意，不能再在这两个方法上使用@XmlElement方法，否则会报属性重复的错误。

3.若在字段上使用了@XmlTransient注解，但还想让该字段发生映射，需要在该字段对应的get/set方法上添加@XmlElement

XmlAccessType.PUBLIC_MEMBER： (该值为默认值):

1.每个访问权限为public的字段，或者每个访问权限为public的get/set方法对，都会将字段映射为xml元素，即使不使用@XmlElement，但最好加上。不可同时存在public字段和对应的get/set方法对，不然会报属性重复的错误。

2.若使用@XmlElement注解，需要注意只能在字段或get/set方法添加，两者任选其一，否则会报属性重复的错误。

3.若字段不为public，get/set方法为public并使用了@XmlTransient，需要在字段上添加@XmlElement才会发生映射。

若字段为public并使用了@XmlTransient，get/set方法对不为public，需要在get/set方法上使用@XmlElement才会映射。

XmlAccessType.NONE：

任何字段，get/set方法对都不会发生映射，除非使用某些注解，如@XmlElement，@XmlElementWrapper等。