讲师中心 微信公众号
AI工具推荐 视频效率加速

Java如何使用JAXB解析XML JAXB注解使用教程

胖墨酱_5774

胖墨酱_5774

发布时间:2025-12-23 05:59:19

|

717人浏览过

|

来源于php中文网

原创

Java中JAXB解析XML的核心是通过注解(如@XmlRootElement、@XmlElement、@XmlAttribute)和API(JAXBContext、Unmarshaller)将XML映射为Java对象;JDK 8及以前自带,JDK 9+需手动引入jakarta.xml.bind依赖。

java如何使用jaxb解析xml jaxb注解使用教程

Java中用JAXB解析XML,核心是把XML结构映射成Java对象,靠的是JAXB注解和JAXBContext、Unmarshaller这些API。不需要第三方库(JDK 8及以前自带),但JDK 9+默认移除了JAXB模块,需手动添加依赖。

基础注解:@XmlRootElement 和 @XmlElement

这是最常用的两个注解。@XmlRootElement 标记类为XML根元素;@XmlElement 控制字段/属性如何映射为XML子元素。

例如有XML:

<person id="1001">
  <name>张三</name>
  <age>28</age>
</person>

对应Java类写法:

立即学习Java免费学习笔记(深入)”;

Wikclawpedia Archive Access
Wikclawpedia Archive Access

访问、搜索、检索并提交 Wikclawpedia 代理档案中经核实的代理、平台、瞬间、语录和创作者条目。

下载
@XmlRootElement(name = "person")
public class Person {
    @XmlAttribute(name = "id")
    private String id;

    @XmlElement(name = "name")
    private String name;

    @XmlElement(name = "age")
    private int age;

    // 必须有无参构造方法
    public Person() {}

    // getter/setter 省略
}
  • @XmlRootElement 的 name 属性可省略,若省略则默认使用类名小写(如 person)
  • @XmlAttribute 用于映射XML属性,@XmlElement 用于映射XML子元素
  • 所有参与绑定的字段或getter/setter必须是public,或提供public访问器

处理集合:@XmlElementWrapper 和 @XmlElement

当XML中有包裹标签的列表时(比如 <books><book>...</book><book>...</book></books>),需要用 @XmlElementWrapper 指定外层标签,@XmlElement 指定内层项标签。

示例:

public class Library {
    @XmlElementWrapper(name = "books")
    @XmlElement(name = "book")
    private List<Book> bookList = new ArrayList<>();

    // getter/setter
}
  • @XmlElementWrapper 不加 name 时,默认用字段名(如 books)
  • 如果不需要外层包裹标签(直接多个 <book> 并列),就只用 @XmlElement,去掉 @XmlElementWrapper
  • List 字段建议初始化,避免反序列化时为 null

控制命名与格式:@XmlAccessorType 和 @XmlType

@XmlAccessorType 决定JAXB扫描哪些成员(字段/属性)。默认是 FIELD(直接读字段),但更推荐 PROPERTY,即只通过 getter/setter 访问,便于封装。

@XmlAccessorType(XmlAccessType.PROPERTY)
@XmlType(propOrder = {"id", "name", "age"})
public class Person {
    private String id;
    private String name;
    private int age;

    @XmlAttribute
    public String getId() { return id; }
    public void setId(String id) { this.id = id; }

    @XmlElement
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    @XmlElement
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}
  • XmlAccessType.FIELD:直接读字段(不走getter/setter)
  • XmlAccessType.PROPERTY:只通过getter/setter访问,字段可设为private
  • @XmlType 的 propOrder 指定XML中元素顺序,不写则按源码顺序或字母序

解析与生成XML的代码示例

反序列化(XML → Java对象):

String xml = "<person id=\"1001\"><name>李四</name><age>30</age></person>";
JAXBContext context = JAXBContext.newInstance(Person.class);
Unmarshaller unmarshaller = context.createUnmarshaller();
Person person = (Person) unmarshaller.unmarshal(new StringReader(xml));

序列化(Java对象 → XML):

Person p = new Person();
p.setId("1002");
p.setName("王五");
p.setAge(25);

JAXBContext context = JAXBContext.newInstance(Person.class);
Marshaller marshaller = context.createMarshaller();
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true); // 美化输出
marshaller.marshal(p, System.out);
  • 注意捕获 JAXBException 异常
  • JDK 11+ 需添加 Maven 依赖:jakarta.xml.bind:jakarta.xml.bind-apiorg.glassfish.jaxb:jaxb-runtime
  • 若XML含命名空间,需配合 @XmlSchema、@XmlNs 使用

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

2840

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

289

2026.05.09

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

509

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1638

2024.03.01

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3944

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

5017

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2262

2024.11.28

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

0

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

0

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn