【转】WebService WSDL结构分析

转载自：http://kalogen.javaeye.com/blog/418958

 WSDL (Web Services Description Language,Web服务描述语言)是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程过程调用)。WSDL首先对访问的操作和访问时使用的请求/响应消息进行抽象描述，然后将其绑定到具体的传输协议和消息格式上以最终定义具体部署的服务访问点。相关的具体部署的服务访问点通过组合就成为抽象的Web服务。 本文将详细讲解WSDL文档的结构，并分析每个元素的作用。

一：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的基本结构--概述

如第一部分最后描述的那样，一个基本的WSDL文档包含7个重要的元素。下面将分别介绍这几个元素以及他们的作用。

WSDL 文档在Web服务的定义中使用下列元素：

  • Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。
  • Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
  • Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。
  • PortType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
  • Binding - 特定端口类型的具体协议和数据格式规范的绑定。
  • Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
  • Service- 相关服务访问点的集合。

  可以参考下图来理解一下WSDL的文档结构图：WSDL文档元素的结构图

WSDL的xml schema可以参照如下网址：http://schemas.xmlsoap.org/wsdl/

三：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所定义的。

　　本文简单介绍了WSDL规范的用途，基本结构和使用方法，希望对大家学习WSDL有帮助。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/news/436713.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

php date 报错,编译安装PHP报错：ext/date/php_date.lo is not a valid libtool object

php date 报错,编译安装PHP报错：ext/date/php_date.lo is not a valid libtool object

安装php-5.3.13时&#xff0c;make报错&#xff1a;ext/date/php_date.lo is not a valid libtool object。查看libtool(由ltmain.sh生成)该错误是由于&#xff1a;if (${SED} -e ’2q’ $arg | grep “^# Generated by .*$PACKAGE”) >/dev/null 2>&1; then 语句不成…
阅读更多...
php 父类中获取子类的名称,php – 在父类中获取子类的名称(静态上下文)

php 父类中获取子类的名称,php – 在父类中获取子类的名称(静态上下文)

我正在构建一个重用和简单的ORM库;一切都很好&#xff0c;除了我被一个愚蠢的继承限制。请考虑以下代码&#xff1a;class BaseModel {/** Return an instance of a Model from the database.*/static public function get (/* varargs */) {// 1. Notice we want an instance …
阅读更多...
【转】WebService 之 WSDL文件 讲解

【转】WebService 之 WSDL文件 讲解

恩&#xff0c;我想说的是&#xff0c;是不是经常有人在开发的时候&#xff0c;特别是和第三方有接口的时候&#xff0c;走的是SOAP协议&#xff0c;然后用户给你一个WSDL文件&#xff0c;说按照上面的进行适配&#xff0c;嘿嘿&#xff0c;这个时候&#xff0c;要是你以前没有…
阅读更多...
集卡php源码,独角数卡自动发卡网PHP源码+教程：虚拟产品自助售卖

集卡php源码,独角数卡自动发卡网PHP源码+教程：虚拟产品自助售卖

这款独角数卡自动发卡源码比大大目前在用的源码还要强大&#xff0c;测试了一下&#xff0c;不光可以零售还能批发&#xff0c;相当给力&#xff01;支付接口也是集成了很多&#xff0c;不仅支持支付宝当面付&#xff0c;还支持第三方的支付&#xff01;支付接口如下&#xff1…
阅读更多...
【转】Mongodb 学习笔记

【转】Mongodb 学习笔记

Mongo DB NoSql简介MongoDB简介在Windows平台下安装MongoMongo DB官方文档 MongoDB基本命令 MongoDB的默认安装路径为 C:\Program Files\MongoDB创建默认的数据库存放路径c:\data\db ,使用命令行把该路径关联到mongo上 C:\Program Files\MongoDB\Server\3.2\bin\mongod.exe -…
阅读更多...
基于matlab的数字下变频器的设计与仿真应用,基于MATLAB的数字下变频器的设计与仿真应用.pdf...

基于matlab的数字下变频器的设计与仿真应用,基于MATLAB的数字下变频器的设计与仿真应用.pdf...

基于MATLAB的数字下变频器的设计与仿真应用中国科技论文在线基于 Matlab 的数字下变频器的设计与仿真朱建新&#xff0c;沈树群*(北京邮电大学电子工程学院&#xff0c;北京 100876 )摘要&#xff1a;本文通过对数字变频器中关键技术的研究&#xff0c;给出了一种数字下变频器中…
阅读更多...
【转】C#中[STAThread]的作用

【转】C#中[STAThread]的作用

C#的关键字 [STAThread]即 single-threaded apartment一&#xff1a; 每个Thread都有一个关于ApartmentState的属性&#xff0c;可以把它设置为&#xff1a;STA或者MTA&#xff0c;或者UNKNOWN。 当你想指定工程的启动窗口的时候&#xff0c;你需要在该窗口类中申明一个Main()方…
阅读更多...
开始blog

开始blog

我不是一个习惯用文字记录心情&#xff0c;事情的人。原因有三&#xff1a;1、没有毅力&#xff0c;小时候爱买精美的日记本&#xff0c;但总写几页就扔到一边了。2、从小就不爱写作文&#xff0c;所以文笔很差。有时翻开自己以前的日记&#xff0c;看了都想撕。3、字写得难看。…
阅读更多...
【转】C#搭建Oauth2.0认证流程以及代码示例

【转】C#搭建Oauth2.0认证流程以及代码示例

