首页 > 其他分享 >WSDL 详解

WSDL 详解

时间:2023-06-04 14:35:35浏览次数:39  
标签:http 定义 color 元素 详解 文档 WSDL



[color=red][b]从wsdl生成java代码的命令[/b][/color]
[b]生成客户端文件1: [/b]
[color=darkblue]wsdl2java -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21
http://localhost:9000/helloWorld?wsdl[/color] [b]生成客户端文件2: [/b]
[color=darkblue]wsdl2java -d /mnt/d/vmware_shared_folder/workspace/webserviceclient/src/main/java -p com.websercices.client -frontend jaxws21 http://localhost:8080/webservice/HelloWorld?wsdl[/color]
-d参数:指定文件存放位置.
[b]一些参数说明:[/b]
[color=darkblue]wsdl2java -ant -client -d D:/temp -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21 hello_world.wsdl[/color]
-ant 指定要生成一个ant的构建说明文档build.xml。
-client 指定要生成一个测试客户端的“起点代码”(starting point code),其中包含了端口中所有方法的测试样例代码。
-d 指定我们想要把生成的文件放到哪个目录下,默认是wsdl2Java命令所在的目录。
-p 指定生成文件的包名;默认是根据WSDL文件中的命名空间相对应。
-frontend 指定前端类型及版本;目前仅支持 JAXWS 前端,用 "jaxws21" 表明要生成JAX-WS 2.1 兼容的代码(Jre6自带的就是这个版本),使用该参数的原因请参考教程(2)。


为尽量较少以后移植的麻烦,我们可以根据注释中的提示指定-frontend参数,使用JAX-WS 2.1兼容模式重新生成所有的类,顺便用-p参数指定我们需要的命名空间:
[b]wsdl2java -p com.neareast.test.cxf.client.WSDL2Java [color=red]-frontend[/color] jaxws21 http://localhost:9000/helloWorld?wsdl[/b]


WSDL文档说明:
1、[color=red]definitions[/color]元素:所有的WSDL文档的根元素均是definitions元素。该元素封装了整个文档,同时通过其name提供了一个WSDL文档。除了提供一个命名空间外,该元素没有其他作用,故不作详细描述。definition元素的的一个属性是name,此属性不重要可以没有。

2、[color=red]types[/color]元素:types元素用作一个容器,用于定义XML模式内置类型中没有描述的各种数据类型。当声明消息部分的有效负载时,消息定义使用了在types元素中定义的数据类型和元素。它有element和complexType子元素,通过element和complexType来描述一个和多个数据类型。
Types元素用作一个容器,定义了自定义的特殊数据类型,在声明消息部分(有效负载)的时候,messages定义使用了types元素中定义的数据类型与元素。

3、[color=red]import[/color]元素:import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候,该功能是非常有效果的。
WSDL的import元素必须声明两个属性,即namespace属性和location属性。namespace属性必须和正导入的WSDL文档中声明的targetNamespace相匹配。location属性必须指向一个实际的WSDL文档。

4、[color=red]message[/color]元素:message元素描述了Web服务的有效负载。message元素可以描述输出或者接受消息的有效负载;还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。
message元素描述了Web服务的有效负载。相当于函数调用中的参数和返回值。Web Service的输入和输出参数可以是多个(一个特点),每一个输入或者输出使用part元素定义。
RPC样式必须使用type来定义类型。

RPC样式用类型来数据定义过程调用,调用中的每一个元素表示某一个类型的参数。

5、[color=red]portType[/color]元素:portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口,都是定义了一个抽象类型和方法,没有定义实现。在WSDL中,portType元素是由binding和service元素来实现的,这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及Internet地址。
PortType元素定义了Web服务的抽象接口,它可以由一个或者多个operation元素,每个operation元素定义了一个RPC样式或者文档样式的Web服务方法。

6、[color=red]binding[/color]元素:binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用。
Binding元素将一个抽象的portType映射到一组具体的协议(SOAP或者HTTP)、消息传递样式(RPC或者document)以及编码样式(literal或者SOAP encoding)。

