博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
WSDL文件详解
阅读量:5125 次
发布时间:2019-06-13

本文共 7406 字,大约阅读时间需要 24 分钟。

WSDL文件详解

 

对于WSDL的初学者来说,在学习过WSDL的官方文档后,大概有种似懂非懂的感觉。随便拿一个WSDL,单个元素拆分开来能够看懂,合起来一整个文件就看不明白了。今天我就在这里把自己学习的WSDL做一个总结,同时也希望可以帮助到大家。

一、WSDL简介

W3school 上的定义:WSDL  WSDL 指网络服务描述语言 (Web Services Description Language)WSDL 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置,以及此服务提供的操作(或方法)。其中我们可以得知几点:

1、WSDLXML文档。

2、WSDL描述了某个web service 。如何描述的呢?规定了服务的位置和该服务内有哪些方法。

这其实也可以认为是描述了某个接口,并指出了接口的位置,看到这个文档可以调用某个接口了。

   

二、WSDL文档结构

(一)WSDL 端口<portType> 

元素是最重要的 WSDL 元素。它可描述一个 web service、可被执行的操作,以及相关的消息。可以看作一个模块。

如下:

<wsdl:portType name="PAPNManagementPortType">

<wsdl:operation name="processAPNManagement">

<wsdl:input name="APNMRequest" message="tns:APNMRequest">

</wsdl:input>

<wsdl:output name="APNMResponse" message="tns:APNMResponse">

</wsdl:output>

<wsdl:fault name="FaultMessage" message="tns:FaultMessage">

</wsdl:fault>

</wsdl:operation>

</wsdl:portType>

portType 相当于一个类。

operation 相当于该类里有一个方法名,方法名为processAPNManagement,该方法里有一个输入消息,一个输出消息,一个错误消息。

WSDL 消息<message> 

元素定义一个操作的数据元素。每个消息可以传递一个或者多个参数。

(二)WSDL types<types> 

元素定义 web service 使用的数据类型。为了最大程度的平台中立性,WSDL 使用 XML Schema 语法来定义数据类型。即定义了各种参数(请求和返回的各种参数的数据类型定义)。

(三)WSDL Bindings<binding> 

元素为每个端口定义消息格式和协议细节。

binding 元素有两个属性 - name 属性和 type 属性。name 属性定义 binding 的名称,而 type 属性指向用于 binding 的端口,在这个例子中是 "tns:PAPNManagementPortType" 端口。

soap:binding 元素有两个属性 - style 属性和 transport 属性。style 属性可取值 "rpc" 或 "document"transport 属性定义了要使用的 SOAP 协议。在这个例子中我们使用 HTTP

style 属性可取值 "rpc" 或 "document"rpc是远程过程调用约定。使用文档document样式时,客户端知道应该使用 XML模式。transport 属性定义了要使用的 SOAP 协议。WSDL 规范通常描述三种绑定扩展:HTTP GET/POSTMIME 以及 SOAP version 1.1HTTP GET/POST 和 MIME 中定义的绑定扩展用来定义与标准的 Web 应用程序进行通信的需

求,这些应用程序可能返回(也可能不返回)XML 文档。在发送或返回 XML 文档时,HTTP GET/POST 绑定的扩展是隐式的文档样式。

operation 元素定义了每个端口提供的操作符。不管soap:binding元素中的声明如何,soap:operation元素可以覆盖每个操作的声明

对于每个操作,相应的 SOAP 行为都需要被定义。同时您必须如何对输入和输出进行编码。在这个例子中我们使用了 "literal"

三、如何看一个完整的WSDL文档。

首先,WSDL文档最开始应该从下往上看,这一比较容易。

例子:

<?xml version="1.0" encoding="UTF-8"?>

<!--  WSDL 端口类型  -->

<!-- 目标名称空间 目标命名空间一定是有效的,其他命名空间不一定有效。-->

<wsdl:definitions name="PAPNManagementPortType"  

targetNamespace="http://gg.ericsson.com/PAPNManagementPortType/"

xmlns:ns="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

xmlns:tns="http://gg.ericsson.com/PAPNManagementPortType/"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">

<wsdl:types>

