第五十五章 生成的 WSDL 的详细信息 - types

第五十五章 生成的 WSDL 的详细信息 - types

在 <message> 元素之前，WSDL 包含一个 <types> 元素，该元素定义消息使用的架构。 <types> 元素包含一个或多个 <schema> 元素，这些元素定义 Web 服务及其客户端使用的元素、类型或两者。对于本主题前面显示的示例 Web 服务，此元素如下：

<types>
    <s:schema elementFormDefault="qualified" targetNamespace="https://www.mynamespace.org">
        <s:element name="Add">
            <s:complexType>
                <s:sequence>
                    <s:element minOccurs="0" name="a" type="s0:ComplexNumber"/>
                    <s:element minOccurs="0" name="b" type="s0:ComplexNumber"/>
                </s:sequence>
            </s:complexType>
        </s:element>
        <s:complexType name="ComplexNumber">
            <s:sequence>
                <s:element minOccurs="0" name="Real" type="s:double"/>
                <s:element minOccurs="0" name="Imaginary" type="s:double"/>
            </s:sequence>
        </s:complexType>
        <s:element name="AddResponse">
            <s:complexType>
                <s:sequence>
                    <s:element name="AddResult" type="s0:ComplexNumber"/>
                </s:sequence>
            </s:complexType>
        </s:element>
    </s:schema>
</types>

以下小节讨论了主要的变化：

• <types> 中的名称属性
• <types> 中命名空间的使用
• <types>部分的其他可能变体

注意:<types>部分还受到为web服务使用的所有支持XML的类定义的XML投影的影响。XML投影确定诸如名称空间使用、空处理和特殊字符处理等问题。请参阅将对象投射到XML。SoapBindingStyle和SoapBodyUse关键字影响WSDL的其他部分，这些部分又决定了<types>部分的结构。

Name Attributes

每个<schema>元素可以由元素、类型或两者组成，这取决于消息样式。每个元素或类型都有一个name属性，指定如下:

• 如果项对应于web方法，则其name属性等于该web方法的名称(例如，Add)并且不能更改。
• 如果项目对应于作为参数或返回值使用的支持XML的类，则其名称属性由该类的XML投影决定。有关详细信息，请参见将对象投影到XML。
• 如果项目对应于响应消息，默认情况下，它的name属性具有method_nameResponse的形式(例如，AddResponse)。

对于使用文档样式绑定的web方法，可以通过指定web方法的SoapMessageName关键字来覆盖它。

• 对于<schema>中的低级项，name属性是自动设置的，不能独立控制。

例如，假设我们对示例web方法进行如下编辑:

Method Add(a As ComplexNumber, b As ComplexNumber) 
As ComplexNumber [ WebMethod, SoapMessageName = MyResponseMessage]
{
    Set sum = ##class(ComplexNumber).%New()
    Set sum.Real = a.Real + b.Real
    Set sum.Imaginary = a.Imaginary + b.Imaginary

    Quit sum
}

在这种情况下，<types>部分如下所示:

<types>
    <s:schema elementFormDefault="qualified" targetNamespace="https://www.mynamespace.org">
        <s:element name="Add">
            <s:complexType>
                <s:sequence>
                    <s:element minOccurs="0" name="a" type="s0:ComplexNumber"/>
                    <s:element minOccurs="0" name="b" type="s0:ComplexNumber"/>
                </s:sequence>
            </s:complexType>
        </s:element>
        <s:complexType name="ComplexNumber">
            <s:sequence>
                <s:element minOccurs="0" name="Real" type="s:double"/>
                <s:element minOccurs="0" name="Imaginary" type="s:double"/>
            </s:sequence>
        </s:complexType>
        <s:element name="MyResponseMessage">
            <s:complexType>
                <s:sequence>
                    <s:element name="AddResult" type="s0:ComplexNumber"/>
                </s:sequence>
            </s:complexType>
        </s:element>
    </s:schema>
</types>