7、[color=red]service元素和port元素[/color]:service元素包含一个或者多个port元素,其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding,甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。
Service元素包含一个或者多个Port元素。
每一个Port元素对应一个不同的Web服务,port将一个URL赋予一个特定的binding,通过location实现。
可以使两个或者多个port元素将不同的URL赋给相同的binding,例如负载平衡和容错的时候,使用这种方法。


8、[color=red]operation元素[/color]:Operation元素要用一个或者多个messages消息来定义它的输入、输出以及错误。
fault元素和fault元素包含一个强制性的name属性,表示要引用声明于对应portType中的专有错误消息。
9、[color=red]header元素[/color]显式指定了一个SOAP头文件.
10、[color=red]headerfault元素[/color]表述了Header专用的错误消息,如果有一个响应消息,必须在消息的Header元素中返回各种header的专用错误。
11、[color=red]address[/color]:将Internet地址通过location属性赋予一个SOAP绑定。


[color=red][b]portType描述一个Web服务的抽象接口[/b][/color]:有一个IHelloService接口,它有一个operation是sayHi,sayHi有三个参数,一个输入参数,一个输出参数和一个异常参数。
输入参数name="sayHi",它用message="ns1:sayHi"这个应用指向message元素,就是message属性是sayHi的元素,这个message元素知名了这个Input是参数类型,并使用message的子元素part,指明引用element="ns1:sayHi",这个引用指向element元素,这个element元素跟complexType元素共同描述一个数据。
输出参数和异常参数可以类似追溯。
[b][color=blue]portType => operation => message(part) => element & complexType : 接口 => 方法 => 输入和返回信息 => 数据[/color][/b]
http://localhost:8080/ServiceWebApp/services/Hellows?wsdl=IHelloService.wsdl

1. 一个service是一个服务,包含许多port, 一个port对应一个web服务,并确定url和binding(协议),这个url就是客户端使用的地址.
2. 一个binding(协议)对应一个portType(接口), 并对protType(接口)的负载进行说明.
binding(协议)描述一组具体的协议(SOAP或者HTTP)、消息传递样式(RPC或者document)以及编码样式(literal或者SOAP encoding)。
并指明输入,输出和异常等信息。
它的type属性type="ns1:IHelloService",是指向portType的Web服务的抽象接口
3. 一个portType(接口)对应一个java接口, 并对接口的operation(方法)进行说明,就是用于发布的java接口,它描述这个接口的输入,输出和错误等参数信息message(负载).
4. 一个message就是一个输入,输出或者错误等负载(参数),可能使用types定义的数据类型.
5. types下面使用element和complexType来定义数据类型.

一个service(服务)对应多个port(相应协议),
一个port对应一个binding(协议), 一个binding对应一个portType(接口)
一个binding对应多个operation(方法)说明
一个portType对应多个operation(方法)
================================================================