<xs:schema attributeFormDefault="unqualified"

elementFormDefault="unqualified"

targetNamespace="http://gg.ericsson.com/PAPNManagementPortType/"

xmlns:tns="http://gg.ericsson.com/PAPNManagementPortType/"

xmlns:xs="http://www.w3.org/2001/XMLSchema">

<!-- 3.3:找到message中对应 复杂类型complexType  APNMRequest-APNMRequestType sequence 下的元素element为传入的参数和参数类型--->

<xs:element name="APNMRequest" type="tns:APNMRequest" />

<xs:element name="APNMResponse" type="tns:APNMResponse" />

<xs:element name="FaultMessage" type="tns:FaultMessage" />

<xs:complexType name="APNMRequest">

<xs:sequence>

<xs:element name="Request" type="tns:APNMRequestType" />

</xs:sequence>

</xs:complexType>

<xs:complexType name="APNMRequestType">

<xs:sequence>

<xs:element name="MSISDN" type="xs:string" />

<xs:element name="APN_Type" type="xs:string" />

<xs:element name="Transaction_Type" type="xs:string" />

<xs:element name="Request_ID" type="xs:string" />

<xs:element name="Request_Date_Time" type="xs:string" />

</xs:sequence>

</xs:complexType>

<!-- 4.3:找到tyeps节点下name属性值为APNMResponse的element节点 

其返回的类型即为APNMResponseType类型文件。该文件的结构在命名空间xmlns:tnsAPNMResponseType元素中  在此例子中,该命名空间指向本文件。即返回APNMResponseType中的三个参数,该三个参数包装在一个对象中,即返回一个对象。-->

<xs:complexType name="APNMResponse">

<xs:sequence>

<xs:element name="Request" type="tns:APNMResponseType" />

</xs:sequence>

</xs:complexType>

<xs:complexType name="APNMResponseType">

<xs:sequence>

<xs:element name="Result_Code" type="xs:string" />

<xs:element name="Result_Date_Time" type="xs:string" />

<xs:element name="Result_Description" type="xs:string" />

</xs:sequence>

</xs:complexType>

<xs:complexType name="FaultMessage">

<xs:sequence>

<xs:element minOccurs="0" name="FaultCode" type="xs:integer" />

<xs:element minOccurs="0" name="FaultMessage" type="xs:string" />

<xs:element minOccurs="0" name="FaultActor" type="xs:string" />

<xs:element minOccurs="0" name="FaultDetail" type="xs:string" />

</xs:sequence>

</xs:complexType>

</xs:schema>

</wsdl:types>

    <!-- 3.2:找出这个porttypeoperation中的input指向的message节点  -->

<!-- 4.2:找出这个porttypeoperation中的output指向的message节点 -->

<wsdl:message name="APNMResponse">

<wsdl:part name="parameters" element="tns:APNMResponse">

</wsdl:part>

</wsdl:message>

<wsdl:message name="FaultMessage">

<wsdl:part name="parameters" element="tns:FaultMessage">

</wsdl:part>

</wsdl:message>

<wsdl:message name="APNMRequest">

<wsdl:part name="parameters" element="tns:APNMRequest">

</wsdl:part>

</wsdl:message>

<!-- 第二步:确定接口中都有哪些方法以及方法的名称:processAPNManagement   一个operation节点就代表一个方法,也就是在接口中声明几个方法。-->

<!-- 第三步:确定接口中方法的参数类型,顺序  portType  PAPNManagementPortType 

    假设我要找processAPNManagement方法的参数类型和顺序;

   3.1:找出binding节点对应的porttype节点

     根据binding节点为tns:PAPNManagementPortType,找出porttype节点PAPNManagementPortType-->

 

 

     <!-- 第四步:找出这个服务类中方法的返回值类型 

    4.1:找出这个方法所在的porttype节点 PAPNManagementPortType  -->

<wsdl:portType name="PAPNManagementPortType">

<!-- 2:找出porttype中每一个operation中的inputoutput对应的message -->

<wsdl:operation name="processAPNManagement">

<wsdl:input name="APNMRequest" message="tns:APNMRequest">

</wsdl:input>

<wsdl:output name="APNMResponse" message="tns:APNMResponse">

