WebService中的WSDL详解
一．WSDL的基本概念
二．WSDL的基本结构详解
下面通过一份wsdl文档，来详细解读WSDL结构：
-
xml version="1.0" encoding="UTF-8" ?>
-
<wsdl:definitions
-
targetNamespace
=
"http://com.liuxiang.xfireDemo/HelloService"
-
xmlns:tns
=
"http://com.liuxiang.xfireDemo/HelloService"
-
xmlns:wsdlsoap
=
"http://schemas.xmlsoap.org/wsdl/soap/"
-
xmlns:soap12
=
"http://www.w3.org/2003/05/soap-envelope"
-
xmlns:xsd
=
"http://www.w3.org/2001/XMLSchema"
-
xmlns:soapenc11
=
"http://schemas.xmlsoap.org/soap/encoding/"
-
xmlns:soapenc12
=
"http://www.w3.org/2003/05/soap-encoding"
-
xmlns:soap11
=
"http://schemas.xmlsoap.org/soap/envelope/"
-
xmlns:wsdl
=
"http://schemas.xmlsoap.org/wsdl/"
>
-
<wsdl:types>
-
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-
attributeFormDefault
=
"qualified"
elementFormDefault
=
"qualified"
-
targetNamespace
=
"http://com.liuxiang.xfireDemo/HelloService"
>
-
<xsd:element name="sayHello">
-
<xsd:complexType>
-
<xsd:sequence>
-
<xsd:element maxOccurs= name="sayHelloRequest">
-
<wsdl:part name="parameters" element="tns:sayHello" />
-
wsdl:message>
-
<wsdl:portType name="HelloServicePortType">
-
<wsdl:operation name="sayHello">
-
<wsdl:input name="sayHelloRequest"
-
message
=
"tns:sayHelloRequest"
/>
-
<wsdl:output name="sayHelloResponse"
-
message
=
"tns:sayHelloResponse"
/>
-
wsdl:operation>
-
wsdl:portType>
-
<wsdl:binding name="HelloServiceHttpBinding"
-
type
=
"tns:HelloServicePortType"
>
-
一：WSDL定义
WSDL是一个用于精确描述Web服务的文档，WSDL文档是一个遵循WSDL XML模式的XML文档。WSDL 文档将Web服务定义为服务访问点或端口的集合。在 WSDL 中，由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来，因此可以对抽象定义进行再次使用：消息，指对交换数据的抽象描述；而端口类型，指操作的抽象集合。用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。将Web访问地址与可再次使用的绑定相关联，可以定义一个端口，而端口的集合则定义为服务。
一个WSDL文档通常包含7个重要的元素，即types、import、message、portType、operation、binding、service元素。这些元素嵌套在definitions元素中，definitions是WSDL文档的根元素。文章的下一部分将会详细介绍WSDL的基本结构。
二：WSDL的基本结构–概述
- Types – 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。
- Message – 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
- Operation – 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。
- PortType – 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
- Binding – 特定端口类型的具体协议和数据格式规范的绑定。
- Port – 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
- Service- 相关服务访问点的集合。
三：WSDL的基本结构–详述
本节将通过一个例子详细描述WSDL文档每个元素的作用。下面一个例子是一个简单的WSDL文档的内容，该文档的产生可以参见我的另外一篇文章：xfire开发实例–HelloWorld篇 (http://blog.csdn.net/juxtapose/archive/2007/09/10/1779849.aspx)。
一个简单的Web Service的WSDL文档，该服务支持名为sayHello的唯一操作，该操作通过在http上运行SOAP协议来实现的。该请求接受一个字符串name，经过处理后返回一个简单的字符串。文档如下：
<wsdl:definitions targetNamespace="http://com.liuxiang.xfireDemo/HelloService" xmlns:tns="http://com.liuxiang.xfireDemo/HelloService" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> <wsdl:types> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://com.liuxiang.xfireDemo/HelloService"> <xsd:element name="sayHello"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="1" name="name" nillable="true" type="xsd:string" />
xsd:sequence>
xsd:complexType>
xsd:element> <xsd:element name="sayHelloResponse"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string" />
xsd:sequence>
xsd:complexType>
xsd:element>
xsd:schema>
wsdl:types> <wsdl:message name="sayHelloResponse"> <wsdl:part name="parameters" element="tns:sayHelloResponse" />
wsdl:message> <wsdl:message name="sayHelloRequest"> <wsdl:part name="parameters" element="tns:sayHello" />
wsdl:message> <wsdl:portType name="HelloServicePortType"> <wsdl:operation name="sayHello"> <wsdl:input name="sayHelloRequest" message="tns:sayHelloRequest" /> <wsdl:output name="sayHelloResponse" message="tns:sayHelloResponse" />
wsdl:operation>
wsdl:portType> <wsdl:binding name="HelloServiceHttpBinding" type="tns:HelloServicePortType"> <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="sayHello"> <wsdlsoap:operation soapAction="" /> <wsdl:input name="sayHelloRequest"> <wsdlsoap:body use="literal" />
wsdl:input> <wsdl:output name="sayHelloResponse"> <wsdlsoap:body use="literal" />
wsdl:output>
wsdl:operation>
wsdl:binding> <wsdl:service name="HelloService"> <wsdl:port name="HelloServiceHttpPort" binding="tns:HelloServiceHttpBinding"> <wsdlsoap:address location="http://localhost:8080/xfire/services/HelloService" />
wsdl:port>
wsdl:service>
wsdl:definitions>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
types元素使用XML模式语言声明在WSDL文档中的其他位置使用的复杂数据类型与元素；
import元素类似于XML模式文档中的import元素，用于从其他WSDL文档中导入WSDL定义；
message元素使用在WSDL文档的type元素中定义或在import元素引用的外部WSDL文档中定义的XML模式的内置类型、复杂类型或元素描述了消息的有效负载；
portType元素和operation元素描述了Web服务的接口并定义了他的方法。portType元素和operation元素类似于java接口和接口中定义的方法声明。operation元素使用一个或者多个message类型来定义他的输入和输出的有效负载；
<wsdl:definitions targetNamespace="http://com.liuxiang.xfireDemo/HelloService" xmlns:tns="http://com.liuxiang.xfireDemo/HelloService" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
wsdl:definitions>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
2、types元素
WSDL采用了W3C XML模式内置类型作为其基本类型系统。types元素用作一个容器，用于定义XML模式内置类型中没有描述的各种数据类型。当声明消息部分的有效负载时，消息定义使用了在types元素中定义的数据类型和元素。在本文的WSDL文档中的types定义：
<wsdl:types> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://com.liuxiang.xfireDemo/HelloService"> <xsd:element name="sayHello"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="1" name="name" nillable="true" type="xsd:string" />
xsd:sequence>
xsd:complexType>
xsd:element> <xsd:element name="sayHelloResponse"> <xsd:complexType> <xsd:sequence> <xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string" />
xsd:sequence>
xsd:complexType>
xsd:element>
xsd:schema>
wsdl:types>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
<wsdl:message name="sayHelloResponse"> <wsdl:part name="parameters" element="tns:sayHelloResponse" />
wsdl:message> <wsdl:message name="sayHelloRequest"> <wsdl:part name="parameters" element="tns:sayHello" />
wsdl:message>
- 1
- 2
- 3
- 4
- 5
- 6
<wsdl:portType name="HelloServicePortType"> <wsdl:operation name="sayHello"> <wsdl:input name="sayHelloRequest" message="tns:sayHelloRequest" /> <wsdl:output name="sayHelloResponse" message="tns:sayHelloResponse" />
wsdl:operation>
wsdl:portType>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
<wsdl:binding name="HelloServiceHttpBinding" type="tns:HelloServicePortType"> <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="sayHello"> <wsdlsoap:operation soapAction="" /> <wsdl:input name="sayHelloRequest"> <wsdlsoap:body use="literal" />
wsdl:input> <wsdl:output name="sayHelloResponse"> <wsdlsoap:body use="literal" />
wsdl:output>
wsdl:operation>
wsdl:binding>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
<wsdl:service name="HelloService"> <wsdl:port name="HelloServiceHttpPort" binding="tns:HelloServiceHttpBinding"> <wsdlsoap:address location="http://localhost:8080/xfire/services/HelloService" />
wsdl:port>
wsdl:service>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
这部分是具体的Web服务的定义，在这个名为HelloService的Web服务中，提供了一个服务访问入口，访问地址是http://localhost:8080/xfire/services/HelloService，使用的消息模式是由前面的binding所定义的。
="hljs-tag"><wsdlsoap:binding style="document"
transport
=
"http://schemas.xmlsoap.org/soap/http"
/>
<wsdl:operation name="sayHello">
<wsdlsoap:operation soapAction="" />
<wsdl:input name="sayHelloRequest">
<wsdlsoap:body use="literal" />
wsdl:input>
<wsdl:output name="sayHelloResponse">
<wsdlsoap:body use="literal" />
wsdl:output>
wsdl:operation>
wsdl:binding>
<wsdl:service name="HelloService">
<wsdl:port name="HelloServiceHttpPort"
binding
=
"tns:HelloServiceHttpBinding"
>
<wsdlsoap:address
location
=
"http://localhost:8080/xfire/services/HelloService"
/>
wsdl:port>
wsdl:service>
wsdl:definitions>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
所有的WSDL文档的根元素均是definitions元素。该元素封装了整个文档，同时通过其name提供了一个WSDL文档。除了提供一个命名空间（targetNamespace）外，该元素没有其他作用，故不作详细描述。
（二）types元素
WSDL采用了W3C XML模式内置类型作为其基本类型系统。types元素用作一个容器，用于定义XML模式内置类型中没有描述的各种数据类型（不太明白：XML模式内置类型中没有描述的各种数据类型）。当声明消息部分的有效时，消息定义使用了在types元素中定义的数据类型和元素。在本文的WSDL文档中的types定义：
-
<wsdl:types>
-
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-
attributeFormDefault
=
"qualified"
elementFormDefault
=
"qualified"
-
targetNamespace
=
"http://com.liuxiang.xfireDemo/HelloService"
>
-
<xsd:element name="sayHello">
-
<xsd:complexType>
-
<xsd:sequence>
-
<xsd:element maxOccurs="1" minOccurs="1"
-
name
=
"name"
nillable
=
"true"
type
=
"xsd:string"
/>
-
xsd:sequence>
-
xsd:complexType>
-
xsd:element>
-
<xsd:element name="sayHelloResponse">
-
<xsd:complexType>
-
<xsd:sequence>
-
<xsd:element maxOccurs="1" minOccurs="0"
-
name
=
"return"
nillable
=
"true"
type
=
"xsd:string"
/>
-
xsd:sequence>
-
xsd:complexType>
-
xsd:element>
-
xsd:schema>
-
wsdl:types>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
（三）import元素
<wsdl:import namespace="http://xxx.xxx.xxx/xxx/xxx" location="http://xxx.xxx.xxx/xxx/xxx.wsdl"/>
- 1
- 1
（四）message元素
message元素描述了Web服务使用消息的有效负载。message元素可以描述输出或者接受消息的有效负载；还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。在本文中的message元素的定义，本文档使用了采用文档样式的消息传递：
-
<wsdl:message name="sayHelloResponse">
-
<wsdl:part name="parameters" element="tns:sayHelloResponse" />
-
wsdl:message>
-
<wsdl:message name="sayHelloRequest">
-
<wsdl:part name="parameters" element="tns:sayHello" />
-
wsdl:message>
- 1
- 2
- 3
- 4
- 5
- 6
- 1
- 2
- 3
- 4
- 5
- 6
该部分是消息格式的抽象定义：定义了两个消息sayHelloResponse和sayHelloRequest：
1.sayHelloRequest：
sayHello操作的请求消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；
2.sayHelloResponse：
（五）portType元素
portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口，都是定义了一个抽象类型和方法，没有定义实现。在WSDL中，portType元素是由binding和service元素来实现的，这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及Internet地址。
一个portType中可以定义多个operation，一个operation可以看作是一个方法，本文中WSDL文档的定义：
-
<wsdl:portType name="HelloServicePortType">
-
<wsdl:operation name="sayHello">
-
<wsdl:input name="sayHelloRequest"
-
message
=
"tns:sayHelloRequest"
/>
-
<wsdl:output name="sayHelloResponse"
-
message
=
"tns:sayHelloResponse"
/>
-
wsdl:operation>
-
wsdl:portType>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
（六）binding
binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用，本文中的例子：
-
<wsdl:binding name="HelloServiceHttpBinding"
-
type
=
"tns:HelloServicePortType"
>
-
<wsdlsoap:binding style="document"
-
transport
=
"http://schemas.xmlsoap.org/soap/http"
/>
-
<wsdl:operation name="sayHello">
-
<wsdlsoap:operation soapAction="" />
-
<wsdl:input name="sayHelloRequest">
-
<wsdlsoap:body use="literal" />
-
wsdl:input>
-
<wsdl:output name="sayHelloResponse">
-
<wsdlsoap:body use="literal" />
-
wsdl:output>
-
wsdl:operation>
-
wsdl:binding>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
（七）service元素和port元素
service元素包含一个或者多个port元素，其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding，甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。文档中的例子：
-
<wsdl:service name="HelloService">
-
<wsdl:port name="HelloServiceHttpPort"
-
binding
=
"tns:HelloServiceHttpBinding"
>
-
<wsdlsoap:address
-
location
=
"http://localhost:8080/xfire/services/HelloService"
/>
-
wsdl:port>
-
wsdl:service>
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 1
- 2
- 3
- 4
- 5
- 6
- 7
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/211604.html原文链接：https://javaforall.net
![SpringBoot+Mybatis实现分页查询[通俗易懂]](https://javaforall.net/wp-content/uploads/2020/11/2020110817443450-480x300.jpg)
