34.4. 列表

概述

XML Schema 支持通过一种机制来定义数据类型，这些数据类型是以空格分隔的简单类型的空间列表。例 34.7 “列出类型示例” 中显示了一个元素 primeList。

例 34.7. 列出类型示例

<primeList>1 3 5 7 9 11 13<\primeList>

XML Schema 列表类型通常映射到 Java List<T> 对象。此模式的唯一变体是消息部分直接映射到 XML Schema 列表类型的实例。

在 XML Schema 中定义列表类型

XML Schema 列表类型是简单类型，比如使用 simpleType 元素来定义。例 34.8 “XML Schema 列表类型的语法” 中显示了用于定义列表类型的最常用语法。

例 34.8. XML Schema 列表类型的语法

<simpleType name="listType">
  <list itemType="atomicType">
    <facet value="value" />
    <facet value="value" />
    ...
  </list>
</simpleType>

为 atomicType 指定的值定义列表中的元素类型。它只能是 XML Schema atomic 类型中的一个，如 xsd:int 或 xsd:string，也可以是不是列表的用户定义的简单类型。

除了定义列表类型中列出的元素类型外，您还可以使用 facets 来进一步限制列表类型的属性。表 34.3 “列出类型 Facets” 显示列表类型所使用的问题。

表 34.3. 列出类型 Facets

facet效果

length

定义列表类型的实例中元素的数量。

minLength

定义列表类型的实例中允许的最小元素数量。

maxLength

定义列表类型实例中允许的最大元素数。

enumeration

在列表类型的实例中定义元素的允许值。

pattern

在列表类型的实例中定义元素的 lexical 形式。使用正则表达式来定义模式。

例如，例 34.7 “列出类型示例” 中显示的 简单List 元素的定义显示在 例 34.9 “列表类型的定义” 中。

例 34.9. 列表类型的定义

<simpleType name="primeListType">
  <list itemType="int"/>
</simpleType>
<element name="primeList" type="primeListType"/>

除了 例 34.8 “XML Schema 列表类型的语法” 中显示的语法外，您还可以使用 例 34.10 “列表类型的替代语法” 中显示的常见语法来定义列表类型。

例 34.10. 列表类型的替代语法

<simpleType name="listType">
  <list>
    <simpleType>
      <restriction base="atomicType">
        <facet value="value"/>
        <facet value="value"/>
        ...
      </restriction>
    </simpleType>
  </list>
  </simpleType>

将列表类型元素映射到 Java

当元素定义了列表类型时，列表类型映射到 collection 属性。collection 属性是 Java List<T> 对象。List<T> 使用的模板类是从列表的基本类型映射的打包程序类。例如，例 34.9 “列表类型的定义” 中定义的列表类型映射到 List<Integer>。

有关 wrapper 类型映射的详情，请参考 “打包程序类”一节。

将列表类型参数映射到 Java

当消息部分定义为列表类型，或映射到列表类型的元素时，生成的方法参数会映射到数组，而不是 List<T&gt; 对象。数组的基本类型是列表类型的基本类。

例如，例 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>

例 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
    );
}