JAXB实现Java对象与XML互转,通过注解如@XmlRootElement、@XmlElement定义映射关系,使用JAXBContext进行编组和解组操作,Java 9+需引入jakarta.xml.bind依赖,适用于配置文件处理和Web服务数据交换。

JAXB(Java Architecture for XML Binding)是Java平台的一部分,用来实现Java对象与XML数据之间的相互转换。它简化了处理XML的过程,开发者无需手动解析或生成XML,而是通过注解和API自动完成序列化与反序列化。
JAXB核心功能
JAXB主要提供两个方向的操作:
- 编组(Marshalling):将Java对象转换为XML文档
- 解组(Unmarshalling):将XML文档转换为Java对象
这个过程依赖于Java类上的注解来定义XML结构,比如根元素、标签名、属性等。
使用JAXB的基本步骤
要在项目中使用JAXB,需要定义带有JAXB注解的Java类,并利用JAXBContext进行转换操作。
立即学习“Java免费学习笔记(深入)”;
1. 添加依赖(Java 9+ 需要显式引入)从Java 9开始,JAXB不再默认包含在JDK中。Maven项目需添加以下依赖:
2. 创建Java类并添加JAXB注解jakarta.xml.bind jakarta.xml.bind-api 4.0.0 org.glassfish.jaxb jaxb-runtime 4.0.2
例如,定义一个表示书籍的类:
import jakarta.xml.bind.annotation.*;
@XmlRootElement(name = "book")
@XmlAccessorType(XmlAccessType.FIELD)
public class Book {
@XmlElement(name = "title")
private String title;
@XmlElement(name = "author")
private String author;
@XmlAttribute(name = "id")
private String id;
// 必须有无参构造函数
public Book() {}
public Book(String id, String title, String author) {
this.id = id;
this.title = title;
this.author = author;
}
// getter 和 setter 方法
public String getTitle() { return title; }
public void setTitle(String title) { this.title = title; }
public String getAuthor() { return author; }
public void setAuthor(String author) { this.author = author; }
public String getId() { return id; }
public void setId(String id) { this.id = id; }
}
3. Java对象转XML(编组)使用JAXBContext和Marshaller将对象写入XML文件或字符串:
import jakarta.xml.bind.JAXBContext;
import jakarta.xml.bind.Marshaller;
public class ObjectToXml {
public static void main(String[] args) throws Exception {
Book book = new Book("B001", "Java编程思想", "Bruce Eckel");
JAXBContext context = JAXBContext.newInstance(Book.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 格式化输出
marshaller.marshal(book, System.out);
}
}
输出结果:
4. XML转Java对象(解组)Java编程思想 Bruce Eckel
将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 = "" +
"Java编程思想 " +
"Bruce Eckel " +
" ";
JAXBContext context = JAXBContext.newInstance(Book.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
StringReader reader = new StringReader(xml);
Book book = (Book) unmarshaller.unmarshal(reader);
System.out.println("ID: " + book.getId());
System.out.println("Title: " + book.getTitle());
System.out.println("Author: " + book.getAuthor());
}
}
常用JAXB注解说明
- @XmlRootElement:指定XML根元素名称
- @XmlAccessorType:定义字段或属性的访问策略(如FIELD表示直接访问字段)
- @XmlElement:映射字段到XML子元素
- @XmlAttribute:映射字段到XML属性
- @XmlTransient:忽略某个字段不参与XML转换
基本上就这些。JAXB让Java与XML交互变得直观简单,适合配置文件读写、Web服务数据交换等场景。注意Java版本兼容性问题,尤其是Java 11以后推荐使用Jakarta EE的JAXB实现。










