WSDL规则解释(转)

转自:http://www.blogjava.net/baoyaer/articles/116413.html

WSDL文档可以分为两部分。顶部分由抽象定义组成,而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息,它们并不包含任何随机器或语言而变的元素。这就定义了一系列服务,截然不同的网站都可以实现。随网站而异的东西如序列化便归入底部分,因为它包含具体的定义。
l 抽象定义
        Types
            独立与机器和语言的类型定义

  Messages
           包括函数参数(输入与输出分开)或文档描述

  PortTypes
           引用消息部分中消息定义来描述函数签名(操作名、输入参数、输出参数)

2 具体定义
        Bindings
       PortTypes部分的每一操作在此绑定实现

  Services
          确定每一绑定的端口地址

下面的图中,箭头连接符代表文档不同栏
之间的关系。点和箭头代表了引用或使用关系。双箭头代表"修改"关系。3-D的箭头代表了包含关系。这样,各Messages栏使用Types栏的定
义,PortTypes栏使用Messages栏的定义;Bindings栏引用了PortTypes栏,Services栏引用Bindings
栏,PortTypes和Bindings栏包含了operation元素,而Services栏包含了port元素。PortTypes栏里的
operation元素由Bindings栏里的operation元素进一步修改或描述。

首先看看一段简单的JAVA代码,我们用它作为WSDL的服务实现代码:

class Test{
  public String echo(String u){
    return "Hello " + u;
  }
}

看看它导出的文件:

  //
第一行申明该文档是XML。尽管这并不是必需的,但它有助于XML解析器决定是否解析WSDL文件或只是报错。第二行是WSDL文档的根元
素:<definitions>。一些属性附属于根元素,就像<schema>子元素对于<types>元素。

<?xml version="1.0" encoding="UTF-8" ?> 
- <wsdl:definitions targetNamespace="http://localhost/axis/Test2.jws"
                                      xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
                                      xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                                      xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
                                      xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
                                      xmlns:apachesoap="http://xml.apache.org/xml-soap" 
                                      xmlns:intf="http://localhost/axis/Test2.jws" 
                                      xmlns:impl="http://localhost/axis/Test2.jws">
- <!-- 
WSDL created by Apache Axis version: 1.4
Built on Apr 22, 2006 (06:55:48 PDT)

  -->

定义好操作(或方法)以后,现在需要指定将向它们发送和从它们返回的参数。在 WSDL 术语中,所有参数称为“消息”。认为您是在递送消息而结果得到返回的消息是有用的。方法调用是这样一种操作:它准备返回“消息”来响应进入的消息。

<message>元素包含了Messages栏。如果我们把操作看作函数,<message>元素定义了那个
函数的参数。<message>元素中的每个<part>子元素都和某个参数相符。输入参数在<message>元
素中定义,与输出参数相隔离--输出参数有自己的<message>元素。兼作输入、输出的参数在输入输出的<message>
元素中有它们相应的<part>元素。输出<message>元素以"Response"结尾,就像以前所用
的"fooResponse"。每个<part>元素都有名字和类型属性,就像函数的参数有参数名和参数类型。

- <wsdl:message name="echoResponse">   //返回的消息
  <wsdl:part name="echoReturn" type="xsd:string" /> 
  </wsdl:message>
- <wsdl:message name="echoRequest">  //请求的消息
  <wsdl:part name="u" type="xsd:string" /> 
  </wsdl:message>

<definitions> 元素包含一个或多个 <portType> 元素,实际上,每个元素都是您希望表示的一系列 operation
。或者,您也可以将单个 portType
元素看作是将各种方法组成类的一个逻辑分组。例如,如果您的供应链管理解决方案需要在客户和供应商之间进行交互,您最可能做的是分别定义与他们交互的功能
性;也就是说,您将为用户和供应商各定义一个 portType。应该将每个 portType 称为 服务,因此整个 WSDL 文件将成为一个服务集合。

- <wsdl:portType name="Test2">   //一个portType可以看成一个类
- <wsdl:operation name="echo" parameterOrder="u">   //一个operation就是一个方法
  <wsdl:input name="echoRequest" message="impl:echoRequest" />   //输入消息
  <wsdl:output name="echoResponse" message="impl:echoResponse" />  //返回消息
  </wsdl:operation>
  </wsdl:portTyp>

消息传递和传输:
我以一种抽象方式定义了操作和消息,而不考虑实现的细节。实际上,WSDL 的任务是定义或描述 Web 服务,然后提供一个对外部框架的引用来定义 WSDL 用户将如何实现这些服务。可以将这个框架当作 WSDL 抽象定义和它们的实现之间的“绑定( binding )”。

