`

WSDL 详解

 
阅读更多
WSDL 详解 http://blog.csdn.net/liguocai2005/article/details/4402350
WSDL文件详解（上）http://blog.csdn.net/sxqem/article/details/800259
WSDL文件详解（中）http://blog.csdn.net/sxqem/article/details/800292
WSDL文件详解（下）http://blog.csdn.net/sxqem/article/details/800311
WebService 之 WSDL文件 讲解 http://blog.csdn.net/tropica/article/details/3203892

从wsdl生成java代码的命令
生成客户端文件1:
wsdl2java -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21
http://localhost:9000/helloWorld?wsdl
生成客户端文件2:
wsdl2java  -d /mnt/d/vmware_shared_folder/workspace/webserviceclient/src/main/java -p com.websercices.client -frontend jaxws21 http://localhost:8080/webservice/HelloWorld?wsdl
-d参数：指定文件存放位置．
一些参数说明：
wsdl2java -ant -client -d D:/temp -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21 hello_world.wsdl
-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参数指定我们需要的命名空间：
wsdl2java -p com.neareast.test.cxf.client.WSDL2Java -frontend jaxws21 http://localhost:9000/helloWorld?wsdl

参考：
http://blog.csdn.net/tropica/article/details/3203892
http://blog.csdn.net/liguocai2005/article/details/4402350

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

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

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

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

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

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

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

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


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


portType描述一个Web服务的抽象接口：有一个IHelloService接口，它有一个operation是sayHi，sayHi有三个参数，一个输入参数，一个输出参数和一个异常参数。
输入参数name="sayHi"，它用message="ns1:sayHi"这个应用指向message元素，就是message属性是sayHi的元素，这个message元素知名了这个Input是参数类型，并使用message的子元素part，指明引用element="ns1:sayHi"，这个引用指向element元素，这个element元素跟complexType元素共同描述一个数据。
输出参数和异常参数可以类似追溯。
portType => operation => message(part) => element & complexType : 接口 => 方法 => 输入和返回信息 => 数据
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>



service对应一个接口，它下面的port表示每一个服务，它会指明这个服务地址，并指向banding协议的引用。
binding协议描述一组具体的协议（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>



http://blessed24.iteye.com/blog/767243
WSDL的基本结构--详述
本节将通过一个例子详细描述WSDL文档每个元素的作用。下面一个例子是一个简单的WSDL文档的内容，该文档的产生可以参见我的另外一篇文章：xfire开发实例--HelloWorld篇 (http://blog.csdn.net/juxtapose/archive/2007/09/10/1779849.aspx)。
一个简单的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>

♦ types元素使用XML模式语言声明在WSDL文档中的其他位置使用的复杂数据类型与元素；
♦ import元素类似于XML模式文档中的import元素，用于从其他WSDL文档中导入WSDL定义；
♦ message元素使用在WSDL文档的type元素中定义或在import元素引用的外部WSDL文档中定义的XML模式的内置类型、复杂类型或元素描述了消息的有效负载；
♦ portType元素和operation元素描述了Web服务的接口并定义了他的方法。portType元素和operation元素类似于java接口和接口中定义的方法声明。operation元素使用一个或者多个message类型来定义他的输入和输出的有效负载；
♦ Binding元素将portType元素和operation元素赋给一个特殊的协议和编码样式；
♦ service元素负责将Internet地址赋给一个具体的绑定；


1、definitions元素
所有的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>


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>

上面是数据定义部分，该部分定义了两个元素，一个是sayHello，一个是sayHelloResponse：
sayHello：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的参入传入部分；
sayHelloResponse：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的返回值；

3、import元素
import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候，该功能是非常有效果的。
import的格式如下： 
<wsdl:import namespace="http://xxx.xxx.xxx/xxx/xxx" location="http://xxx.xxx.xxx/xxx/xxx.wsdl"/>

必须有namespace属性和location属性：
namespace属性：值必须与正导入的WSDL文档中声明的targetNamespace相匹配；
location属性：必须指向一个实际的WSDL文档，并且该文档不能为空。

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

该部分是消息格式的抽象定义：定义了两个消息sayHelloResponse和sayHelloRequest：
sayHelloRequest：sayHello操作的请求消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；
sayHelloResponse：sayHello操作的响应消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；
如果采用RPC样式的消息传递，只需要将文档中的element元素应以修改为type即可。

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

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

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

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

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

这部分是具体的Web服务的定义，在这个名为HelloService的Web服务中，提供了一个服务访问入口，访问地址是http://localhost:8080/xfire/services/HelloService，使用的消息模式是由前面的binding所定义的。
分享到：
| super(WSDL_LOCATION, SERVICE, features); ...
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    wsdl详解(webservice)

    【WSDL详解(Webservice)】 Web服务描述语言（Web Services Description Language，简称WSDL）是一种基于XML的应用，主要用于描述Web服务的接口和其通信细节。WSDL文档定义了一组服务访问点，允许客户端通过这些点与...

    Web Service描述语言 WSDL 详解.pdf

    标题："Web Service描述语言 WSDL 详解.pdf" 描述："Web Service描述语言 WSDL 详解.pdf" 标签："service web wsdl" 部分内容：Web Service描述语言(WSDL)向这种WebService的提供商和用户推出了方便的协调工作的...

    Web Service描述语言 WSDL 详解

    Web Service描述语言 WSDL 详解

    WebService描述语言WSDL详解

    **WebService描述语言WSDL详解** WebService是一种基于XML的开放标准，允许不同系统通过网络进行通信和数据交换。在WebService的世界里，WSDL（Web Services Description Language）扮演着至关重要的角色，它是一种...

    wsdl详解，适用于初学

    WSDL 详解 WSDL（Web Services Description Language）是一种基于 XML 的语言，用于描述基于网络的服务。它提供了一个统一的方式来描述网络服务，使得不同的系统和平台可以互操作。 为什么使用 WSDL？ WSDL 是为了...

    CXF生成的WSDL详解

    ### CXF生成的WSDL详解 #### 一、概述 WSDL（Web Services Description Language）是一种用于描述Web服务的标准XML格式。它包含了服务提供者如何访问该服务的信息，包括服务的位置、服务可用的方法以及这些方法...

    WSDL详解.docx

    ### WSDL详解 #### 一、概述 WSDL（Web Services Description Language）是一种基于XML的语言，用于描述网络服务。它不仅定义了服务的功能性描述，还详细规定了服务的访问方式，包括消息交换模式和传输协议等。...

    WebService经典24篇网文汇总,包含axis2_Xfire搭建_WSDL详解_自动生成客户端和WSDL等.rar

    WebService经典24篇网文汇总,包含axis2_Xfire搭建_WSDL详解_自动生成客户端和WSDL等,自己找了好久的内容; 都是自己学习过程中网络的知识,找了很久,里边有一些自己的标记,如果发现chm内容是空白,注意看一下,其实是...

    Web Service描述语言 WSDL 详解.doc

    Web Service描述语言（WSDL，Web Service Description Language）是一种基于XML的规范，用于定义Web服务的接口和通信细节。WSDL文件是Web服务的核心组成部分，它允许服务提供者明确地描述服务的功能、如何访问这些...

    webservices-wsdl详解

    Web服务描述语言（WSDL，Web Services Description Language）是一种XML格式，用于定义网络服务的接口。它是构建基于SOAP（Simple Object Access Protocol）的Web服务的关键技术之一，允许开发者明确地描述服务的...

    一个完整的WSDL文档及各标签详解

    通过阅读《一个完整的WSDL文档及各标签详解.doc》这份文档，你可以更深入地了解每个标签的用途和配置方式，从而更好地理解和使用Web服务。 在学习和应用WSDL时，还需要注意版本问题，目前主要使用的是WSDL 1.1，而...

    WSDL详解中文word版最新版本

    WSDL (Web Services Description Language,Web服务描述语言)是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程...

    Web Service描述语言 WSDL 详解(转)

    **Web Service描述语言（WSDL）详解** Web Service描述语言（WSDL）是一种XML格式的规范，用于描述网络服务，特别是Web服务。WSDL文件定义了服务的位置、使用的消息协议以及如何调用这些服务。它是Web服务接口的...

Magicbox
Global site tag (gtag.js) - Google Analytics