<?xml version='1.0' encoding='UTF-8'?>
<wsdl:definitions name="IHelloService" targetNamespace="http://service.com/"
	xmlns:ns1="http://service.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema">
		<!--types元素:types元素用作一个容器,用于定义XML模式内置类型中没有描述的各种数据类型。当声明消息部分的有效负载时,消息定义使用了在types元素中定义的数据类型和元素。
		它有element和complexType子元素,通过element和complexType来描述一个和多个数据类型。 
		Types元素用作一个容器,定义了自定义的特殊数据类型,在声明消息部分(有效负载)的时候,messages定义使用了types元素中定义的数据类型与元素。
		-->
	<wsdl:types>
		<xs:schema attributeFormDefault="unqualified"
			elementFormDefault="unqualified" targetNamespace="http://service.com/"
			xmlns:tns="http://service.com/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
			<!--  element和complexType子元素,通过element和complexType来描述一个和多个数据类型 -->
			<xs:element name="findUser" type="tns:findUser" />
			<xs:element name="findUserResponse" type="tns:findUserResponse" />
			<xs:element name="sayHi" type="tns:sayHi" />
			<xs:element name="sayHiResponse" type="tns:sayHiResponse" />
			<xs:element name="user" type="tns:user" />
			<!--  element和complexType子元素,通过element和complexType来描述一个和多个数据类型 -->
			<xs:complexType name="sayHi">
				<xs:sequence>
					<xs:element minOccurs="0" name="name" type="xs:string" />
				</xs:sequence>
			</xs:complexType>
			<xs:complexType name="sayHiResponse">
				<xs:sequence>
					<xs:element minOccurs="0" name="return" type="xs:string" />
				</xs:sequence>
			</xs:complexType>
			<xs:complexType name="findUser">
				<xs:sequence>
					<xs:element minOccurs="0" ref="tns:user" />
				</xs:sequence>
			</xs:complexType>
			<xs:complexType name="user">
				<xs:sequence>
					<xs:element minOccurs="0" name="email" type="xs:string" />
					<xs:element minOccurs="0" name="tel" type="xs:string" />
					<xs:element minOccurs="0" name="userName" type="xs:string" />
					<xs:element minOccurs="0" name="userPassword" type="xs:string" />
				</xs:sequence>
			</xs:complexType>
			<xs:complexType name="findUserResponse">
				<xs:sequence>
					<xs:element minOccurs="0" name="return" type="tns:user" />
				</xs:sequence>
			</xs:complexType>
			<xs:element name="Exception" type="tns:Exception" />
			<xs:complexType name="Exception">
				<xs:sequence>
					<xs:element minOccurs="0" name="message" type="xs:string" />
				</xs:sequence>
			</xs:complexType>
		</xs:schema>
	</wsdl:types>
	<!--  message元素:message元素描述了Web服务的有效负载。message元素可以描述输出或者接受消息的有效负载;
		还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。 
		message元素描述了Web服务的有效负载。相当于函数调用中的参数和返回值。
		Web Service的输入和输出参数可以是多个(一个特点),每一个输入或者输出使用part元素定义。 
		RPC样式必须使用type来定义类型。 
		RPC样式用类型来数据定义过程调用,调用中的每一个元素表示某一个类型的参数。  -->
	<wsdl:message name="findUser">
		<wsdl:part element="ns1:findUser" name="parameters">
		</wsdl:part>
	</wsdl:message>
	<wsdl:message name="findUserResponse">
		<wsdl:part element="ns1:findUserResponse" name="parameters">
		</wsdl:part>
	</wsdl:message>
	<wsdl:message name="sayHi">
		<wsdl:part element="ns1:sayHi" name="parameters">
		</wsdl:part>
	</wsdl:message>
	<wsdl:message name="Exception">
		<wsdl:part element="ns1:Exception" name="Exception">
		</wsdl:part>
	</wsdl:message>
	<wsdl:message name="sayHiResponse">
		<wsdl:part element="ns1:sayHiResponse" name="parameters">
		</wsdl:part>
	</wsdl:message>
	<!-- portType元素:portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口,都是定义了一个抽象类型和方法,没有定义实现。
		在WSDL中,portType元素是由binding和service元素来实现的,这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及Internet地址。 
		PortType元素定义了Web服务的抽象接口,它可以由一个或者多个operation元素,每个operation元素定义了一个RPC样式或者文档样式的Web服务方法。
	-->
	<wsdl:portType name="IHelloService">
		<!-- operation元素:Operation元素要用一个或者多个messages消息来定义它的输入、输出以及错误。 -->
		<wsdl:operation name="sayHi">
			<wsdl:input message="ns1:sayHi" name="sayHi">
			</wsdl:input>
			<wsdl:output message="ns1:sayHiResponse" name="sayHiResponse">
			</wsdl:output>
			<wsdl:fault message="ns1:Exception" name="Exception">
			</wsdl:fault>
		</wsdl:operation>
		<wsdl:operation name="findUser">
			<wsdl:input message="ns1:findUser" name="findUser">
			</wsdl:input>
			<wsdl:output message="ns1:findUserResponse" name="findUserResponse">
			</wsdl:output>
			<wsdl:fault message="ns1:Exception" name="Exception">
			</wsdl:fault>
		</wsdl:operation>
	</wsdl:portType>
