程序员人生 网站导航

WebService中WSDL文件详解

栏目:互联网时间:2015-05-19 08:31:52

WSDL(Web Service Description Language)Web服务描写语言

################################################################################

适用于描写WebService的文档格式


下面例子是为了输入1个字符串name,返回1个SayHello的操作。


<?xml version="1.0" encoding="UTF⑻" ?>
<wsdl:definitions
    
targetNamespace="http://com.liuxiang.xfireDemo/HelloService"-------------------DEFINITIONS:WSDL文档根元素,提供命名空间
    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>-------------------------------------------------------------------------------------TYPE:数据类型定义的容器,TYPE定义了两个元
        
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 素,1个是sayHello,1个是sayHelloResp
            attributeFormDefault
="qualified" elementFormDefault="qualified" onse。
            targetNamespace
="http://com.liuxiang.xfireDemo/HelloService">
            
<xsd:element name="sayHello">----------------------------------------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">---------------------------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">----------------------------------------------MESSAGE:通讯消息的数据结构的抽象化定义,描
        
<wsdl:part name="parameters" element="tns:sayHelloResponse" />                                         述了Web服务使用消息的有效负载,
    
</wsdl:message>     还可描写输出或接受消息的有效负载
    
<wsdl:message name="sayHelloRequest">     ,其中ELEMENT对应TYPE中的NAME。定义元
        
<wsdl:part name="parameters" element="tns:sayHello" />      素的方式取决于使用RPC样式或文档样式,此处
    
</wsdl:message>     为文档样式

    <wsdl:portType name="HelloServicePortType">------------------------------------------PORTTYPE:对某个访问入口点类型所支持的操
        
<wsdl:operation name="sayHello">                                                                                              的抽象集合,1个portType可定义多
            
<wsdl:input name="sayHelloRequest"      个operation,1个operation可看作1
                message
="tns:sayHelloRequest" />      个方法,要求消息是MESSAGE定义的
            
<wsdl:output name="sayHelloResponse"      sayHelloRequest,相应消息是
                message
="tns:sayHelloResponse" />      sayHelloResponse,同时包括input
        
</wsdl:operation>      /output表明这是1个要求/响应模式,
    
</wsdl:portType>      input表示传递到Web服务的有效负

      载,output表示传递到客户的有效负       载.此处TNS为DEFINITIONS中所声       明。
   
 <wsdl:binding name="HelloServiceHttpBinding"--------------------------------------------BINDING:特定端口类型的具体协议和数据格式规
        type
="tns:HelloServicePortType">     范的绑定,binding将1个抽象porType映
        
<wsdlsoap:binding style="document" 射到1组具体协议(SOAP/HTTP),消息传
            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">----------------------------------------------------------SERVICE:相干服务访问点的集合,1个service元
        
<wsdl:port name="HelloServiceHttpPort"     素包括多个不同的port,每一个port表示
            binding
="tns:HelloServiceHttpBinding">     不同的Web服务,此例子中提供给访
            
<wsdlsoap:address     问你的地址为:http://localhost:8080/xf.
                
location="http://localhost:8080/xfire/services/HelloService" />      .....
        
</wsdl:port>
    
</wsdl:service>
</wsdl:definitions>


IMPORT:可让当前WSDL文档中援用其他WSDL文档中指定命名空间中的元素,通经常使用于WSDL模块化。

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

namespace属性:必须与所导入文件的targetNameSpace名称相同.

        location属性:指向wsdl文件的路径,不能为空.

附WSDL文档结构图-------


以上这些就是基本的1些要点,,,如果有误,请各位大爷批评指正,,,

------分隔线----------------------------
------分隔线----------------------------

最新技术推荐