WebService 的WSDL 的结构分析
2010-11-05 10:56 calm_水手 阅读(368) 评论(0) 编辑 收藏 举报WSDL服务定义为分布式提供系统文件和配方作为自动化应用通信所涉及的细节。一个WSDL文档定义端口服务或网络端点的集合。 在WSDL中,和消息的抽象定义端点是分离的具体的网络部署或数据格式绑定。 这使得重用抽象的定义:,这是抽象的数据被描述的交换, 端口类型是抽象操作 。珍藏消息的具体协议和特定端口类型的数据格式规范构成一个可重用的绑定 。港口通过关联一个可重用的绑定,网络地址A和集合定义端口的服务。定义的,因此,一个WSDL文档使用的网络服务中的元素定义如下:
- 类型 - 容器的XSD数据类型定义使用一些类型系统。
- 消息 -一个抽象的,类型化数据的定义是沟通。
- 操作 -一个抽象的服务支持而采取的行动的。
- 端口类型 ,操作的抽象集合的端点支持一个或多个。
- 绑定 -一个具体的协议和特定端口类型的数据格式规范的。
- 端口 -一个单一的端点地址定义为一个组合的绑定和网络。
- 服务 -相关的端点的集合。
它包含一系列描述某个 web service 的定义。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1: [WebService(Namespace = "http://tempuri.org/")]
2: [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
3: [System.ComponentModel.ToolboxItem(false)]
4: public class WebService2 : System.Web.Services.WebService
5: {
6: [WebMethod]
7: public bool Add(TestClass testClass,int id)
8: {
9: return true;
10: }
11: }
12:
13: public class TestClass
14: {
15: public int a;
16: public string b;
17: public DateTime c;
18: }
19:
2: [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
3: [System.ComponentModel.ToolboxItem(false)]
4: public class WebService2 : System.Web.Services.WebService
5: {
6: [WebMethod]
7: public bool Add(TestClass testClass,int id)
8: {
9: return true;
10: }
11: }
12:
13: public class TestClass
14: {
15: public int a;
16: public string b;
17: public DateTime c;
18: }
19:
一个WSDL文档通常包含有以下元素,即types、message、portType、operation、binding、 service元素。这些元素嵌套在definitions元素中。
definitions是WSDL文档的根元素,definitions还声明各命名空间。
types,数据类型定义的容器,它使用某种类型系统(一般地使用XML Schema中的类型系统)。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1: <wsdl:types>
2: <s:schema elementFormDefault="qualified" targetNamespace="http://tempuri.org/">
3: <s:element name="Add">
4: <s:complexType>
5: <s:sequence>
6: <s:element minOccurs="0" maxOccurs="1" name="testClass" type="tns:TestClass" />
7: <s:element minOccurs="1" maxOccurs="1" name="id" type="s:int" />
8: </s:sequence>
9: </s:complexType>
10: </s:element>
11: <s:complexType name="TestClass">
12: <s:sequence>
13: <s:element minOccurs="1" maxOccurs="1" name="a" type="s:int" />
14: <s:element minOccurs="0" maxOccurs="1" name="b" type="s:string" />
15: <s:element minOccurs="1" maxOccurs="1" name="c" type="s:dateTime" />
16: </s:sequence>
17: </s:complexType>
18: <s:element name="AddResponse">
19: <s:complexType>
20: <s:sequence>
21: <s:element minOccurs="1" maxOccurs="1" name="AddResult" type="s:boolean" />
22: </s:sequence>
23: </s:complexType>
24: </s:element>
25: </s:schema>
26: </wsdl:types>
2: <s:schema elementFormDefault="qualified" targetNamespace="http://tempuri.org/">
3: <s:element name="Add">
4: <s:complexType>
5: <s:sequence>
6: <s:element minOccurs="0" maxOccurs="1" name="testClass" type="tns:TestClass" />
7: <s:element minOccurs="1" maxOccurs="1" name="id" type="s:int" />
8: </s:sequence>
9: </s:complexType>
10: </s:element>
11: <s:complexType name="TestClass">
12: <s:sequence>
13: <s:element minOccurs="1" maxOccurs="1" name="a" type="s:int" />
14: <s:element minOccurs="0" maxOccurs="1" name="b" type="s:string" />
15: <s:element minOccurs="1" maxOccurs="1" name="c" type="s:dateTime" />
16: </s:sequence>
17: </s:complexType>
18: <s:element name="AddResponse">
19: <s:complexType>
20: <s:sequence>
21: <s:element minOccurs="1" maxOccurs="1" name="AddResult" type="s:boolean" />
22: </s:sequence>
23: </s:complexType>
24: </s:element>
25: </s:schema>
26: </wsdl:types>
types描述WebMethod的名称(Add),传入参数(testClass——包括对TestClass的详细描述,id),响应信息(AddResponse)。
message描述通信消息的数据结构的抽象类型化定义,使用types的描述的类型来定义整个消息的数据结构。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1: <wsdl:message name="AddSoapIn">
2: <wsdl:part name="parameters" element="tns:Add" />
3: </wsdl:message>
4: <wsdl:message name="AddSoapOut">
5: <wsdl:part name="parameters" element="tns:AddResponse" />
6: </wsdl:message>
2: <wsdl:part name="parameters" element="tns:Add" />
3: </wsdl:message>
4: <wsdl:message name="AddSoapOut">
5: <wsdl:part name="parameters" element="tns:AddResponse" />
6: </wsdl:message>
portType和operation描述服务和服务的方法。operation包括输入和输出(使用message的描述)。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1: <wsdl:portType name="WebService2Soap">
2: <wsdl:operation name="Add">
3: <wsdl:input message="tns:AddSoapIn" />
4: <wsdl:output message="tns:AddSoapOut" />
5: </wsdl:operation>
6: </wsdl:portType>
2: <wsdl:operation name="Add">
3: <wsdl:input message="tns:AddSoapIn" />
4: <wsdl:output message="tns:AddSoapOut" />
5: </wsdl:operation>
6: </wsdl:portType>
binding描述Web Services的通信协议。 <soap:binding/>描述使用SOAP协议,binding还描述Web Services的方法、输入、输出。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1: <wsdl:binding name="WebService2Soap" type="tns:WebService2Soap">
2: <soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
3: <wsdl:operation name="Add">
4: <soap:operation soapAction="http://tempuri.org/Add" style="document" />
5: <wsdl:input>
6: <soap:body use="literal" />
7: </wsdl:input>
8: <wsdl:output>
9: <soap:body use="literal" />
10: </wsdl:output>
11: </wsdl:operation>
12: </wsdl:binding>
2: <soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
3: <wsdl:operation name="Add">
4: <soap:operation soapAction="http://tempuri.org/Add" style="document" />
5: <wsdl:input>
6: <soap:body use="literal" />
7: </wsdl:input>
8: <wsdl:output>
9: <soap:body use="literal" />
10: </wsdl:output>
11: </wsdl:operation>
12: </wsdl:binding>
service描述Web Services访问点的集合。因为包括SOAP1.1和SOAP1.2的描述,所以一个方法有对应两描述。
![](https://images.cnblogs.com/OutliningIndicators/ContractedBlock.gif)
1: <wsdl:service name="WebService2">
2: <wsdl:port name="WebService2Soap" binding="tns:WebService2Soap">
3: <soap:address location="http://localhost:1552/WebService2.asmx" />
4: </wsdl:port>
5: <wsdl:port name="WebService2Soap12" binding="tns:WebService2Soap12">
6: <soap12:address location="http://localhost:1552/WebService2.asmx" />
7: </wsdl:port>
8: </wsdl:service>
2: <wsdl:port name="WebService2Soap" binding="tns:WebService2Soap">
3: <soap:address location="http://localhost:1552/WebService2.asmx" />
4: </wsdl:port>
5: <wsdl:port name="WebService2Soap12" binding="tns:WebService2Soap12">
6: <soap12:address location="http://localhost:1552/WebService2.asmx" />
7: </wsdl:port>
8: </wsdl:service>
文章参考:http://www.cnblogs.com/zhaozhan/archive/2010/11/03/1868556.html