</wsdl:definitions>




[color=red][b]service对应一个接口[/b][/color],它下面的port表示每一个服务,它会指明这个服务地址,并指向banding协议的引用。


[color=red][b]binding协议描述[/b][/color]一组具体的协议(SOAP或者HTTP)、消息传递样式(RPC或者document)以及编码样式(literal或者SOAP encoding)。并指明输入,输出和异常等信息。它的type属性type="ns1:IHelloService",是指向portType的Web服务的抽象接口


http://localhost:8080/ServiceWebApp/services/Hellows?wsdl ==========================================================================


<?xml version='1.0' encoding='UTF-8'?>
<wsdl:definitions name="HelloService" targetNamespace="http://impl.service.com/"
xmlns:ns1="http://service.com/" xmlns:ns2="http://schemas.xmlsoap.org/soap/http"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://impl.service.com/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- import元素:import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。
本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候,该功能是非常有效果的。
WSDL的import元素必须声明两个属性,即namespace属性和location属性。
namespace属性必须和正导入的WSDL文档中声明的targetNamespace相匹配。
location属性必须指向一个实际的WSDL文档。 -->
<wsdl:import
location="http://localhost:8080/ServiceWebApp/services/Hellows?wsdl=IHelloService.wsdl"
namespace="http://service.com/">
</wsdl:import>
<!-- binding元素:binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。
通常binding元素与协议专有的元素和在一起使用。
Binding元素将一个抽象的portType映射到一组具体的协议(SOAP或者HTTP)、消息传递样式(RPC或者document)以及编码样式(literal或者SOAP encoding)。
它的type属性type="ns1:IHelloService",是指向portType的Web服务的抽象接口
http://localhost:8080/ServiceWebApp/services/Hellows?wsdl
-->
<wsdl:binding name="HelloServiceSoapBinding" type="ns1:IHelloService">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="findUser">
<soap:operation soapAction="" style="document" />
<wsdl:input name="findUser">
<soap:body use="literal" />
</wsdl:input>
<wsdl:output name="findUserResponse">
<soap:body use="literal" />
</wsdl:output>
<wsdl:fault name="Exception">
<soap:fault name="Exception" use="literal" />
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sayHi">
<soap:operation soapAction="" style="document" />
<wsdl:input name="sayHi">
<soap:body use="literal" />
</wsdl:input>
<wsdl:output name="sayHiResponse">
<soap:body use="literal" />
</wsdl:output>
<wsdl:fault name="Exception">
<soap:fault name="Exception" use="literal" />
</wsdl:fault>
</wsdl:operation>
</wsdl:binding>
<!-- service元素和port元素:service元素包含一个或者多个port元素,其中每个port元素表示一个不同的Web服务。
port元素将URL赋给一个特定的binding,甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。
Service元素包含一个或者多个Port元素。
每一个Port元素对应一个不同的Web服务,port将一个URL赋予一个特定的binding,通过location实现。
可以使两个或者多个port元素将不同的URL赋给相同的binding,
例如负载平衡和容错的时候,使用这种方法。
它下面的port表示每一个服务,它会指明这个服务地址,并指向banding协议的引用。
-->
<wsdl:service name="HelloService">
<wsdl:port binding="tns:HelloServiceSoapBinding" name="HelloServiceImplPort">
<soap:address location="http://localhost:8080/ServiceWebApp/services/Hellows" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>




[url]http://blessed24.iteye.com/blog/767243[/url]


[color=red][b]WSDL的基本结构--详述[/b][/color]


本节将通过一个例子详细描述WSDL文档每个元素的作用。下面一个例子是一个简单的WSDL文档的内容,该文档的产生可以参见我的另外一篇文章


