Java生成XML文件方法 使用JAXB将对象转为XML

小墨小哥_6695

小墨小哥_6695

2026-02-25

819人浏览

原创

JAXB在JDK 9+被移除,需按版本适配:JDK 8开箱即用,JDK 9–10加--add-modules,JDK 11+引Maven依赖;@XmlRootElement不可少,缺则marshal报错;中文乱码和格式靠Marshaller.setProperty设置UTF-8和formatted.output;字段映射需@XmlXXX注解控制,泛型集合建议转DTO。

java生成xml文件方法 使用jaxb将对象转为xml

Java里用JAXB生成XML前必须确认JDK版本

JAXB在JDK 9+被移出默认类路径,直接new JAXBContext会抛ClassNotFoundException。OpenJDK 11及以后完全不带JAXB实现,不是“用不了”,而是“根本没加载”。

  • JDK 8:开箱即用,JAXBContext.newInstance()能直接跑
  • JDK 9–10:需加启动参数--add-modules java.xml.bind
  • JDK 11+:必须显式引入Maven依赖,例如jakarta.xml.bind:jakarta.xml.bind-api和org.glassfish.jaxb:jaxb-runtime

@XmlRootElement缺了就无法marshal

调用marshaller.marshal()时如果对象类没加@XmlRootElement,会报IllegalArgumentException: class XXX nor any of its super class is known to this context——这不是配置错,是JAXB压根不认识这个类。

  • 必须加在类上:@XmlRootElement(name = "user"),name可选,但注解不能少
  • 如果类是嵌套的(比如List里的元素),每个要序列化的实体类都得有该注解
  • 接口、抽象类、无参构造器缺失也会触发同类错误,但根源不同:JAXB需要默认构造器来反序列化,而marshal阶段虽不反向,但上下文注册仍依赖它

中文乱码和格式缩进靠Marshaller属性控制

生成的XML文件打开是乱码或全挤在一行,不是编码问题没设对,就是Marshaller没开启对应开关。

Java Development Man
Java Development Man

Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。

下载
  • 输出UTF-8:调用marshaller.setProperty("jaxb.encoding", "UTF-8"),注意字符串值必须小写
  • 美化输出(带换行缩进):marshaller.setProperty("jaxb.formatted.output", true)
  • 指定XML声明是否写入:marshaller.setProperty("jaxb.fragment", false)(false才写)
  • 别在FileOutputStream里设编码,JAXB自己处理字节流,外部设编码反而可能冲突

字段不出现、顺序错、空值处理要靠@XmlXXX系列注解

生成的XML字段名不对、顺序颠倒、null字段消失或变成xsi:nil="true",都是因为没干预默认映射规则。

  • 改字段名:用@XmlElement(name = "user_name"),别只靠setName()方法名推导
  • 控顺序:加@XmlType(propOrder = {"id", "name", "email"}),字段必须全列且与实际变量名一致
  • null值处理:@XmlElement(nillable = true)让null输出为;若想彻底忽略null字段,得用@XmlElement(required = false)并配合自定义Marshaller事件处理器,但更常用的是预过滤对象字段
  • 别忘了@XmlAccessorType(XmlAccessType.FIELD),否则JAXB默认按getter/setter找属性,private字段可能被跳过

JAXB对泛型集合支持弱,List直接marshal可能丢类型信息;@XmlJavaTypeAdapter也不是万能的,尤其嵌套泛型容易漏配。真要稳定输出,建议先转成明确的DTO类,而不是拿原始业务对象硬上。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Java Maven专题
Java Maven专题

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

2025.09.15

4780

19

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

2026.05.09

409

25

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

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

2023.09.22

569

3

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

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

2024.03.01

1698

6

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

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

2024.04.01

5184

5

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

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

2024.08.01

6757

7

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

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

2024.11.28

2642

7

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1938

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

3224

5

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习