35.3. 単純型から複雑型を導出する

概要

Apache CXF は、単純型からの複合型の派生をサポートしています。単純型には、定義上、サブ要素も属性もありません。したがって、単純型から複合型を導出する主な理由の 1 つは、単純型に属性を追加することです。

単純型から複合型を導出する方法は 2 つあります。

拡張による派生

例35.12「拡張による単純型からの複雑型の導出」に、currency 属性を追加するために、エクステンションにより xsd:decimal プリミティブ型から派生した複合型 internationalPrice の例を示します。

例35.12 拡張による単純型からの複雑型の導出

<complexType name="internationalPrice">
    <simpleContent>
        <extension base="xsd:decimal">
            <attribute name="currency" type="xsd:string"/>
        </extension>
    </simpleContent>
    </complexType>

simpleContent 要素は、新規タイプにサブ要素が含まれていないことを示します。extension 要素は、新しい型が xsd:decimal を拡張することを指定します。

制限による導出

例35.13「制限による単純型からの複雑型の導出」 は、xsd:string からの制限によって派生する複合型の idType の例を示しています。定義される型は、xsd:string の値を長さ 10 文字の値に制限します。また、タイプに属性を追加します。

例35.13 制限による単純型からの複雑型の導出

<complexType name="idType">
  <simpleContent>
    <restriction base="xsd:string">
     <length value="10" />
     <attribute name="expires" type="xsd:dateTime" />
    </restriction>
  </simpleContent>
</complexType>

例35.12「拡張による単純型からの複雑型の導出」 の場合のように、simpleContent 要素は新しい型に子が含まれていないことを示します。この例では、restriction 要素を使用して、新しいタイプで使用される可能な値を制限します。attribute 要素は、新しい型に要素を追加します。

Java へのマッピング

単純型から派生する複合型は、@XmlType アノテーションが付けられた Java クラスにマッピングされます。生成されるクラスには、複合型が派生する単純型のメンバー変数 value が含まれます。メンバー変数には @XmlValue アノテーションが付けられます。また、このクラスには getValue() メソッドと setValue() メソッドがあります。さらに、生成されたクラスには、単純型を拡張する属性ごとに、メンバー変数、および関連するゲッターメソッドとセッターメソッドがあります。

例35.14「idType Java Class」に、例35.13「制限による単純型からの複雑型の導出」で定義される idType 型に生成される Java クラスを示します。

例35.14 idType Java Class

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

    @XmlValue
    protected String value;
    @XmlAttribute
    @XmlSchemaType(name = "dateTime")
    protected XMLGregorianCalendar expires;

    public String getValue() {
        return value;
    }

    public void setValue(String value) {
        this.value = value;
    }

    public XMLGregorianCalendar getExpires() {
        return expires;
    }

    public void setExpires(XMLGregorianCalendar value) {
        this.expires = value;
    }

}