-
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>