Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

34.4. リスト

概要
リンクのコピー

XML スキーマは、スペースで区切られた単純型のリストであるデータ型を定義するためのメカニズムをサポートしています。リスト型を使用した primeList の例は、例34.7「リストタイプの例」 に記載されています。

例34.7 リストタイプの例

<primeList>1 3 5 7 9 11 13<\primeList>
Copy to Clipboard Toggle word wrap

XML Schema リストタイプは通常 Java List<T> オブジェクトにマッピングされます。このパターンの唯一のバリエーションは、メッセージ部分が XML スキーマリストタイプのインスタンスに直接マップされる場合です。

XML スキーマでのリストタイプの定義
リンクのコピー

XML スキーマのリスト型は単純型で、simpleType 要素を使用して定義されます。リストタイプを定義するために使用される最も一般的な構文を 例34.8「XML スキーマリストタイプの構文」 に示します。

例34.8 XML スキーマリストタイプの構文

<simpleType name="listType">
  <list itemType="atomicType">
    <facet value="value" />
    <facet value="value" />
    ...
  </list>
</simpleType>
Copy to Clipboard Toggle word wrap

atomType に指定された値は、リスト内の要素のタイプを定義します。指定できるのは、xsd:int または xsd:string などの組み込み XML スキーマアトミック型のいずれか、リストではないユーザー定義の単純型だけです。

リストタイプにリストされている要素のタイプを定義することに加えて、ファセットを使用してリストタイプのプロパティーをさらに制約することもできます。表34.3「リストタイプファセット」 リストタイプで使用されるファセットを示します。

Expand
表34.3 リストタイプファセット
ファセット結果

長さ

リストタイプのインスタンスの要素数を定義します。

minLength

リストタイプのインスタンスで許可される要素の最小数を定義します。

maxLength

リストタイプのインスタンスで許可される要素の最大数を定義します。

enumeration

リストタイプのインスタンスの要素の許容値を定義します。

pattern

リストタイプのインスタンスの要素の字句形式を定義します。パターンは正規表現を使用して定義されます。

たとえば、例34.7「リストタイプの例」 に示される simpleList 要素の定義を、例34.9「リストタイプの定義」 に示します。

例34.9 リストタイプの定義

<simpleType name="primeListType">
  <list itemType="int"/>
</simpleType>
<element name="primeList" type="primeListType"/>
Copy to Clipboard Toggle word wrap

例34.8「XML スキーマリストタイプの構文」 に示す構文に加えて 例34.10「リストタイプの代替構文」 に示すあまり一般的でない構文を使用してリストタイプを定義することもできます。

例34.10 リストタイプの代替構文

<simpleType name="listType">
  <list>
    <simpleType>
      <restriction base="atomicType">
        <facet value="value"/>
        <facet value="value"/>
        ...
      </restriction>
    </simpleType>
  </list>
  </simpleType>
Copy to Clipboard Toggle word wrap

リストタイプ要素の Java へのマッピング
リンクのコピー

要素がリストタイプとして定義されている場合、リストタイプはコレクションプロパティーにマップされます。collection プロパティーは Java List<T> オブジェクトです。List<T> が使用するテンプレートクラスは、リストのベースタイプからマッピングされたラッパークラスです。たとえば、例34.9「リストタイプの定義」 で定義されたリストタイプは List<Integer> にマッピングされます。

ラッパータイプマッピングの詳細については、「ラッパークラス」 を参照してください。

リストタイプパラメーターの Java へのマッピング
リンクのコピー

メッセージ部分がリストタイプとして定義されている場合や、リストタイプの要素にマップされる場合、作成されるメソッドパラメーターは List<T> オブジェクトではなくアレイにマッピングされます。配列の基本型は、リスト型の基本クラスのラッパークラスです。

たとえば、例34.11「リストタイプのメッセージ部分を持つ WSDL」 の WSDL フラグメントは結果は、例34.12「リスト型パラメーターを使用した Java メソッド」 に示すメソッドシグネチャーになります。

例34.11 リストタイプのメッセージ部分を持つ WSDL

<definitions ...>
  ...
  <types ...>
    <schema ... >
      <simpleType name="primeListType">
        <list itemType="int"/>
      </simpleType>
      <element name="primeList" type="primeListType"/>
    </schemas>
  </types>
  <message name="numRequest"> <part name="inputData" element="xsd1:primeList" /> </message>
  <message name="numResponse">;
    <part name="outputData" type="xsd:int">
  ...
  <portType name="numberService">
    <operation name="primeProcessor">
      <input name="numRequest" message="tns:numRequest" />
      <output name="numResponse" message="tns:numResponse" />
    </operation>
    ...
  </portType>
  ...
</definitions>
Copy to Clipboard Toggle word wrap

例34.12 リスト型パラメーターを使用した Java メソッド

public interface NumberService {

    @XmlList
    @WebResult(name = "outputData", targetNamespace = "", partName = "outputData")
    @WebMethod
    public int primeProcessor(
        @WebParam(partName = "inputData", name = "primeList", targetNamespace = "...") java.lang.Integer[] inputData
    );
}
Copy to Clipboard Toggle word wrap
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat