Java JAXB的@XmlAttribute注解怎么用-XML/RSS教程-PHP中文网

Java JAXB的@XmlAttribute注解怎么用

煙雲

发布： 2025-12-14 10:03:58

原创

495人浏览过

@XmlAttribute用于将Java字段或getter方法映射为XML元素的属性，支持name、required、defaultValue参数，适用于简单类型，不可用于复杂对象，常与@XmlElement配合使用以区分属性与子元素。

java jaxb的@xmlattribute注解怎么用

@XmlAttribute 用来把 Java 字段或属性映射为 XML 元素的属性（attribute），而不是子元素（element）。它必须用在类的字段或 getter 方法上，且该字段类型需支持 XML Schema 简单类型（如 String、int、boolean、Date 等）。

基本用法：标记字段生成 XML 属性

直接在字段上加 @XmlAttribute，JAXB 序列化时会把这个字段作为所在 XML 元素的属性输出。

@XmlRootElement
public class User {
    @XmlAttribute
    private String id;

    @XmlAttribute(name = "user-name")
    private String name;

    private String email;

    // 构造函数、getter/setter 省略
}

登录后复制

序列化结果示例：

<user id="123" user-name="Alice">
  <email>alice@example.com</email>
</user>

登录后复制

默认 name：不写 name 属性时，XML 属性名默认为字段名（如 id）
自定义 name：用 name = "xxx" 指定 XML 中显示的属性名（如 user-name）
不能用于复杂对象：字段类型不能是自定义类（比如不能是 Address address），否则 JAXB 报错

配合 @XmlElement 使用，区分属性和子元素

同一个类里可以同时用 @XmlAttribute 和 @XmlElement，让一部分数据当属性、一部分当子元素，符合常见 XML 设计习惯。

立即学习“Java免费学习笔记（深入）”；

Flex3组件和框架的生命周期中文WORD版

在整本书中我们所涉及许多的Flex框架源码，但为了简洁，我们不总是显示所指的代码。当你阅读这本书时，要求你打开Flex Builder，或能够访问Flex3框架的源码，跟随着我们所讨论源码是怎么工作及为什么这样做。如果你跟着阅读源码，请注意，我们经常跳过功能或者具体的代码，以便我们可以对应当前的主题。这样能防止我们远离当前的主题，主要是讲解代码的微妙之处。这并不是说那些代码的作用不重要，而是那些代码处理特别的案例，防止潜在的错误或在生命周期的后面来处理，只是我们当前没有讨论它。有需要的朋友可以下载看看

查看详情

@XmlRootElement
public class Order {
    @XmlAttribute
    private String orderId;

    @XmlAttribute
    private String status;

    @XmlElement
    private String description;

    @XmlElement
    private List<Item> items;
}

登录后复制

生成的 XML 类似：

<order orderId="ORD-001" status="shipped">
  <description>Laptop order</description>
  <items>
    <item>...</item>
  </items>
</order>

登录后复制

业务主键、状态码、枚举标识等适合用 @XmlAttribute
长文本、嵌套结构、可重复内容适合用 @XmlElement
JAXB 默认把所有 public 字段/属性都当作 <element></element>，加注解才能改变行为

注意 required 和 defaultValue

@XmlAttribute 支持两个实用参数：

required = true/false：控制该属性是否必须存在（反序列化时校验，true 且 XML 缺失会报 UnmarshalException）
defaultValue = "xxx"：仅影响生成的 XSD（如果用 JAXBContext.generateSchema()），不影响 Java 对象默认值或序列化行为

@XmlAttribute(required = true)
private String version;

@XmlAttribute(defaultValue = "1.0")
private String schemaVersion; // 仅生成 XSD 时体现

登录后复制

用在 getter 方法上也有效（推荐封装场景）

如果你把字段设为 private，并只暴露 getter/setter，可以把 @XmlAttribute 加在 getter 上，效果一样：

private String code;

@XmlAttribute(name = "code")
public String getCode() {
    return code;
}

public void setCode(String code) {
    this.code = code;
}

登录后复制