JAXB

JAXB：实现xml和java对象互转

JAXB是一个业界的标准，实现XML文件和Java对象的互转。
JAXB是JDK 的组成部分。我们不需要下载第三方jar包 即可做到轻松转换。

重要类和接口：

	○ JAXBContext类，是应用的入口，用于管理XML/Java绑定信息。
	○ Marshaller接口，将Java对象序列化为XML数据。
	○ Unmarshaller接口，将XML数据反序列化为Java对象。

注解

从XML到Java对象的注解：
	○ @XmlType： 
	○ @XmlElement ：将java对象的属性映射为xml的节点
	○ @XmlRootElement：此类对应xml的根元素
	○ @XmlAttribute ：把java对象的属性映射为xml的属性
	○ @XmlAccessorType ：用于指定由java对象生成xml文件时对java对象属性的访问方式
	○ @XmlJavaTypeAdapter ：在转换比较复杂的对象时，如map类型或者格式化日期等。使用此注解时，需要自己写一个XmlAdapter类
从Java对象到XML的注解：
	○ @XmlAccessorOrder ：对java对象生成的xml元素进行排序
	○ @XmlTransient ：定义某一字段或属性不需要被映射为XML
	○ @XmlElementWrapper ：为数组元素或集合元素定义一个父节点

工程实现

demo1：演示xml基本用法，演示@XmlRootElement 、@XmlAccessorType、@XmlElement的用法

基础POJO类 ClassRoomModel包含一个变量name和变量StudentModel列表

public class StudentModel {
    private int id; // 学号
    private String name; // 名称
    private String sex; // 性别
}

@XmlRootElement(name = "classRoom")
@XmlAccessorType(value = XmlAccessType.FIELD)
public class ClassRoomModel {
    @XmlElement(name="name")
    private String name;

    @XmlElement(name="student")
    private List<StudentModel> studentModelList;
}

待转化classroom.xml

<?xml version="1.0" encoding="UTF-8"?>
<classRoom>
    <name>配置总名称</name>
    <student>
        <id>1</id>
        <name>张三</name>
        <sex>男</sex>
    </student>
    <student>
        <id>2</id>
        <name>李四</name>
        <sex>女</sex>
    </student>
</classRoom>

测试类JAXBManager：创建JAXBContext对象，根据JAXBContext对象创建Unmarshaller 对象，使用Unmarshaller 对象实现将xml转化为ClassRoomModel对象。根据JAXBContext对象创建Marshaller 对象，使用Marshaller 实现将ClassRoomModel 对象转化为xml文件

JAXBContext jaxbContext = JAXBContext.newInstance(ClassRoomModel.class);
// 从xml文件中读取，并转化为java对象
Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
InputStream classRoomInputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("com/hry/java/xml/classroom.xml");
System.out.println(JAXBManager.class.getClassLoader().getResource(""));
System.out.println(Thread.currentThread().getContextClassLoader().getResource(""));

ClassRoomModel classRoomModel = (ClassRoomModel)unmarshaller.unmarshal(classRoomInputStream);
System.out.println(JSON.toJSONString(classRoomModel));

// 保存文件，将Java对象转化为xml文件
Marshaller marshaller = jaxbContext.createMarshaller();
marshaller.marshal(classRoomModel, new File("classroon-save.xml"));

demo2: 演示@XmlAttribute、@XmlJavaTypeAdapter、XmlAdapter用法

基础POJO类： ClassRoomModel2包含一个变量name和变量StudentModel列表此demo和上面的类不同，StudentModel2 是使用@XmlAttribute通过xml元素的属性注入值，另外增加属性Date对象

@XmlAccessorType(value = XmlAccessType.FIELD)
public class StudentModel2 {
    @XmlAttribute(name = "id")
    private int id; // 学号
    @XmlAttribute(name = "name")
    private String name; // 名称
    @XmlAttribute(name = "sex")
    private String sex; // 性别
    @XmlAttribute(name = "birthDate")
    @XmlJavaTypeAdapter(value = DateXmlAdapter.class) // 配置日期转化器
    private Date birthDate; // 生日
}

@XmlRootElement(name = "classRoom")
@XmlAccessorType(value = XmlAccessType.FIELD)
public class ClassRoomModel2 {
    @XmlElement(name="name")
    private String name;

    @XmlElement(name="student")
    private List<StudentModel2> studentModelList;
}

待转化xml文件

<?xml version="1.0" encoding="UTF-8"?>
<classRoom>
    <name>配置总名称</name>
    <student id="1" name="张三" sex="男" birthDate="1999-10-22" />
    <student id="2" name="李四" sex="女" birthDate="1997-12-23"  />
</classRoom>

XmlAdapter用法： StudentModel2 里的成员变量birthDate的新注解@XmlJavaTypeAdapter(value = DateXmlAdapter.class)，实现日期String和Date的相互转化

public class DateXmlAdapter extends XmlAdapter<String, Date> {
    // 时间
    private static final ThreadLocal<SimpleDateFormat> simpleDateFormatThreadLocalYYYYMMDD = new ThreadLocal<SimpleDateFormat>(){
        @Override
        protected SimpleDateFormat initialValue() {
            return new SimpleDateFormat("yyyy-MM-dd");
        }
    };

    @Override
    public Date unmarshal(String v) throws Exception {
        System.out.println(v);
        return simpleDateFormatThreadLocalYYYYMMDD.get().parse(v);
    }

    @Override
    public String marshal(Date v) throws Exception {
        System.out.println(v);
        return simpleDateFormatThreadLocalYYYYMMDD.get().format(v);
    }
}

测试类JAXBManager： 用法和第一个demo相同，详细见代码

public static void main(String[] args){
        try {
            JAXBContext jaxbContext = JAXBContext.newInstance(ClassRoomModel2.class);

            // 从xml文件中读取，并转化为java对象
            Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();

            InputStream classRoomInputStream = Thread.currentThread().getContextClassLoader().getResourceAsStream("com/hry/java/xml/classroom2.xml");
            System.out.println(JAXBManager2.class.getClassLoader().getResource(""));
            System.out.println(Thread.currentThread().getContextClassLoader().getResource(""));

            ClassRoomModel2 classRoomModel = (ClassRoomModel2)unmarshaller.unmarshal(classRoomInputStream);
            System.out.println(JSON.toJSONString(classRoomModel));

            // 保存文件，将Java对象转化为xml文件
            Marshaller marshaller = jaxbContext.createMarshaller();
            marshaller.marshal(classRoomModel, new File("classroon-save2.xml"));

        } catch (JAXBException e) {
            e.printStackTrace();
        }
    }

异常处理

如果不在类加上@XmlAccessorType(value = XmlAccessType.FIELD)，则可能抛出如下异常。@XmlAccessorType的默认访问级别是XmlAccessType.PUBLIC_MEMBER，因此，如果java对象中的private成员变量设置了public权限的getter/setter方法，就不要在private变量上使用@XmlElement和@XmlAttribute注解，否则在由java对象生成xml时会报同一个属性在java类里存在两次的错误，异常如下：

com.sun.xml.internal.bind.v2.runtime.IllegalAnnotationsException: 2 counts of IllegalAnnotationExceptions
类的两个属性具有相同名称 "name"
	this problem is related to the following location:
		at public java.lang.String com.hry.java.xml.model.ClassRoomModel.getName()
		at com.hry.java.xml.model.ClassRoomModel
	this problem is related to the following location:
		at private java.lang.String com.hry.java.xml.model.ClassRoomModel.name
at com.hry.java.xml.model.ClassRoomModel

代码

以上的详细代码见这里Github