</wsdl:output>

<wsdl:fault name="FaultMessage" message="tns:FaultMessage">

</wsdl:fault>

</wsdl:operation>

</wsdl:portType>

<wsdl:binding name="PAPNMServiceSoapBinding"

type="tns:PAPNManagementPortType">

<soap:binding style="document"

transport="http://schemas.xmlsoap.org/soap/http" />

<wsdl:operation name="processAPNManagement">

<soap:operation style="document" />

<wsdl:input>

<soap:body use="literal" />

</wsdl:input>

<wsdl:output>

<soap:body use="literal" />

</wsdl:output>

<wsdl:fault name="FaultMessage">

<soap:fault name="FaultMessage" use="literal" />

</wsdl:fault>

</wsdl:operation>

</wsdl:binding>

<!-- 第一步:确定接口的名称:ProcessAPNManagementService -->

<wsdl:service name="ProcessAPNManagementService">

<wsdl:port name="ProcessAPNManagementPort" binding="tns:PAPNMServiceSoapBinding">

<!-- 第五步:确定对外提供服务的url地址 

     这里的url的第一级目录和二级目录会影响我们的配置;

             一级目录影响的是:web.xml中监听器的匹配规则

             二级目录影响的是:注册webservice服务的时候指定的名称-->

<soap:address

location="http://localhost:8080/LIG_cxf/services/ProcessAPNManagementPort" />

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

 

 

第一步:确定接口的名称:wsdl:service name="ProcessAPNManagementService" 

第二步:确定接口中都有哪些方法以及方法的名称:processAPNManagement   一个operation节点就代表一个方法,也就是在接口中声明几个方法。

第三步:确定接口中方法的参数类型和顺序  portType  PAPNManagementPortType 

    假设我要找processAPNManagement方法的参数类型和顺序;

   3.1:找出binding节点对应的porttype节点

     根据binding节点为tns:PAPNManagementPortType,找出端口porttype节点PAPNManagementPortType

3.2:找出这个porttypeoperation中的input指向的message节点

 

3.3.:找到message中对应 复杂类型complexType  APNMRequest-APNMRequestType sequence 下的元素element为传入的参数和参数类型

第四步:找出这个服务类中方法的返回值类型 

4.1:找出这个方法所在的porttype节点 PAPNManagementPortType 

4.2:找出porttype中每一个operation中的inputoutput对应的message

4.3:找到tyeps节点下name属性值为APNMResponseelement节点 

其返回的类型即为APNMResponseType类型文件。该文件的结构在命名空间xmlns:tnsAPNMResponseType元素中  在此例子中,该命名空间指向本文件。即返回APNMResponseType中的三个参数,该三个参数包装在一个对象中,即返回一个对象。

第五步:确定对外提供服务的url地址 

     这里的url的第一级目录和二级目录会影响我们的配置;

             一级目录影响的是:web.xml中监听器的匹配规则

             二级目录影响的是:注册webservice服务的时候指定的名称

 

转载于:https://www.cnblogs.com/xiaopucao/p/7596669.html

你可能感兴趣的文章
HTML元素定义 ID,Class,Style的优先级
查看>>
构造者模式
查看>>
http和https的区别
查看>>
Hbuild在线云ios打包失败,提示BuildConfigure Failed 31013 App Store 图标 未找到 解决方法...
查看>>
找到树中指定id的所有父节点
查看>>
今天新开通了博客
查看>>
AS3优化性能笔记二
查看>>
ElasticSearch(站内搜索)
查看>>
4----COM:a Generative Model for group recommendation(组推荐的一种生成模型)
查看>>
UVA 11137 - Ingenuous Cubrency
查看>>
js阻止事件冒泡的两种方法
查看>>
Java异常抛出
查看>>
[SQL Server 系] T-SQL数据库的创建与修改
查看>>
74HC164应用
查看>>
变量声明和定义的关系
查看>>
Wpf 之Canvas介绍
查看>>
linux history
查看>>
jQuery on(),live(),trigger()
查看>>
Python2.7 urlparse
查看>>
sencha touch在华为emotion ui 2.0自带浏览器中圆角溢出的bug
查看>>