JAXB通过注解实现Java对象与XML双向绑定,核心为@XmlRootElement、@XmlElement等注解,配合JAXBContext完成Marshalling和Unmarshalling,支持基本类型、集合及嵌套对象,但不支持接口和循环引用;自Java 11起需单独引入依赖,新项目多采用Jackson XML或Simple Framework替代。

JAXB 是 Java 提供的一套标准 API,用于在 Java 对象和 XML 文档之间自动转换,也就是“绑定”(Binding)。它让开发者不用手写解析(如 SAX/DOM)或拼装 XML,而是通过注解和工具,把对象结构直接映射成 XML 格式,反之亦然。
核心机制:注解驱动的双向绑定
JAXB 依靠一组标准注解(如 @XmlRootElement、@XmlElement、@XmlAttribute)来声明 Java 类与 XML 元素的对应关系。这些注解告诉 JAXB 运行时:哪个类对应根元素、哪个字段映射为子元素、哪个字段作为属性、是否忽略某字段等。
- 加了 @XmlRootElement 的类才能作为 XML 的根节点被序列化或反序列化
- @XmlElement(name = "name") 指定字段生成的 XML 标签名;不写 name 则默认用字段名
- @XmlAttribute 让字段值变成对应元素的属性,而非子元素
- @XmlAccessorType(XmlAccessType.FIELD) 可控制是按字段还是按 getter/setter 绑定
主要操作:Marshalling 与 Unmarshalling
从 Java 对象生成 XML 叫 Marshalling;从 XML 解析回 Java 对象叫 Unmarshalling。两者都通过 JAXBContext(上下文工厂)统一管理。
- 先调用 JAXBContext.newInstance(MyClass.class) 创建上下文
- 再用它获取 Marshaller 或 Unmarshaller 实例
- Marshaller 可设置格式化输出(setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true)),让生成的 XML 可读
- Unmarshaller 默认严格校验 XML 结构,也可关闭验证以容忍轻微差异
支持类型与常见约束
JAXB 原生支持基本类型(String、int、Date 等)、集合(List、Set,需配合 @XmlElementWrapper 和 @XmlElement)、嵌套对象及泛型擦除后的集合。但它不支持接口、抽象类直接实例化,也不处理循环引用——遇到这些需手动干预(如用 @XmlTransient 断开引用,或自定义 XmlAdapter)。
立即学习“Java免费学习笔记(深入)”;
- 集合字段必须有 public getter/setter,且泛型信息在运行时已擦除,所以需靠注解明确项类型
- Date 类型默认映射为 xsd:dateTime,也可用 @XmlJavaTypeAdapter 自定义格式(如只保留日期)
- 字段为 null 时,默认不输出对应 XML 元素;加 @XmlElement(required = true) 可强制存在
现状与替代建议
从 Java 11 开始,JAXB 被移出 JDK 默认模块(需单独引入 jakarta.xml.bind:jakarta.xml.bind-api 和 runtime 实现);Java 17+ 完全不包含。主流新项目多转向 Jackson XML(com.fasterxml.jackson.dataformat:jackson-dataformat-xml)或 Simple Framework,它们更轻量、配置灵活、维护活跃。但已有系统中 JAXB 仍广泛使用,理解其原理对维护和迁移很有帮助。
基本上就这些。










