WSDL - 示例


下面给出了一个 WSDL 文件,用于演示简单的 WSDL 程序。

让我们假设该服务提供一个公开可用的函数,称为sayHello。该函数需要一个字符串参数并返回一个字符串问候语。例如,如果您传递参数world,则服务函数sayHello将返回问候语“Hello, world!”。

例子

HelloService.wsdl 文件的内容 -

<definitions name = "HelloService"
   targetNamespace = "http://www.examples.com/wsdl/HelloService.wsdl"
   xmlns = "http://schemas.xmlsoap.org/wsdl/"
   xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"
   xmlns:tns = "http://www.examples.com/wsdl/HelloService.wsdl"
   xmlns:xsd = "http://www.w3.org/2001/XMLSchema">
 
   <message name = "SayHelloRequest">
      <part name = "firstName" type = "xsd:string"/>
   </message>
	
   <message name = "SayHelloResponse">
      <part name = "greeting" type = "xsd:string"/>
   </message>

   <portType name = "Hello_PortType">
      <operation name = "sayHello">
         <input message = "tns:SayHelloRequest"/>
         <output message = "tns:SayHelloResponse"/>
      </operation>
   </portType>

   <binding name = "Hello_Binding" type = "tns:Hello_PortType">
      <soap:binding style = "rpc"
         transport = "http://schemas.xmlsoap.org/soap/http"/>
      <operation name = "sayHello">
         <soap:operation soapAction = "sayHello"/>
         <input>
            <soap:body
               encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
               namespace = "urn:examples:helloservice"
               use = "encoded"/>
         </input>
		
         <output>
            <soap:body
               encodingStyle = "http://schemas.xmlsoap.org/soap/encoding/"
               namespace = "urn:examples:helloservice"
               use = "encoded"/>
         </output>
      </operation>
   </binding>

   <service name = "Hello_Service">
      <documentation>WSDL File for HelloService</documentation>
      <port binding = "tns:Hello_Binding" name = "Hello_Port">
         <soap:address
            location = "http://www.examples.com/SayHello/" />
      </port>
   </service>
</definitions>

实例分析

  • 定义- HelloService

  • 类型- 使用内置数据类型,它们在 XMLSchema 中定义。

  • 消息-

    • sayHelloRequest - 名字参数

    • sayHelloresponse - 问候语返回值

  • 端口类型- sayHello 操作由请求和响应服务组成。

  • 绑定- 使用 SOAP HTTP 传输协议的方向。

  • 服务- 服务可在 http://www.examples.com/SayHello/ 获得

  • 端口- 将绑定与可以访问正在运行的服务的 URI http://www.examples.com/SayHello/ 相关联。