在Java开发中，对象和XML的互转是常见的数据处理需求，JAXB（Java Architecture for XML Binding）作为Java EE和Java SE的标准组件，能够自动完成Java对象与XML文档之间的映射转换，无需手动解析XML节点，大幅降低开发成本。
JAXB核心注解说明
JAXB通过注解定义Java类与XML结构的映射关系，常用的注解如下：
- @XmlRootElement：标注在类上，指定XML的根节点名称
- @XmlElement：标注在字段或getter方法上，指定字段对应的XML子节点名称
- @XmlAttribute：标注在字段或getter方法上，指定字段对应的XML属性
- @XmlTransient：标注在字段或getter方法上，表示该字段不参与XML转换
准备待转换的Java实体类
首先定义一个用户实体类，使用JAXB注解标注映射关系：
import javax.xml.bind.annotation.*;
import java.util.Date;
@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;
@XmlElement(name = "register_time")
private Date registerTime;
@XmlTransient
private String password; // 密码字段不参与XML转换
// 必须提供无参构造器，JAXB反射创建对象需要
public User() {
}
public User(Integer id, String userName, Integer age, Date registerTime, String password) {
this.id = id;
this.userName = userName;
this.age = age;
this.registerTime = registerTime;
this.password = password;
}
// getter和setter方法省略
}
Java对象转XML实现
使用JAXBContext创建上下文，通过Marshaller完成对象到XML的转换：
import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;
import java.io.StringWriter;
import java.util.Date;
public class ObjectToXmlDemo {
public static void main(String[] args) {
try {
// 创建测试用户对象
User user = new User(1, "张三", 25, new Date(), "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);
String xmlResult = writer.toString();
System.out.println("对象转XML结果：");
System.out.println(xmlResult);
} 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>
<register_time>2024-05-20T10:30:00.123+08:00</register_time>
</user>
XML转Java对象实现
使用Unmarshaller完成XML到Java对象的转换，支持从文件、输入流、字符串等来源读取XML：
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="2">n" +
" <user_name>李四</user_name>n" +
" <age>28</age>n" +
" <register_time>2024-05-19T14:20:00.456+08:00</register_time>n" +
"</user>";
// 创建JAXB上下文
JAXBContext context = JAXBContext.newInstance(User.class);
// 创建Unmarshaller对象，用于XML转对象
Unmarshaller unmarshaller = context.createUnmarshaller();
// 从字符串读取XML并转换为对象
StringReader reader = new StringReader(xmlContent);
User user = (User) unmarshaller.unmarshal(reader);
System.out.println("XML转对象结果：");
System.out.println("用户ID：" + user.getId());
System.out.println("用户名：" + user.getUserName());
System.out.println("年龄：" + user.getAge());
System.out.println("注册时间：" + user.getRegisterTime());
} catch (Exception e) {
e.printStackTrace();
}
}
}
常见问题与注意事项
1. 实体类必须有无参构造器
JAXB通过反射创建对象实例时，需要调用无参构造器，如果实体类没有显式定义无参构造器，且定义了有参构造器，会抛出实例化异常。
2. 时间类型格式化问题
默认情况下，Date类型会转换为带时区的标准格式，如果需要自定义时间格式，可以使用@XmlJavaTypeAdapter注解，自定义适配器实现格式化。
3. 集合类型处理
如果实体类包含集合字段，可以通过@XmlElementWrapper注解指定集合的外层包装节点，例如：
import javax.xml.bind.annotation.*;
import java.util.List;
@XmlRootElement(name = "user_list")
public class UserList {
@XmlElementWrapper(name = "users")
@XmlElement(name = "user")
private List<User> users;
public UserList() {
}
// getter和setter省略
}
转换后的XML会生成<users>外层节点，内部包含多个<user>子节点。