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 {@XmlValuepublic 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 {@XmlValuepublic String value;@XmlAttributepublic 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>