WSDL简介
WSDL,Web Services Description Language,Web Service的描述语言,是一种接口定义语言,用于描述Web Service的接口信息等。(描述Web服务和说明如何与Web服务通信的XML语言。为用户提供详细的接口说明书。)
WSDL元素
WSDL有五大元素,分别是types,message,portType,binding和service。
types:用来定义访问的类型
message:SOAP Message
portType:指明服务器的接口,并且通过operation绑定相应的in和out消息(in:参数, out:返回值)
binding:指定传递消息所使用的格式
service:指定服务所发布的名称
下方为 代码优先 生成的wsdl文件:
<?xml version="1.0" encoding="UTF-8"?>
<definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://service.zttc.org/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://service.zttc.org/" name="MyServiceImplService">
<!-- types:用来定义访问的类型 -->
<types>
<xsd:schema>
<xsd:import namespace="http://service.zttc.org/" schemaLocation="http://localhost:8887/ns?xsd=1"></xsd:import>
</xsd:schema>
</types>
<!-- message:SOAP Message,消息体 -->
<message name="minus">
<part name="parameters" element="tns:minus"></part>
</message>
<message name="minusResponse">
<part name="parameters" element="tns:minusResponse"></part>
</message>
<message name="login">
<part name="parameters" element="tns:login"></part>
</message>
<message name="loginResponse">
<part name="parameters" element="tns:loginResponse"></part>
</message>
<message name="add">
<part name="parameters" element="tns:add"></part>
</message>
<message name="addResponse">
<part name="parameters" element="tns:addResponse"></part>
</message>
<!-- portType:端口类型,指明服务器的接口 -->
<portType name="IMyService">
<!-- 并且通过operation绑定相应的in和out消息(in:参数, out:返回值)-->
<!-- operation,操作,对服务所支持的操作进行抽象描述 -->
<operation name="minus">
<input wsam:Action="http://service.zttc.org/IMyService/minusRequest" message="tns:minus"></input>
<output wsam:Action="http://service.zttc.org/IMyService/minusResponse" message="tns:minusResponse"></output>
</operation>
<operation name="login">
<input wsam:Action="http://service.zttc.org/IMyService/loginRequest" message="tns:login"></input>
<output wsam:Action="http://service.zttc.org/IMyService/loginResponse" message="tns:loginResponse"></output>
</operation>
<operation name="add">
<input wsam:Action="http://service.zttc.org/IMyService/addRequest" message="tns:add"></input>
<output wsam:Action="http://service.zttc.org/IMyService/addResponse" message="tns:addResponse"></output>
</operation>
</portType>
<!-- binding:使用的通信协议,指定传递消息所使用的格式 -->
<binding name="MyServiceImplPortBinding" type="tns:IMyService">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"></soap:binding>
<operation name="minus">
<soap:operation soapAction=""></soap:operation>
<input>
<soap:body use="literal"></soap:body>
</input>
<output>
<soap:body use="literal"></soap:body>
</output>
</operation>
<operation name="login">
<soap:operation soapAction=""></soap:operation>
<input>
<soap:body use="literal"></soap:body>
</input>
<output>
<soap:body use="literal"></soap:body>
</output>
</operation>
<operation name="add">
<soap:operation soapAction=""></soap:operation>
<input>
<soap:body use="literal"></soap:body>
</input>
<output>
<soap:body use="literal"></soap:body>
</output>
</operation>
</binding>
<!-- service:指定服务所发布的名称 -->
<service name="MyServiceImplService">
<!-- 定义为绑定和网络地址组合的单个端点 -->
<port name="MyServiceImplPort" binding="tns:MyServiceImplPortBinding">
<soap:address location="http://localhost:8887/ns"></soap:address>
</port>
</service>
</definitions>
下方为 契约优先,手动编写的wsdl文件:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="http://www.example.org/mywsdl/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
name="MyServiceImplService"
targetNamespace="http://www.example.org/mywsdl/">
<!-- types:用来定义访问的类型 -->
<wsdl:types>
<xsd:schema targetNamespace="http://www.example.org/mywsdl/">
<xsd:element name="plus" type="tns:plus" />
<xsd:element name="plusResponse" type="tns:plusResponse" />
<xsd:element name="minus" type="tns:minus" />
<xsd:element name="minusResponse" type="tns:minusResponse" />
<xsd:element name="licenseInfo" type="xsd:string" />
<xsd:complexType name="plus">
<xsd:sequence>
<xsd:element name="a" type="xsd:int" />
<xsd:element name="b" type="xsd:int" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="plusResponse">
<xsd:sequence>
<xsd:element name="plusResult" type="xsd:int" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="minus">
<xsd:sequence>
<xsd:element name="num1" type="xsd:int" />
<xsd:element name="num2" type="xsd:int" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="minusResponse">
<xsd:sequence>
<xsd:element name="minusResult" type="xsd:int" />
</xsd:sequence>
</xsd:complexType>
</xsd:schema>
</wsdl:types>
<!-- message:SOAP Message,消息体 -->
<wsdl:message name="plus">
<wsdl:part name="plus" element="tns:plus" />
</wsdl:message>
<wsdl:message name="plusResponse">
<wsdl:part name="plusResponse" element="tns:plusResponse" />
</wsdl:message>
<wsdl:message name="minus">
<wsdl:part name="minus" element="tns:minus" />
</wsdl:message>
<wsdl:message name="minusResponse">
<wsdl:part name="minusResponse" element="tns:minusResponse" />
</wsdl:message>
<wsdl:message name="licenseInfo">
<wsdl:part name="licenseInfo" element="tns:licenseInfo" />
</wsdl:message>
<!-- portType:端口类型,指明服务器的接口 -->
<wsdl:portType name="IMyService">
<!-- 并且通过operation绑定相应的in和out消息(in:参数, out:返回值)-->
<wsdl:operation name="plus">
<wsdl:input message="tns:plus" />
<wsdl:output message="tns:plusResponse" />
</wsdl:operation>
<wsdl:operation name="minus">
<wsdl:input message="tns:minus" />
<wsdl:output message="tns:minusResponse" />
</wsdl:operation>
</wsdl:portType>
<!-- binding:使用的通信协议,指定传递消息所使用的格式 -->
<wsdl:binding name="myServiceSOAP" type="tns:IMyService">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="plus">
<wsdl:input>
<soap:body use="literal"/>
<soap:header use="literal" part="licenseInfo" message="tns:licenseInfo" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="minus">
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<!-- service:指定服务所发布的名称 -->
<wsdl:service name="MyServiceImplService">
<wsdl:port binding="tns:myServiceSOAP" name="MyServiceImplPort">
<soap:address location="http://localhost:8989/ms"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>