当前,最流行的绑定( binding )技术是使用简单对象访问协议(SOAP)。WSDL 将指定能够访问 Web 服务实际实现的 SOAP 服务器,并且从那时起 SOAP 的整个任务就是将用户从 WSDL 文件带到它的实现。

<wsdl:binding name="Test2SoapBinding" type="impl:Test2">

  <wsdlsoap:binding/> 元素。该元素的用途是声明将把 SOAP 作为绑定和传输服务使用

  <wsdlsoap:binding> 元素有两个属性:style 和
transport。style 是一个可选属性,它描述该绑定内操作的性质。transport 属性指定 HTTP
作为该绑定将使用的级别较低的传输服务。SOAP 客户机将从 WSDL 文件中读取 SOAP 结构并与另一端的 SOAP 服务器协调.
  <wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" /> 

 WSDL <operation> 元素,分别表示具体的操作。每个 <operation> 元素提供各自操作的绑定细节。因此,我提供了另一个 extensibility 元素,即 <wsdlsoap:operation/> (仍然是一个空元素,与它发生的那个操作相关)。该 <soap:operation/> 元素有一个 soapAction 属性,SOAP 客户机将使用该属性创建 SOAP 请求。

    //下面将WSDL描述与具体实现进行绑定,这里采用SOAP方式

- <wsdl:operation name="echo">
  <wsdlsoap:operation soapAction="" /> 
- <wsdl:input name="echoRequest">
  <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://DefaultNamespace" /> 
  </wsdl:input>
- <wsdl:output name="echoResponse">
  <wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://localhost/axis/Test2.jws" /> 
  </wsdl:output>
  </wsdl:operation>
  </wsdl:binding>
//下面将发布的服务与前面的SOAP绑定进行关联
- <wsdl:service name="Test2Service">
- <wsdl:port name="Test2" binding="impl:Test2SoapBinding">
  <wsdlsoap:address location="http://localhost/axis/Test2.jws" /> 
  </wsdl:port>
  </wsdl:service>

每个namespace属性都声明了一个缩略语,用在文档中。例如"xmlns:xsd"就为
http://www.w3.org/2001/XMLSchema定义了一个缩略语(xsd)。这就允许对该namespace的引用只需简单的在名字
前加上前缀就可以了,如:"xsd:int"中的"xsd"就是合法的类型名。普通范围规则可运用于缩略前缀。也就是说,前缀所定义的元素只在元素中有
效。

  Namespace派什么用?namespace的作用是要避免命名冲突。如果我建立一项Web
Service,其中的WSDL文件包含一个名为"foo"的元素,而你想要使用我的服务与另一项服务连接作为补充,这样的话另一项服务的WSDL文件就
不能包含名为"foo"的元素。两个服务器程序只有在它们在两个事例中表示完全相同的东西时,才可以取相同的名字。如果有了表示区别的
namespace,我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。在你的客户端里,你只要加以限制就可以引用我
的"foo"。

  见下例:http://www.infotects.com/fooService#foo
就是完全限制的名字,相当于"carlos:foo",如果我声明了carlos作为http://www.infotects.com
/fooService的快捷方式。请注意namespace中的URL是用来确定它们的唯一性的,同时也便于定位。URL所指向的地方不必是实际存在的
网络地址,也可以使用GUID来代替或补充URL。例如,GUID"335DB901-D44A-11D4-A96E-0080AD76435D"就是一
个合法的namespace指派。

  targetNamespace属性声明了一个namespace,元素中所有的声明的名字都列于其内。在WSDL示例中,<definitions>的targetNamespace 是http://tempuri.org/wsdl。这意味着所有在WSDL文档中声明的名字都属于这个namespace。<schema>元素有自己的targetNamespace属性,其值为 http://tempuri.org/xsd ,在<schma>元素中定义的所有名字都属于这个namespace而不是main的target namespace。

  <schema>元素的以下这行声明了默认的namespace。Schema中所有有效的名字都属于这个namespace。

时间: 2024-11-05 07:44:02

WSDL规则解释(转)的相关文章

apache 虚拟主机和 rewrite 配置及 rewrite规则解释

如何使用rewrite步骤: 1.     配置apache,启用rewrite机制,修改httpd.conf 在httpd.conf中启用rewrite LoadModule rewrite_module modules/mod_rewrite.so      #如果没有这一行则在配置文件中添加这一行 2.     配置虚拟主机 修改 hosts文件添加你的 ip 和域名对应,如下事例 127.0.0.1       www.yaf.com 在 http.conf 文件中启用虚拟主机 # Vi

jboss规则引擎KIE Drools 6.3.0-高级讲授篇