一个简单的Web Service的WSDL文档,该服务支持名为sayHello的唯一操作,该操作通过在http上运行SOAP协议来实现的。该请求接受一个字符串name,经过处理后返回一个简单的字符串。文档如下:


<?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="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>


[color=red][b]♦ types元素[/b][/color]使用XML模式语言声明在WSDL文档中的其他位置使用的复杂数据类型与元素;


[b][color=red]♦ import元素[/color][/b]类似于XML模式文档中的import元素,用于从其他WSDL文档中导入WSDL定义;


[b][color=red]♦ message元素[/color][/b]使用在WSDL文档的type元素中定义或在import元素引用的外部WSDL文档中定义的XML模式的内置类型、复杂类型或元素描述了消息的有效负载;


[color=red][b]♦ portType元素和operation元素[/b][/color]描述了Web服务的接口并定义了他的方法。portType元素和operation元素类似于java接口和接口中定义的方法声明。operation元素使用一个或者多个message类型来定义他的输入和输出的有效负载;


[b][color=red]♦ Binding元素[/color][/b]将portType元素和operation元素赋给一个特殊的协议和编码样式;


[color=red][b]♦ service元素[/b][/color]负责将Internet地址赋给一个具体的绑定;




[color=red][b]1、definitions元素[/b][/color]


所有的WSDL文档的根元素均是definitions元素。该元素封装了整个文档,同时通过其name提供了一个WSDL文档。除了提供一个命名空间外,该元素没有其他作用,故不作详细描述。


下面的代码是一个definitions元素的结构:


<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>



[color=red][b]2、types元素[/b][/color]


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>


上面是数据定义部分,该部分定义了两个元素,一个是sayHello,一个是sayHelloResponse:


sayHello:定义了一个复杂类型,仅仅包含一个简单的字符串,将来用来描述操作的参入传入部分;


sayHelloResponse:定义了一个复杂类型,仅仅包含一个简单的字符串,将来用来描述操作的返回值;



[color=red][b]3、import元素[/b][/color]


import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候,该功能是非常有效果的。


import的格式如下:


<wsdl:import namespace="http://xxx.xxx.xxx/xxx/xxx" location="http://xxx.xxx.xxx/xxx/xxx.wsdl"/>


[b]必须有namespace属性和location属性[/b]:


[b]namespace属性[/b]:值必须与正导入的WSDL文档中声明的targetNamespace相匹配;


[b]location属性[/b]:必须指向一个实际的WSDL文档,并且该文档不能为空。



[color=red][b]4、message元素[/b][/color]


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>


该部分是消息格式的抽象定义:定义了两个消息sayHelloResponse和sayHelloRequest:


sayHelloRequest:sayHello操作的请求消息格式,由一个消息片断组成,名字为parameters,元素是我们前面定义的types中的元素;


sayHelloResponse:sayHello操作的响应消息格式,由一个消息片断组成,名字为parameters,元素是我们前面定义的types中的元素;


如果采用RPC样式的消息传递,只需要将文档中的element元素应以修改为type即可。



[color=red][b]5、portType元素[/b][/color]


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>


portType定义了服务的调用模式的类型,这里包含一个操作sayHello方法,同时包含input和output表明该操作是一个请求/响应模式,请求消息是前面定义的sayHelloRequest,响应消息是前面定义的sayHelloResponse。input表示传递到Web服务的有效负载,output消息表示传递给客户的有效负载。



[b][color=red]6、binding[/color][/b]


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>


这部分将服务访问点的抽象定义与SOAP HTTP绑定,描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体SOAP调用时,应当使用的soapAction是""。


具体的使用需要参考特定协议定义的元素。



[b][color=red]7、service元素和port元素[/color][/b]


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>


这部分是具体的Web服务的定义,在这个名为HelloService的Web服务中,提供了一个服务访问入口,访问地址是http://localhost:8080/xfire/services/HelloService,使用的消息模式是由前面的binding所定义的。

