- 浏览: 52629 次
- 性别:
- 来自: 北京
最新评论
-
lqwforever:
不错,支持一下
redhat linux卸载自带的Java1.4.2安装JDK6 -
liumiao2011:
keepgoing 写道java代码也可以格式化还是只能格式化 ...
让Editplus自动格式化js、css、html。。。 -
keepgoing:
java代码也可以格式化还是只能格式化HTML/CSS、js代 ...
让Editplus自动格式化js、css、html。。。
一: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的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,经过处理后返回一个简单的字符串。文档如下:
< 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元素的结构:
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定义:
< 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的格式如下:
必须有namespace属性和location属性:
namespace属性:值必须与正导入的WSDL文档中声明的targetNamespace相匹配;
location属性:必须指向一个实际的WSDL文档,并且该文档不能为空。
4、message元素
message元素描述了Web服务使用消息的有效负载。message元素可以描述输出或者接受消息的有效负载;还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。在本文中的message元素的定义,本文档使用了采用文档样式的消息传递:
< 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: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消息表示传递给客户的有效负载。
6、binding
binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用,本文中的例子:
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是""。
具体的使用需要参考特定协议定义的元素。
7、service元素和port元素
service元素包含一个或者多个port元素,其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding,甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。文档中的例子:
< 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有帮助。
发表评论
-
查看ORACLE实例名和服务名的方法(AIX系统下)
2013-09-05 12:53 1014数据库命令: sqlplus "/as sysd ... -
JSP禁用缓存常用方法
2013-05-05 12:59 6341.客户端缓存要在<head>中加入类似如 ... -
安装eclipse插件:JadClipse
2013-04-23 13:28 8861.下载反编译工具jad.exe,放在eclipse使用的 ... -
eclipse的JavaWeb工程.classpath设置
2013-03-17 12:21 1198<?xml version="1.0& ... -
tomcat注册成windows服务
2012-12-07 17:28 7611.进入tomcat目标下的bin目录里,执行ser ... -
查看oracle的sid
2012-12-07 13:44 1007有时候我们在tnsnames.ora配了一个连接串,用plsq ... -
调试plsql的存储过程
2012-12-05 21:37 891先右键add debug information 再右键te ... -
如何删除火狐插件
2012-11-25 22:19 668在地址栏输入about:config ,在搜索框中搜索plug ... -
windows查看端口占用情况
2012-11-19 00:47 7821.查看所有的端口占用情况 C:\>netsta ... -
在移动窗口的过程中显示整个窗口
2012-09-09 22:21 652修改注册表[HKEY_CURRENT_USER\CONTROL ... -
删除svn信息
2012-06-07 22:17 1161一、eclipse插件删除svn信息 右键点击项 ... -
Solaris下启动Oracle步骤
2012-05-22 11:08 911先打开一个终端,如果你是以root用户登录的系统 1。 ... -
DBLINK详解
2012-05-21 11:01 9241.创建dblink语法: CREATE [PUBLI ... -
linux命令
2012-05-02 18:52 741解压缩 unzip XXX.tar/zip 注意 ... -
redhat linux卸载自带的Java1.4.2安装JDK6(rpm)
2012-05-02 18:35 1134一.jdk1.4卸载 由于redhat Enterpr ... -
[转]“Microsoft Office Word已停止工作”解决方法
2012-03-27 15:14 1091方法一、双击打开“计算机”在右上方的搜索框中输入“Nor ... -
svn插件
2012-03-26 19:35 2528在线安装(比较慢) 类似: name:subclipse ... -
[转]区分Eclipse中的两种JRE
2012-03-22 00:03 1044Eclipse用到两种JRE,一是 ... -
redhat linux卸载自带的Java1.4.2安装JDK6
2012-03-12 16:58 2895一、卸载jdk1.4 由于Redhat Enterpr ... -
让Editplus自动格式化js、css、html。。。
2012-02-19 16:13 1444本人一般用editp ...
相关推荐
【WSDL详解(Webservice)】 Web服务描述语言(Web Services Description Language,简称WSDL)是一种基于XML的应用,主要用于描述Web服务的接口和其通信细节。WSDL文档定义了一组服务访问点,允许客户端通过这些点与...
Web Service描述语言 WSDL 详解
标题:"Web Service描述语言 WSDL 详解.pdf" 描述:"Web Service描述语言 WSDL 详解.pdf" 标签:"service web wsdl" 部分内容:Web Service描述语言(WSDL)向这种WebService的提供商和用户推出了方便的协调工作的...
通过阅读《一个完整的WSDL文档及各标签详解.doc》这份文档,你可以更深入地了解每个标签的用途和配置方式,从而更好地理解和使用Web服务。 在学习和应用WSDL时,还需要注意版本问题,目前主要使用的是WSDL 1.1,而...
**Web Service描述语言(WSDL)详解** Web Service描述语言(WSDL)是一种XML格式的规范,用于描述网络服务,特别是Web服务。WSDL文件定义了服务的位置、使用的消息协议以及如何调用这些服务。它是Web服务接口的...
Web服务描述语言(WSDL,Web Services Description Language)是一种XML格式,用于定义网络服务的接口。它是构建基于SOAP(Simple Object Access Protocol)的Web服务的关键技术之一,允许开发者明确地描述服务的...
Web Service描述语言(WSDL,Web Service Description Language)是一种基于XML的规范,用于定义Web服务的接口和通信细节。WSDL文件是Web服务的核心组成部分,它允许服务提供者明确地描述服务的功能、如何访问这些...
WSDL 详解 WSDL(Web Services Description Language)是一种基于 XML 的语言,用于描述基于网络的服务。它提供了一个统一的方式来描述网络服务,使得不同的系统和平台可以互操作。 为什么使用 WSDL? WSDL 是为了...
### CXF生成的WSDL详解 #### 一、概述 WSDL(Web Services Description Language)是一种用于描述Web服务的标准XML格式。它包含了服务提供者如何访问该服务的信息,包括服务的位置、服务可用的方法以及这些方法...
### WSDL详解 #### 一、概述 WSDL(Web Services Description Language)是一种基于XML的语言,用于描述网络服务。它不仅定义了服务的功能性描述,还详细规定了服务的访问方式,包括消息交换模式和传输协议等。...
WebService经典24篇网文汇总,包含axis2_Xfire搭建_WSDL详解_自动生成客户端和WSDL等,自己找了好久的内容; 都是自己学习过程中网络的知识,找了很久,里边有一些自己的标记,如果发现chm内容是空白,注意看一下,其实是...