在生产环境怎么用BRMS 回溯BRMS开发教程中的那张"业务变现加速器"架构图,考虑下面的问题 业务开发人员开发规则 IT人员提供FACT 关键在于"全动态" SQL语句改了怎么办?不重启 DAO层改了怎么办?不重启 Mybatis的配置文件改了怎么办?不重启 按照上次的<jboss规则引擎KIE Drools 6.3.0 Final 教程>,一起来看一个实际的场景 如何熊掌与鱼兼得? 做到以下几点是否就可以"全得"? 规则更改不重启

MySQL UTF-8 常用字符排序规则

排序规则 解释 utf8_general_ci 不区分大小写 utf8_general_cs 区分大小写 utf8_bin 区分大小写,字符串每个字符串用二进制数据编译存储,且支持存储二进制数据 原文地址:https://www.cnblogs.com/mahoshojo/p/12006144.html

Python正则表达式Regular Expression基本用法

资料来源:http://blog.csdn.net/whycadi/article/details/2011046   直接从网上资料转载过来,作为自己的参考.这个写的很清楚.先拿来看看. 1.正则表达式re模块的基本函数. (1)findall函数的用法 findall(rule,target[,flag])是在目标字符串中找到符合规则的字符串.参数说明:rule表示规则,target表示目标字符串,[,flag]表示的是规则选项.返回的结果是一个列表.若没找到符合的,是一个空列表. 如: 因

【R】数据导入读取read.table函数详解,如何读取不规则的数据(fill=T)

函数 read.table 是读取矩形格子状数据最为便利的方式.因为实际可能遇到的情况比较多,所以预设了一些函数.这些函数调用了 read.table 但改变了它的一些默认参数.  注意,read.table 不是一种有效地读大数值矩阵的方法:见下面的 scan 函数. 一些需要考虑到问题是: 编码问题 如果文件中包含非-ASCII字符字段,要确保以正确的编码方式读取.这是在UTF-8的本地系统里面读取Latin-1文件的一个主要问题.此时,可以如下处理 read.table(file("fil

【阿里云产品公测】以开发者角度看ACE服务『ACE应用构建指南』

?;ZnD(4?   评测介绍 1V-sibE   j|LOg 评测产品: 云引擎ACE服务 开发语言: PHP 评测人: mr_wid 评测时间: 2014年10月13日-19日 XV1XzG#C   .>p.k*vU   评测概要 9]:F!d/   fYlqaO4[   非常有幸能够申请到ACE的公测资格, 在本篇评测中, 笔者将以一个开发者的角度来对云引擎ACE服务进行介绍与使用.在本篇评测中, 您将看到: ACE能够做些什么 ACE应用的创建与发布 应用的配置与调试 ACE扩展服务的使

pam密码策略

PAM 的使用历史 PAM 是关注如何为服务验证用户的 API.在使用 PAM 之前,诸如 login(和 rlogin.telnet.rsh)之类的应用程序在 /etc/passwd 中查找用户名,然后将两者相比较并验证用户输入的名称.所有应用程序使用了这些共享服务,但是并未共享实现细节和配置这些服务的权限. 接下来,应用程序开发人员尝试编写自定义过程代码.在此过程中,需要分离应用程序与安全模块(通用安全模块可以在应用程序之间共享并且可以根据需求进行配置). PAM 机制将把多个低级别验证模式

HTML/htm,SHTML/shtm,XML,XHTML

HTML/htm 英文全称是Hyper Text Markup Languge,中文全称是超文本标记语言:是标准通用标记语言下的一个应用,一种规范,一种标准,它通过标记符号来标记要显示的网页中的各个部分.HTML结构包括head,body两大部分,其中头部描述浏览器所需的信息,主体则包含要显示在网页上的具体内容.从发布至今,HTML经历了5次改版. 特点: 1.  简易性:HTML版本升级采用超集方式,从而更加灵活方便: 2.  可扩展性:HTML的广泛应用带来了加强功能,增加标识符等要求,HT

ASP.NET MVC 原理

我出了份卷子做面试题,其中之一就是要求说说ASP.NET MVC的原理.感觉太空泛了,谁能说得准呢? 但是,如果站在我这个面试官立场,面试题好多时并不要求有标准答案,可能也没有什么标准答案,主要是通过问答,了解一下面试者的理解程度,相关知识程度什么的.其实,我自己水平也不行,但因为年纪大,好像不带点人大家会觉得有点怪怪的,所以过去一段时间也参与点招聘工作. 对于ASP.NET MVC,我自己的理解是酱紫的: MVC是一种思想.ASP.NET MVC只不过是实现了这种思想的一种开发框架.利用Web