Java中如何使用JAXB实现XML与Java对象的相互转换

来源:站长素材作者:上海网站建设头衔:草根站长
导读:本期聚焦于小伙伴创作的《Java中如何使用JAXB实现XML与Java对象的相互转换》,敬请观看详情。在Java开发中,经常会遇到XML数据与Java对象互相转换的场景,JAXB作为Java自带的标准XML绑定框架,能够简化这类转换操作。本文会详细介绍JAXB的核心注解用法,讲解如何将Java对象序列化为XML字符串,以及如何将XML内容反序列化为对应的Java对象。同时会说明JAXB的基础配置方式,给出完整的代码示例,帮助开发者快速掌握JAXB的使用方法,解决实际开发中的XML数据处理需求。

在Java生态中,JAXB(Java Architecture for XML Binding)是官方提供的用于XML和Java对象之间映射转换的框架,它可以通过注解配置实现两者的自动转换,减少了手动解析XML的繁琐工作。

Java中如何使用JAXB实现XML与Java对象的相互转换

JAXB核心注解说明

JAXB通过一系列注解来定义Java类和XML元素的映射关系,常用的注解如下:

  • @XmlRootElement:标注在类上,指定该类对应XML的根元素。
  • @XmlAccessorType:指定JAXB访问类属性的方式,常用值为XmlAccessType.FIELD,表示直接访问字段。
  • @XmlElement:标注在字段或getter方法上,指定字段对应的XML子元素名称和属性。
  • @XmlAttribute:标注在字段或getter方法上,指定字段对应XML元素的属性。

定义待转换的Java实体类

首先我们定义一个用户类,使用JAXB注解配置和XML的映射关系:

import javax.xml.bind.annotation.*;

@XmlRootElement(name = "user")
@XmlAccessorType(XmlAccessType.FIELD)
public class User {
    @XmlAttribute(name = "id")
    private Integer id;
    
    @XmlElement(name = "name")
    private String name;
    
    @XmlElement(name = "age")
    private Integer age;
    
    @XmlElement(name = "email")
    private String email;
    
    // 必须提供无参构造器,JAXB反序列化时需要
    public User() {
    }
    
    public User(Integer id, String name, Integer age, String email) {
        this.id = id;
        this.name = name;
        this.age = age;
        this.email = email;
    }
    
    // getter和setter方法
    public Integer getId() {
        return id;
    }
    
    public void setId(Integer id) {
        this.id = id;
    }
    
    public String getName() {
        return name;
    }
    
    public void setName(String name) {
        this.name = name;
    }
    
    public Integer getAge() {
        return age;
    }
    
    public void setAge(Integer age) {
        this.age = age;
    }
    
    public String getEmail() {
        return email;
    }
    
    public void setEmail(String email) {
        this.email = email;
    }
}

Java对象转换为XML(序列化)

使用JAXB的Marshaller类可以将Java对象转换为XML格式的数据,以下是具体实现代码:

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;
import java.io.StringWriter;

public class JavaToXmlDemo {
    public static void main(String[] args) {
        try {
            // 创建用户对象
            User user = new User(1, "张三", 25, "zhangsan@ipipp.com");
            
            // 获取JAXB上下文,传入要转换的类
            JAXBContext context = JAXBContext.newInstance(User.class);
            // 创建序列化器
            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">
    <name>张三</name>
    <age>25</age>
    <email>zhangsan@ipipp.com</email>
</user>

XML转换为Java对象(反序列化)

使用JAXB的Unmarshaller类可以将XML数据转换为对应的Java对象,实现代码如下:

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Unmarshaller;
import java.io.StringReader;

public class XmlToJavaDemo {
    public static void main(String[] args) {
        try {
            // 待转换的XML字符串
            String xmlContent = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>" +
                    "<user id=\"1\">" +
                    "<name>张三</name>" +
                    "<age>25</age>
                    "<email>zhangsan@ipipp.com</email>" +
                    "</user>";
            
            // 获取JAXB上下文
            JAXBContext context = JAXBContext.newInstance(User.class);
            // 创建反序列化器
            Unmarshaller unmarshaller = context.createUnmarshaller();
            
            // 将XML字符串转换为Java对象
            StringReader reader = new StringReader(xmlContent);
            User user = (User) unmarshaller.unmarshal(reader);
            
            System.out.println("转换后的User对象信息:");
            System.out.println("ID:" + user.getId());
            System.out.println("姓名:" + user.getName());
            System.out.println("年龄:" + user.getAge());
            System.out.println("邮箱:" + user.getEmail());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

注意事项

  • 被JAXB转换的Java类必须提供无参构造器,否则反序列化时会抛出异常。
  • 如果Java类的字段是私有的,且使用@XmlAccessorType(XmlAccessType.FIELD)注解,不需要提供getter和setter方法也可以完成转换,但提供这些方法更符合JavaBean规范。
  • JAXB在Java 9之后被标记为可选模块,如果使用的是高版本JDK,需要手动引入JAXB相关依赖才能正常使用。

JAXBXMLJava对象转换注解修改时间:2026-06-06 14:43:01

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。