JAXB元素详解

article/2025/9/23 17:19:38

JAXB简介

JAXB（Java Architecture for XML Binding) 是一个业界的标准，是一项可以根据XML
Schema产生Java类的技术。该过程中，JAXB也提供了将XML实例文档反向生成Java对象树的方法，并能将Java对象树的内容重新写到XML实例文档。从另一方面来讲，JAXB提供了快速而简便的方法将XML模式绑定到Java表示，从而使得Java开发者在Java应用程序中能方便地结合XML数据和处理函数。

1. @XmlRootElement(类级别):

标识这个类或枚举类型是根元素，将会被映射到 XML 元素中。 JAXB中的注解，用来根据java类生成xml内容。当使用
@XmlRootElement 注释对顶层类或枚举类型进行注释时，类型值被表示为 XML 文档中的 XML 元素。

2. @XmlElement

将java对象的属性映射为xml的节点。将没有get方法/set方法的属性映射到XML。

3. @XmlAttribute

将java对象的属性映射为xml的节点的属性。

4. @XmlType(propOrder = { “id”, “name”, “age”,“book”})(类级别)

指定属性输出顺序。

5. @XmlElementWrapper(name = “allnames”)

仅允许出现在集合属性上，在原xml结点上再包装一层xml节点。

@XmlElementWrapper(name = "keys")
@XmlElement
public void setKey(Set<Key> key) {this.key = key;
}

生成如下结构：
在这里插入图片描述

6. @XmlAccessorOrder(类级别)

用于对java对象生成的xml元素进行排序。它有两个属性值：
AccessorOrder.ALPHABETICAL：对生成的xml元素按字母书序排序。
XmlAccessOrder.UNDEFINED:不排序。

7. @XmlJavaTypeAdaptor

标识一个接口类型的属性，返回Address接口的一个具体实现类的对象。
应用场景，如日期格式指定。

8. @XmlTransient（指定为瞬时态字段）

用于标示在由Java对象映射XML时，忽略此属性，在生成的XML文件中将不出现此元素。

9. @XmlAccessorType(类级别)

控制默认情况下是否对字段或 Javabean 属性进行系列化。
默认情况下，如果包中不存在@XmlAccessorType，那么假定使用以下包级别注释。
@XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)

默认情况下，如果类中不存在 @XmlAccessorType注解，并且没有任何超类是使用 @XmlAccessorType
注释的，则假定在类中使用以下默认注释： @XmlAccessorType(XmlAccessType.PUBLIC_MEMBER)
可能值：
FIELD: 绑定类中的（没有get方法/set方法的属性也可以）非静态、非瞬态字段将会自动绑定映射到 XML，除非由
XmlTransient 注释。
NONE: 所有字段或属性都不能绑定到 XML，除非使用一些 JAXB 注释专门对它们进行注释。
PROPERTY: 绑定类中的（只有有get方法/set方法的属性才可以）自动绑定映射到 XML，除非由 XmlTransient
注释。
PUBLIC_MEMBER:每个公共获取方法/设置方法对和每个公共字段将会自动绑定到 XML，除非由 XmlTransient
注释。