@XmlValue用于映射XML元素的纯文本内容，须与@XmlAttribute配合处理带属性的简单元素，且一个类中只能有一个@XmlValue字段，不能用于含子元素或多个文本字段的场景。
@XmlValue 用于将 Java 字段或属性映射为 XML 元素的**文本内容（simple content）**，即该元素**没有子元素，只有纯文本值**。它不能和 @XmlElement、@XmlAttribute 等同时作用于同一个字段（会报错），且只能用于单个字段。
适用场景：映射带属性的简单元素
当 XML 元素既有文本内容，又有属性时，@XmlValue 配合 @XmlAttribute 是标准解法。例如：
对应 Java 类写法：
public class Price {
@XmlAttribute
public String currency;
@XmlValue
public BigDecimal value;
}
注意：@XmlValue 字段必须是**唯一的内容承载字段**，且类型需支持 JAXB 序列化（如 String、int、BigDecimal 等）。
立即学习“Java免费学习笔记（深入）”；
不能用于复杂内容或多个文本字段
以下情况 @XmlValue 不适用：
- 元素包含子元素（如
John Doe @XmlElement嵌套对象 - 一个类中声明多个
@XmlValue→ 编译/运行时报错“more than one @XmlValue” - 想把文本和 CDATA 混合处理 → JAXB 默认不区分普通文本与 CDATA，需自定义
XmlAdapter
配合@XmlAccessorType控制访问策略
若字段为 private，需确保 JAXB 能访问到它。推荐显式设置访问器：
@XmlAccessorType(XmlAccessType.FIELD)
public class Price {
@XmlAttribute
private String currency;
@XmlValue
private BigDecimal value;
}
也可用 XmlAccessType.PROPERTY，此时需在 getter 上标注 @XmlValue：
@XmlAccessorType(XmlAccessType.PROPERTY)
public class Price {
private String currency;
private BigDecimal value;
@XmlAttribute
public String getCurrency() { return currency; }
public void setCurrency(String currency) { this.currency = currency; }
@XmlValue
public BigDecimal getValue() { return value; }
public void setValue(BigDecimal value) { this.value = value; }
}
常见问题提醒
- 如果字段类型是
String，JAXB 会原样序列化/反序列化，空格和换行会被保留（除非 XML 中用了xml:space="preserve"） - 反序列化时若文本为空字符串（
@XmlValue字段会设为null（对基本类型会抛异常，建议用包装类） - 不支持直接映射带命名空间前缀的文本内容；如需处理带 namespace 的简单元素，需结合
@XmlSchema或package-info.java
