JAXB需手动引入依赖,通过注解标记Java类,利用JAXBContext的Marshaller和Unmarshaller实现对象与XML互转,适用于配置文件处理等场景。

JAXB(Java Architecture for XML Binding)是Java平台中用于实现Java对象与XML数据之间映射的标准API。它能自动将Java对象序列化为XML,也能将XML解析回Java对象,简化了XML处理流程。下面介绍如何使用JAXB实现对象和XML之间的映射。
1. 添加JAXB依赖
从JDK 11开始,JAXB不再默认包含在JRE中,需要手动引入相关依赖。
如果你使用Maven项目,在pom.xml中添加以下依赖:
jaxb-api:定义核心接口
jaxb-impl:提供运行时实现
jaxb-core:核心工具类
示例Maven依赖:
2. 创建Java实体类并添加注解
要让JAXB知道如何映射,需在Java类上使用注解描述结构。
常见注解包括:
立即学习“Java免费学习笔记(深入)”;
- @XmlRootElement:指定根元素名称
- @XmlElement:映射字段到XML元素
- @XmlAttribute:映射字段到XML属性
- @XmlType:控制字段顺序等
- @XmlAccessorType:设置访问策略(如按字段或属性)
示例类:
import jakarta.xml.bind.annotation.*;
@XmlRootElement(name = "person")
@XmlAccessorType(XmlAccessType.FIELD)
public class Person {
@XmlElement
private String name;
@XmlElement
private int age;
@XmlAttribute
private String id;
// 必须有无参构造函数
public Person() {}
public Person(String id, String name, int age) {
this.id = id;
this.name = name;
this.age = age;
}
// getter 和 setter 方法
public String getName() { return name; }
public void setName(String name) { this.name = name; }
public int getAge() { return age; }
public void setAge(int age) { this.age = age; }
public String getId() { return id; }
public void setId(String id) { this.id = id; }
}
3. 将对象转换为XML(Marshal)
使用JAXBContext创建Marshaller,将Java对象写入XML字符串或文件。
示例代码:
import jakarta.xml.bind.JAXBContext;
import jakarta.xml.bind.Marshaller;
public class ObjectToXml {
public static void main(String[] args) throws Exception {
Person person = new Person("P001", "张三", 28);
JAXBContext context = JAXBContext.newInstance(Person.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 格式化输出
marshaller.marshal(person, System.out);
}
}
输出结果:
4. 将XML转换为对象(Unmarshal)
使用Unmarshaller将XML数据还原为Java对象。
示例代码:
import jakarta.xml.bind.JAXBContext;
import jakarta.xml.bind.Unmarshaller;
import java.io.StringReader;
public class XmlToObject {
public static void main(String[] args) throws Exception {
String xml = "
JAXBContext context = JAXBContext.newInstance(Person.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
Person person = (Person) unmarshaller.unmarshal(new StringReader(xml));
System.out.println("ID: " + person.getId());
System.out.println("姓名: " + person.getName());
System.out.println("年龄: " + person.getAge());
}
}
基本上就这些。只要正确配置依赖、使用注解标注类,并调用JAXBContext的marshal/unmarshal方法,就能轻松实现Java对象与XML的互转。注意类必须有无参构造函数,且字段需提供getter/setter。实际开发中可用于配置文件读取、Web服务数据交换等场景。










