Java使用JAXB操作XML示例

JAXB（Java Architecture for XML Binding）是Java平台中用于实现XML与Java对象之间相互转换的技术，通过注解可以将Java类的属性与XML元素、属性进行映射，无需手动编写XML解析和生成的逻辑，大幅简化XML相关操作。下面通过一个完整示例演示如何使用JAXB实现XML的序列化（Java对象转XML）和反序列化（XML转Java对象）。

一、准备实体类

首先需要定义与XML结构对应的Java实体类，通过JAXB相关注解完成映射。下面的示例定义了一个用户类，包含用户基本信息，对应XML中的用户节点结构。

import javax.xml.bind.annotation.*;
import java.util.List;

// 指定该类的根元素名称为user
@XmlRootElement(name = "user")
// 指定XML中元素的排列顺序
@XmlType(propOrder = {"id", "name", "age", "hobbies"})
public class User {
    private Integer id;
    private String name;
    private Integer age;
    private List<String> hobbies;

    // 映射XML中的id属性
    @XmlAttribute(name = "id")
    public Integer getId() {
        return id;
    }

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

    // 映射XML中的name子元素
    @XmlElement(name = "name")
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    // 映射XML中的age子元素
    @XmlElement(name = "age")
    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    // 映射XML中的hobbies集合，每一个hobby对应一个hobby子元素
    @XmlElementWrapper(name = "hobbies")
    @XmlElement(name = "hobby")
    public List<String> getHobbies() {
        return hobbies;
    }

    public void setHobbies(List<String> hobbies) {
        this.hobbies = hobbies;
    }
}

上述代码中用到的JAXB注解说明：

• @XmlRootElement：指定Java类对应的XML根元素名称，name属性可自定义根元素标签名。
• @XmlType：propOrder属性用于指定XML中元素的生成顺序，需和类中属性的getter方法顺序对应。
• @XmlAttribute：将Java属性映射为XML元素的属性，而非子元素。
• @XmlElement：将Java属性映射为XML元素的子元素，name属性可自定义子元素标签名。
• @XmlElementWrapper：用于包装集合类型的属性，会在集合外层生成一个父元素。

二、Java对象转XML（序列化）

序列化操作是将构造好的Java对象通过JAXB的上下文和 Marshaller 转换为XML字符串，下面是具体实现代码：

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Marshaller;
import java.io.StringWriter;
import java.util.Arrays;

public class JaxbSerializeDemo {
    public static void main(String[] args) {
        try {
            // 1. 构造User对象并设置属性
            User user = new User();
            user.setId(1001);
            user.setName("张三");
            user.setAge(25);
            user.setHobbies(Arrays.asList("篮球", "阅读", "编程"));

            // 2. 创建JAXB上下文，传入需要转换的实体类
            JAXBContext context = JAXBContext.newInstance(User.class);
            // 3. 创建Marshaller对象，用于执行序列化操作
            Marshaller marshaller = context.createMarshaller();
            // 设置格式化输出，生成的XML会自动缩进，方便阅读
            marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
            // 设置编码为UTF-8，避免中文乱码
            marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");

            // 4. 执行序列化，将对象转换为XML写入字符串输出流
            StringWriter writer = new StringWriter();
            marshaller.marshal(user, writer);

            // 5. 输出生成的XML字符串
            String xmlResult = writer.toString();
            System.out.println("生成的XML内容：");
            System.out.println(xmlResult);
        } catch (JAXBException e) {
            e.printStackTrace();
        }
    }
}

运行上述代码后，会生成如下格式的XML：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<user id="1001">
    <name>张三</name>
    <age>25</age>
    <hobbies>
        <hobby>篮球</hobby>
        <hobby>阅读</hobby>
        <hobby>编程</hobby>
    </hobbies>
</user>

三、XML转Java对象（反序列化）

反序列化操作是将已有的XML字符串通过JAXB的 Unmarshaller 转换为对应的Java对象，下面是具体实现代码：

import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;
import java.io.StringReader;

public class JaxbDeserializeDemo {
    public static void main(String[] args) {
        // 待转换的XML字符串
        String xmlContent = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n" +
                "<user id=\"1001\">\n" +
                "    <name>张三</name>\n" +
                "    <age>25</age>\n" +
                "    <hobbies>\n" +
                "        <hobby>篮球</hobby>\n" +
                "        <hobby>阅读</hobby>\n" +
                "        <hobby>编程</hobby>\n" +
                "    </hobbies>\n" +
                "</user>";

        try {
            // 1. 创建JAXB上下文，传入目标实体类
            JAXBContext context = JAXBContext.newInstance(User.class);
            // 2. 创建Unmarshaller对象，用于执行反序列化操作
            Unmarshaller unmarshaller = context.createUnmarshaller();

            // 3. 执行反序列化，将XML字符串转换为User对象
            StringReader reader = new StringReader(xmlContent);
            User user = (User) unmarshaller.unmarshal(reader);

            // 4. 输出反序列化后的对象属性
            System.out.println("反序列化得到的User信息：");
            System.out.println("用户ID：" + user.getId());
            System.out.println("用户姓名：" + user.getName());
            System.out.println("用户年龄：" + user.getAge());
            System.out.println("用户爱好：" + user.getHobbies());
        } catch (JAXBException e) {
            e.printStackTrace();
        }
    }
}

运行上述代码后，控制台会输出反序列化得到的User对象的各个属性值，说明XML成功转换为了对应的Java对象。

四、注意事项

1. JAXB在Java 8及之前版本是内置的，从Java 9开始，JAXB被标记为废弃，Java 11及之后版本不再默认包含，如果需要使用，需要手动引入相关依赖，例如Maven项目可添加以下依赖：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
    <version>2.3.1</version>
</dependency>

2. 实体类必须要有无参构造方法，JAXB在反序列化时会通过无参构造创建对象，再赋值属性，如果没有无参构造会抛出相关异常。

3. 注解的使用要符合规范，如果属性是私有的，建议将注解加在getter方法上，避免和字段注解冲突。

JAXBJava对象转XMLXML反序列化注解配置Java XML操作 本作品最后修改时间：2026-05-22 21:42:05