对于一个普遍问题&#xff0c;必有对应的一个简洁优美的解决方案。这也许只是一厢情愿&#xff0c;因为根据宇宙法则&#xff0c;所有事物总归趋于混沌&#xff0c;而OAuth协议就是混沌中的产物&#xff0c;不管是1.0、1.0a还是2.0&#xff0c;单看版本号就让人神伤。 OAuth2.0…
阅读更多...
语言差异引起的问题解决一例

语言差异引起的问题解决一例

在2004DevDay中&#xff0c;介绍的SmartClient技术以及其DataProtection技术&#xff0c;刚好目前的项目计划使用这样的技术。我是使用C#编码的&#xff0c;但IssueVission是用VB.Net写的&#xff0c;这难不倒我&#xff0c;毕竟BASIC还是自己的入门语言&#xff0c;VB和VBScri…
阅读更多...
思想已经高过行动好多了

思想已经高过行动好多了

好几天过去了&#xff0c;依然没什么起色&#xff0c;今天搜索一下论坛上自己的老帖&#xff0c;整理出来做个见证&#xff0c;看着自己才开始ASP的时候问的问题&#xff0c;不知所云。现在就不一样了&#xff0c;哈哈……在听了些微软的讲座之后&#xff0c;对设计模式很感兴趣…
阅读更多...
【转】自旋锁-SpinLock（.NET 4.0+）

【转】自旋锁-SpinLock（.NET 4.0+）

短时间锁定的情况下&#xff0c;自旋锁&#xff08;spinlock&#xff09;更快。&#xff08;因为自旋锁本质上不会让线程休眠&#xff0c;而是一直循环尝试对资源访问&#xff0c;直到可用。所以自旋锁线程被阻塞时&#xff0c;不进行线程上下文切换&#xff0c;而是空转等待。…
阅读更多...
php实现把es6转为es5,如何将ES6代码转化为ES5？

php实现把es6转为es5,如何将ES6代码转化为ES5？

比方说下面这段代码&#xff1a;const navigator window.navigatornavigator.getUserMedia navigator.getUserMedia ||navigator.webkitGetUserMedia ||navigator.mozGetUserMedia ||navigator.msGetUserMediaconst AudioContext window.AudioContext ||window.webkitAudioC…
阅读更多...
IBM收购Rational一年总结

IBM收购Rational一年总结

IBM收购Rational一年总结 Clint Boulton[2003/12/26] 12月&#xff0c;又到年关总结的时候了&#xff0c;这次&#xff0c;是该IBM给这个耗资2.1亿美元的交易作评价了。 这次收购帮助IBM增加了在使用面向服务架构&#xff08;SOA&#xff09;发布Web Service方面增加了筹码。SO…
阅读更多...
【转】.NET 自带的动态代理+Expression 实现AOP

【转】.NET 自带的动态代理+Expression 实现AOP

下面代码&#xff08;摘抄之别处&#xff0c;原创在哪不知&#xff09;是采用TransparentProxy和RealProxy实现对象的动态代理。碍于其使用反射调用方法&#xff0c;所以就小试着将反射改成Expression以提高执行的效率。第15行就是原来代码中反射调用方法的关键代码。 1 using …
阅读更多...
新来乍到，谢谢大家捧场

新来乍到，谢谢大家捧场

原来的blog是&#xff1a;http://www.blogcn.com/user9/szujobs/index.html由hBifTs 介绍&#xff0c;才得知有这么一个好地方。于是昨天把原来的文章迁移过来&#xff0c;其中一些文章有点旧了&#xff0c;写了有一阵子了。我的朋友都叫温少&#xff0c;毕业自深圳大学&#x…
阅读更多...
【转】谈谈c#中异步编程模型的变迁**

【转】谈谈c#中异步编程模型的变迁**

大家在编程过程中都会用到一些异步编程的情况。在c#的BCL中&#xff0c;很多api都提供了异步方法&#xff0c;初学者可能对各种不同异步方法的使用感到迷惑&#xff0c;本文主要为大家梳理一下异步方法的变迁以及如何使用异步方法。 BeginXXX&#xff0c;EndXXX模式 在.Net F…
阅读更多...
nextcloud php 版本,Nextcloud版本升级教程

nextcloud php 版本,Nextcloud版本升级教程

捷径&#xff1a;cd /www/wwwroot/x.timeit.cnsudo -u www php updater/updater.phar进行命令更新&#xff0c;并使用occ进行更新系统&#xff0c;并关闭维护模式&#xff1a;sudo -u www php occ upgradesudo -u www php occ maintenance:mode --off注意:(命令需要在nextcloud…
阅读更多...
剖析Jive的缓存机制

剖析Jive的缓存机制

剖析Jive的缓存机制- - 作者&#xff1a;张磊 本文选自&#xff1a;开放系统世界 2003年06月06日Jive是一个广受欢迎的开放源码的论坛项目&#xff0c;虽然推出了很多年&#xff0c;但至今很多Java程序员还对它津津乐道。从框架结构上看&#xff0c;它采用了很多设计模式&#…
阅读更多...
php统计在线时长,js统计网站运行时长

php统计在线时长,js统计网站运行时长

js统计网站运行时长第一种&#xff1a;网站function siteTime(){window.setTimeout("siteTime()", 1000);var seconds 1000var minutes seconds * 60var hours minutes * 60var days hours * 24var years days * 365var today new Date()var todayYear today.…
阅读更多...
最新文章

Copyright @ 2022~2023