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:
对应Java类写法:
立即学习“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中有包裹标签的列表时(比如
示例:
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 = ""; JAXBContext context = JAXBContext.newInstance(Person.class); Unmarshaller unmarshaller = context.createUnmarshaller(); Person person = (Person) unmarshaller.unmarshal(new StringReader(xml)); 李四 30
序列化(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 使用










