JAXB的XmlValue注解

人生乱弹 2年前 (2023) admin
10 0

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>

文章来源

版权声明:admin 发表于 2023年11月28日 am5:22。
转载请注明:JAXB的XmlValue注解 | 银库

相关文章

本站主题由 OneNav 一为主题强力驱动