JAXB全称Java Architecture for XML Binding，是Java EE规范中的一部分，主要功能是实现XML数据与Java对象之间的自动映射转换，不需要开发者手动编写XML解析和生成的冗余代码，大幅降低了XML相关开发的复杂度。在需要对接第三方XML接口、处理XML配置文件等场景中，JAXB是非常实用的工具。
JAXB核心注解说明
JAXB通过注解来配置对象和XML元素的映射关系，常用的注解如下：
- @XmlRootElement：标注在类上，指定该类对应的XML根元素名称
- @XmlElement：标注在字段或getter方法上，指定字段对应的XML子元素名称
- @XmlAttribute：标注在字段或getter方法上，指定字段对应的XML属性名称
- @XmlTransient：标注在字段或getter方法上，表示该字段不需要参与XML映射
- @XmlAccessorType：标注在类上，指定JAXB访问字段的方式，比如访问字段本身还是访问getter/setter方法
对象转XML的实现步骤
首先需要定义需要映射的Java对象，使用JAXB注解配置映射关系，示例如下：
import javax.xml.bind.annotation.*;
@XmlRootElement(name = "user")
@XmlAccessorType(XmlAccessType.FIELD)
public class User {
@XmlAttribute(name = "id")
private Integer id;
@XmlElement(name = "user_name")
private String userName;
@XmlElement(name = "age")
private Integer age;
@XmlTransient
private String password;
// 必须提供无参构造器，JAXB反射创建对象需要
public User() {
}
public User(Integer id, String userName, Integer age, String password) {
this.id = id;
this.userName = userName;
this.age = age;
this.password = password;
}
// getter和setter方法省略
}
接下来编写对象转XML的代码：
import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;
import java.io.StringWriter;
public class ObjectToXmlDemo {
public static void main(String[] args) {
try {
// 创建需要转换的对象
User user = new User(1, "张三", 25, "123456");
// 获取JAXB上下文，传入映射的类
JAXBContext context = JAXBContext.newInstance(User.class);
// 创建 Marshaller 对象，用于对象转XML
Marshaller marshaller = context.createMarshaller();
// 设置格式化输出，生成的XML会有缩进
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);
// 设置编码格式
marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8");
// 输出到字符串
StringWriter writer = new StringWriter();
marshaller.marshal(user, writer);
System.out.println(writer.toString());
} catch (Exception e) {
e.printStackTrace();
}
}
}
运行上述代码后，输出的XML内容如下：
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<user id="1">
<user_name>张三</user_name>
<age>25</age>
</user>
可以看到password字段因为添加了@XmlTransient注解，没有出现在生成的XML中，符合预期配置。
XML转对象的实现步骤
XML转对象的过程称为Unmarshal，实现代码示例如下：
import javax.xml.bind.JAXBContext;
import javax.xml.bind.Unmarshaller;
import java.io.StringReader;
public class XmlToObjectDemo {
public static void main(String[] args) {
try {
// 待转换的XML字符串
String xmlContent = "<?xml version="1.0" encoding="UTF-8" standalone="yes"?>n" +
"<user id="1">n" +
" <user_name>张三</user_name>n" +
" <age>25</age>n" +
"</user>";
// 获取JAXB上下文
JAXBContext context = JAXBContext.newInstance(User.class);
// 创建Unmarshaller对象，用于XML转对象
Unmarshaller unmarshaller = context.createUnmarshaller();
// 转换XML字符串为对象
User user = (User) unmarshaller.unmarshal(new StringReader(xmlContent));
System.out.println("用户ID：" + user.getId());
System.out.println("用户名：" + user.getUserName());
System.out.println("年龄：" + user.getAge());
} catch (Exception e) {
e.printStackTrace();
}
}
}
运行后会正确输出转换后的User对象属性，完成XML到对象的映射。
使用注意事项
- 映射的Java类必须提供无参构造器，否则JAXB在反射创建对象时会抛出异常
- 如果XML中有命名空间，需要通过@XmlSchema注解在包级别配置命名空间信息
- JDK 9及之后的版本中，JAXB已经从默认的类路径中移除，如果需要使用需要手动添加相关依赖
- 处理大XML文件时，建议使用StAX结合JAXB的方式，避免一次性加载整个XML到内存造成内存溢出