标签:http,定义,color,元素,详解,文档,WSDL
From: https://blog.51cto.com/u_3871599/6410591

相关文章

  • duboo注解使用详解
    一、背景随着互联网的发展,网站应用的规模不断扩大,常规的垂直应用架构已无法应对,分布式服务架构以及流动计算架构势在必行。当越来越的的接口与实现类的增加后,duboo的xml配置会越来越多,为了防止几百几千行的代码,减少开发人员配置xml的工作量,使用duboo的注解模式,减少配置多出问题多的......
  • Java 容器详解:使用与案例
    Java容器是一套工具,用于存储数据和对象。可以与C++的STL类比。Java容器也称为JavaCollectionFramework(JCF)。除了存储对象的容器之外,还提供了一套工具类,用于处理和操作容器中的对象。总体来说,这是一个框架,它包含了Java对象容器和工具类。一、概览容器主要包括Collection......
  • 高效稳定的通用增量 Checkpoint 详解之二:性能分析评估
    作者:雷颜菲、夏瑞、俞航翔、梅源|阿里云Flink存储引擎团队摘要:我们在“Flink1.15新功能架构解析:高效稳定的通用增量Checkpoint”【1】一文介绍了通用增量Checkpoint的原理和背后的思考以及执行性能、空间放大等方面的初步测试结果。该功能在Flink1.16中经过优化,已达到生......
  • 前置知识:方法递归的算法、执行流程详解
       ......
  • upload-labs 1到21题通关详解
    第一题直接查看源码functioncheckFile(){varfile=document.getElementsByName('upload_file')[0].value;if(file==null||file==""){alert("请选择要上传的文件!");returnfalse;}//定义允许上传的文件类型varal......
  • 分布式医疗云平台(项目功能简介截图)【系统管理(科室管理、用户管理、角色管理、菜单管理
    项目功能截图1.系统管理 1.1.科室管理 1.2、用户管理1.3、角色管理 1.4、菜单管理  1.5、字典管理1.6、通知公告管理 1.7、登陆日志管理 1.8、操作日志管理 1.9、检查费用设置 1.10,挂号费用设置 项目功能截图1.系统管理 1.1.科室管理1.1.1、科室查询 1.1.2、科室添加......
  • Flink中的Window和Time详解
    Window(窗口)Flink认为批处理是流处理的一个特例,所以Flink底层引擎是一个流式引擎,在上面实现了流处理和批处理。而Window就是从流处理到批处理的一个桥梁。通常来讲,Window是一种可以把无界数据切割为有界数据块的手段例如,对流中的所有元素进行计数是不可能的,因为通......
  • Flink详解
    什么是FlinkApacheFlink是一个开源的分布式,高性能,高可用,准确的流处理框架。分布式:表示flink程序可以运行在很多台机器上,高性能:表示Flink处理性能比较高高可用:表示flink支持程序的自动重启机制。准确的:表示flink可以保证处理数据的准确性。Flink支持流处理和批处理,虽然我们......
  • Sqoop详解
    Sqoop下载及安装Sqoop目前有两大版本,Sqoop1和Sqoop2,这两个版本都是一直在维护者的,所以使用哪个版本都可以。这两个版本我都用过,还是感觉Sqoop1用起来比较方便,使用Sqoop1的时候可以将具体的命令全部都写到脚本中,这样看起来是比较清晰的,但是有一个弊端,就是在操作MySQL的时候,MySQL......
  • 树状数组详解——本质上就是空间换时间,可以解决大部分基于区间上的更新以及求和问题
     943.区间和查询-Immutable 中文 English 给一个整数数组nums,求出下标从i到j的元素和(i≤j),i跟j对应的元素也包括在内。 样例样例1输入:nums=[-2,0,3,-5,2,-1]sumRange(0,2)sumRange(2,5)sumRange(0,5)输出:1-1-3解释:sumRange(0,2)->(-2......