Java如何使用JAXB解析XML JAXB注解使用教程_技术教程

Java中JAXB解析XML的核心是通过注解（如@XmlRootElement、@XmlElement、@XmlAttribute）和API（JAXBContext、Unmarshaller）将XML映射为Java对象；JDK 8及以前自带，JDK 9+需手动引入jakarta.xml.bind依赖。

Java中用JAXB解析XML，核心是把XML结构映射成Java对象，靠的是JAXB注解和JAXBContext、Unmarshaller这些API。不需要第三方库（JDK 8及以前自带），但JDK 9+默认移除了JAXB模块，需手动添加依赖。

基础注解：@XmlRootElement 和 @XmlElement

这是最常用的两个注解。@XmlRootElement 标记类为XML根元素；@XmlElement 控制字段/属性如何映射为XML子元素。

例如有XML：

张三
28

对应Java类写法：

@XmlRootElement(name = "person")
public class Person {
    @XmlAttribute(name = "id")
    private String id;

    @XmlElement(name = "name")
    private String name;

    @XmlElement(name = "age")
    private int age;

    // 必须有无参构造方法
    public Person() {}

    // getter/setter 省略
}

@XmlRootElement 的 name 属性可省略，若省略则默认使用类名小写（如 person）
@XmlAttribute 用于映射XML属性，@XmlElement 用于映射XML子元素
所有参与绑定的字段或getter/setter必须是public，或提供public访问器

处理集合：@XmlElementWrapper 和 @XmlElement

当XML中有包裹标签的列表时（比如 ......），需要用 @XmlElementWrapper 指定外层标签，@XmlElement 指定内层项标签。

示例：

public class Library {
    @XmlElementWrapper(name = "books")
    @XmlElement(name = "book")
    private List bookList = new ArrayList<>();

    // getter/setter
}

@XmlElementWrapper 不加 name 时，默认用字段名（如 books）
如果不需要外层包裹标签（直接多个并列），就只用 @XmlElement，去掉 @XmlElementWrapper
List 字段建议初始化，避免反序列化时为 null

控制命名与格式：@XmlAccessorType 和 @XmlType

@XmlAccessorType 决定JAXB扫描哪些成员（字段/属性）。默认是 FIELD（直接读字段），但更推荐 PROPERTY，即只通过 getter/setter 访问，便于封装。

@XmlAccessorType(XmlAccessType.PROPERTY)
@XmlType(propOrder = {"id", "name", "age"})
public class Person {
    private String id;
    private String name;
    private int age;

    @XmlAttribute
    public String getId() { return id; }
    public void setId(String id) { this.id = id; }

    @XmlElement
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    @XmlElement
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}

XmlAccessType.FIELD：直接读字段（不走getter/setter）
XmlAccessType.PROPERTY：只通过getter/setter访问，字段可设为private
@XmlType 的 propOrder 指定XML中元素顺序，不写则按源码顺序或字母序

解析与生成XML的代码示例

反序列化（XML → Java对象）：

String xml = "李四30";
JAXBContext context = JAXBContext.newInstance(Person.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
Person person = (Person) unmarshaller.unmarshal(new StringReader(xml));

序列化（Java对象 → XML）：

Person p = new Person();
p.setId("1002");
p.setName("王五");
p.setAge(25);

JAXBContext context = JAXBContext.newInstance(Person.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 美化输出
marshaller.marshal(p, System.out);

注意捕获 JAXBException 异常
JDK 11+ 需添加 Maven 依赖：jakarta.xml.bind:jakarta.xml.bind-api 和 org.glassfish.jaxb:jaxb-runtime
若XML含命名空间，需配合 @XmlSchema、@XmlNs 使用