WSDL Document Literal,其中的部件引用了XSD类型

时间:2012-06-12 11:06:00

标签: web-services soap wsdl

我一直在阅读WSDL 1.1规范,有一件事对我来说似乎很奇怪 - 除了WS-I Basic Profile之外,什么阻止我这样做:

<message name="helloRequest">
    <part name="arg1" type="xs:string" />
</message>
<message name="helloResponse">
    <part name="result" type="xs:string" />
</message>

<portType name="Port02">
    <operation name="hello">
        <input message="tns:helloRequest" name="helloRequest" />
        <output message="tns:helloResponse" name="helloResponse" />
    </operation>
</portType>

<binding name="Port02SoapBinding" type="tns:Port02">
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="hello">
        <input name="helloRequest">
            <soap:body use="literal" />
        </input>
        <output name="helloResponse">
            <soap:body use="literal" />
        </output>
    </operation>
</binding>

它是文档/文字Web服务,但是输入/输出消息包含引用XSD(简单)类型的部分,而不是全局元素。

WSDL片段并不那么可怕 - Axis1和CXF都生成肥皂体元素,这些元素的名称来源于部件名称,但WSDL 1.1, 3.5: soap:body表示:

  

如果use是literal,那么每个部分都使用element或type属性引用具体的模式定义。在第一种情况下,[...]。在第二个中,部件引用的类型成为封闭元素的模式类型(文档样式的主体或rpc样式的部分访问者元素)。

这是否意味着生成的SOAP消息(根据WSDL规范)将如下所示(SOAP主体内的文本内容)?

<SOAP-ENV:Envelope
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
    xmlns:xs="http://www.w3.org/1999/XMLSchema">
    <SOAP-ENV:Body xsi:type="xs:string">value</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

1 个答案:

答案 0 :(得分:1)

这是边缘情况 - 实际上我已经检查了所有java(axis1,axis2,cxf,jaxrpc-ri)实现的包裹String(或任何简单)类型,其中元素以part的名称命名,没有名称空间。

轴1:

private static void _initOperationDesc1(){
    org.apache.axis.description.OperationDesc oper;
    org.apache.axis.description.ParameterDesc param;
    oper = new org.apache.axis.description.OperationDesc();
    oper.setName("hello");
    param = new org.apache.axis.description.ParameterDesc(new javax.xml.namespace.QName("", "arg1"), org.apache.axis.description.ParameterDesc.IN, new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"), java.lang.String.class, false, false);
    oper.addParameter(param);
    oper.setReturnType(new javax.xml.namespace.QName("http://www.w3.org/2001/XMLSchema", "string"));
    oper.setReturnClass(java.lang.String.class);
    oper.setReturnQName(new javax.xml.namespace.QName("", "result"));
    oper.setStyle(org.apache.axis.constants.Style.DOCUMENT);
    oper.setUse(org.apache.axis.constants.Use.LITERAL);
    _operations[0] = oper;
}

JAXRPC-RI:

SOAPBlockInfo _bodyBlock = new SOAPBlockInfo(ns1_hello_arg1_QNAME);
_bodyBlock.setValue(arg1);
_bodyBlock.setSerializer(ns2_myns2_string__java_lang_String_String_Serializer);
_request.setBody(_bodyBlock);
...
private static final javax.xml.namespace.QName ns1_hello_arg1_QNAME = new QName("", "arg1");

所以你应该得到:

<SOAP-ENV:Envelope
    xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsi="http://www.w3.org/1999/XMLSchema-instance"
    xmlns:xs="http://www.w3.org/1999/XMLSchema">
    <SOAP-ENV:Body>
       <arg1>value</arg1>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

编辑:同样在WSDL 2.0中没有消息,操作输入和输出必须引用元素(或#any或#none或#other)。