@XmlAttribute用于将Java字段或getter方法映射为XML元素的属性，支持name、required、defaultValue参数，适用于简单类型，不可用于复杂对象，常与@XmlElement配合使用以区分属性与子元素。
@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免费学习笔记（深入）”；
@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;
}
- 字段本身不加注解，只在 getter 加，JAXB 仍能识别并处理
- 适合需要逻辑计算、空值转换等场景（比如 getter 返回格式化后的字符串）
- 注意：不要 getter 和字段同时加，否则可能冲突或被忽略
基本上就这些。用对地方，XML 结构更清晰，和外部系统对接也更顺。
