JAXB的XmlValue注解

• XmlValue注解用在Java属性、或者方法上。它可以使得映射到XML Schema中的Java类具有一个simpleContent 或者simpleType。

• 一个Java类中最多只能有一个属性被XmlValue注解。

• 如果被XmlValue注解的JavaBean属性是Java类中唯一映射到XML的成员，那么该Java类将会被映射为XML Schema中的simpleType。
  例如，下面的Java类Price 中只有成员value被映射到XML，并且使用了XmlValue注解：

package com.thb;

import jakarta.xml.bind.annotation.XmlType;
import jakarta.xml.bind.annotation.XmlValue;

@XmlType(name = "", propOrder = {"value"})
public class Price {

    @XmlValue
    public String value;
}

生成的XML Schema中，类被映射为simpleType：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:simpleType name="price">
    <xs:restriction base="xs:string"/>
  </xs:simpleType>
</xs:schema>

• 如果除了被XmlValue注解的JavaBean属性以外，Java类还有其它的属性被映射为XML中的属性，那么该Java类将会被映射为XML Schema中的complexType，并且在complexType元素下面包含一个simpleContent。
  例如，下面的Java类Price 中属性value使用了XmlValue注解，此外，属性currency使用了XmlAttribute注解（会被映射到XML中的属性）：

package com.thb;

import jakarta.xml.bind.annotation.XmlAttribute;
import jakarta.xml.bind.annotation.XmlRootElement;
import jakarta.xml.bind.annotation.XmlType;
import jakarta.xml.bind.annotation.XmlValue;

@XmlRootElement
@XmlType(name = "", propOrder = {"value", "currency"})
public class Price {

    @XmlValue
    public String value;

    @XmlAttribute
    public String currency;
}

生成的XML Schema中，类被映射为complexType，并且它下面包含一个simpleContent：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<xs:schema version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">

  <xs:element name="price">
    <xs:complexType>
      <xs:simpleContent>
        <xs:extension base="xs:string">
          <xs:attribute name="currency" type="xs:string"/>
        </xs:extension>
      </xs:simpleContent>
    </xs:complexType>
  </xs:element>
</xs:schema>

代码007普通

打赏 收藏 海报 链接