Webservice-3

【WSDL的产生】

为了在具体的web服务中使用SOAP,需要事先知道如何构造SOAP消息,要采用哪一种通讯协议(如HTTP或SMTP)以及Web服务的Internet地址。总而言之,需要使用文档。
比如我们在SOAP文档里写到的BookQuote的SOAP消息非常简单,如1-1例:
<?xml version = “1.0” encoding= “UTF-8”>
<sopa:Envelope
Xmlns:soap=Http://schemas.xmlsoap.org/soap/envelope/
Xmlns:mh=”Http://www.Monson-Haefel.com/jwsbook/BookQuote”>

<soap:Body>

<mh:getBookPrice>

<isbn>0930849028</isbn>

</mh:betBookPrice>

</soap:Body>
</soap:Envelope>
虽然这个上个文档介绍的BookQuote Web服务的描述非常易于理解,但它并不是结构良好的文档,如果所有的Web服务都以这种方式描述,那么每当用户希望使用一个新的Web服务时,就需要读一个非正规的文档了。为了避免出现非正规文档的问题,Web服务社团采用了WSDL(Web Services Description Language,Web服务描述语言)。WSDL是一个用于精确描述Web服务的文档格式。
【WSDL的作用】---------------------------------------------------------------------------------------------

Wsdl用来指定客户与具体的Web服务通信时必须使用的确切的消息格式,Internet协议以及地址。换句话说,WSDL文档要告诉用户如何使用Web服务。Wsdl是Web服务的另外一个事实标准,而且像SOAP一样,它得到了广泛的认可,现在基本上所有的厂商都支持WSDL。

WSDL非常合适做代码生成器,它能够读WSDL文档,并可以访问Web服务生成一个程序化的接口。比如,JAX-RPC提供者要用WSDL1.1生成Java RMI 接口和网络占位程序,他们可用于与Web服务交换SOAP消息。

JAX-RPC提供者是JAX-RPC API的一个供应商实现。比如,BEA WebLogic是一个JAX-RPC提供者。所有的J2EE1.4应用程序服务器是JAX-RPC提供者,因为它们均提供他们自己的JAX-RPC API实现。
       虽然WSDL特别适合用作代码生成器,但当使用其他的Web服务工具和API时,WSDL也是非常有用。比如,许多的Web服务客户要使用SOAP API而不是使用生成的调用接口和占位程序。这些API通常要用像Envelope,Header,Body,Fault这样的对象对SOAP消息的结构进行建模。【当用户使用SOAP API时,可以用Web服务的WSDL作为与那个Web服务交换SOAP消息的向导。】
       虽然人们把WSDL看成一个Web服务标准,但它其实并不简单,这可能是它的最大障碍,本人看了很多的内容,到现在还是没有完全理解,自己觉得WSDL的复杂性取决于其设计者的目的,即对没有与任何具体的协议,编程语言或操作系统有联系的Web服务创建一个IDL(interface definition language,接口定义语言)。还有顺便说一下,WSDL1.1并不是专门用于SOAP,可以用它描述没有基于SOAP的Web服务。
       模块化是WSDL的另一个设计目的。由于WSDL非常模块化,因此用户可以重复使用它的功能来描述多个Web服务。非常遗憾的是,我觉得这样使得初学者很难读懂WSDL文档。我希望大家能认真的读懂前面的基本概念,还要去理解前面写的SOAP文档和深入了解一下XML的东西,可是很多情况下,用户从不需要读写自己的WSDL文档,因此自己的J2EE平台通常会自动创建并处理这些文档。我想在这说一下的是,如果你真的想真正的了解J2EE web services 我建议大家别用市面上的那些软件。。毕竟以后你用JAX-RPC的时候你会摸不到头脑,因为你根本不清楚这些WSDL的内部构造是怎么样的。顶多你只能应用而已。
【WSDL的基本结构】------------------------------------------------------------------------

WSDL文档是一个遵循WSDL XML模式的XML文档。作为XML文档实例,如果要使WSDL文档有效且格式良好的话,应必须以正确的方式使用正确的元素(感觉是废话哇,可是你看完下面的介绍你就知道为什么我要强调这些了)。下面的部分将介绍WSDL的结构以及如何构造恰当描述Web服务的WSDL。虽然WSDL能够用于描述任何种类的Web(从理论说),但我会重点介绍基于SOAP且符合WS-I Basic Profile 1.0(对这个陌生的可以去看看我发布的SOAP消息的文档)的Web服务的WSDL文档。
       一个WSDL文档包括了7个重要元素,即 types,import,message,porttype,operation,binding和services。这些元素嵌套于definitions元素中。Definitions元素是WSDL的根元素。来看看下面的表吧:
元素名称

 元素作用

 
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元素赋给一个特殊协议(如SOAP1.1)和编码样式。
 
Services
 此元素负责将一个internet地址赋给一个具体的绑定。
 
Documentation
 此元素向读者说明了WSDL文档方面的一些信息,其他任何WSDL元素均可以包含documentation元素,documentation元素并不重要,我不会继续介绍了。
 

看看下面的1-2例子是一个非常简单的WSDL文档实例,该文档描述了前面SOAP里的BookQuote的Web服务,当大家读到这里时,要记住它要描述一个Web服务以及用于访问该Web服务的SOAP消息类型,协议和Internet地址的类型:
示例1-2:
<?xml version = “1.0” encoding= “UTF-8”>
<definitions name = “BookQuoteWS”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>

<!—消息元素(message)描述了输入和输出的参数-->
<message name = “GetBookPriceRequest”>

<part name = “isnb” type = “xsd:string”>
</messgae>

<message name = “GetBookPriceResponse”>

<part name = “price” type = “xsd:float”>
</messgae>

<!—portType 元素描述了web services 的抽象接口-->
<portType name = “BookQuote”>

<operation name = “getBookPrice”>

<input name = “isbn” message = “mh:GetBookPriceRequest”/>

<output name = “price” message = “mh:GetBookPriceRespsonse”/>

</operation>
</portType>

<!—binding 告诉了我们哪些协议和内码样式被使用-->

<binding name = “BookPrice Binding” type = “mh:BookQuote”>

<soapbind:binding style = “rpc”
Transport = http://schemas.xmlsoap.org/soap/http/>
<operation name = “getBookPrice”>

<soapbind: operation styles = “rpc”
Soap:Action =
http://www.Monson-Haefel.com/jwsbook/BookQuote/GetBookPrice/>
<input>

<soapbind.body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</input>

<output>

<soapbind:body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</output>

</operation>

</binding>

<!—services 告诉我们Web Services的Internet地址-->

<services name = “BookPriceServices”>

<port name = “BookPrice_port” binding = “mh:BookPrice_Binding”>

<soapbind:address location =
http://www.Monson-Haefel.com/jwsbook/BookQuote />

</port>
</services>
</definitions>

也许大家读到这里有点晕了吧。。。正常,不要泄气,这是初学WSDL的正常表现。在后面会对1-2例里出现的元素与属性作用,详细分解。

【WSDL声明:definitions元素,types元素和import元素】
【definitions元素详解】----------------------------------------------------------------------
所有WSDL文档的根元素均是definitions元素。该元素封装了整个文档,同时还通过它的名称提供了一个WSDL文档。
<definitions name = “BookQuoteWS”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>
definitions元素通常包含了若干个XML命名空间声明,这妒意根元素来说是正常的。这些声明中包括一个用于WSDL1.1XML模式的命名空间 http://schemas.xmlsoap.org/wsd/的声明。将WSDL命名空间声明为默认命名空间,就不再需要前缀来显示限定每一个WSDL元素了。

Definitions元素中的第一个属性是name,该属性用来命名整个WSDL文档。其实整个属性不是那么重要,因为根本无任何对象要引用它。

Definitions元素还定义了一个targetNamespace属性,该属性指定了WSDL文档中定义的命名空间,就像XMK模式文档中指定命名空间一样。

Message,portType和binding元素利用他们的name属性指定了标签。这些标签会自动使用由targetNamespace属性指定的命名空间(这些例子还使用了targetnamespace属性赋给了URI的前缀mh)。标签的message,portType,binding元素通常成为定义。这些定义假设了由targetnamespace属性指定的命名空间。
       文档中的其他元素用他们的标签和命名空间前缀引用定义。通常将带有前缀的标签看成是一个定义的完全限定名称。例如,下面的1-3例子中,input和output元素要用它们的限定名称引用消息定义。
<message name = “GetBookPriceRequest”>

<part name = “isnb” type = “xsd:string”>
</messgae>

<message name = “GetBookPriceResponse”>

<part name = “price” type = “xsd:float”>
</messgae>

<!—portType 元素描述了web services 的抽象接口-->
<portType name = “BookQuote”>

<operation name = “getBookPrice”>

<input name = “isbn” message = “mh:GetBookPriceRequest”/>

<output name = “price” message = “mh:GetBookPriceRespsonse”/>

</operation>
</portType>
【types元素详解】-----------------------------------------------------------------------------------------

WSDL采用了W3C XML模式内置类型(我们常理解为基本类型)。Type元素用作一个容器,用于定义XML模式内置类型(即复杂类型和定制的简单类型)中没有描述的各种数据类型。当声明消息部分(即有效负载)时,消息定义使用了在types元素中定义的数据类型与元素。
       下面的1-4例子没有使用types元素,我觉得不需要。直接的消息定义getBookPriceRequest和getBookPriceResponse引用了简单的内置数据类型。
       如果愿意,可以为ISBN号定义定制的简单类型,并在GetBookPriceRequest消息中使用该类型而不是内置String类型,让我们来看看实例1-4吧:

<definitions name = “BookQuoteWS”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>

<types>

<xsd:schema
targetNamespace = “http://www.Monson-Haefel.com/jwsbook/BookQuote”>
<!—这是ISBN的简单类型-->
<xsd:simpleType name = “ISBN”>

<xsd:restriction base = “xsd:string”>

<xsd:pattern value = “[0-9]{9}[0-9Xx]”>

</xsd:restriction>

</xsd:simpleType>

</xsd:schema>

</types>
<message name = “GetBookPriceRequest”>

<part name = “isnb” type = “mh:ISBN”>
</messgae>

<message name = “GetBookPriceResponse”>

<part name = “price” type = “xsd:float”>
</messgae>
……………………………………………..
</definitions>

在这里1-4例子中,types元素中直接嵌套了一个完成的W3C XML模式文档。实例1-4还定义了定制的简单类型(标签ISBN),并通过XML模式targetnamespace属性将其赋给了mh命名空间,然后用mh:ISBN类型定义了GetBookPriceRequest消息定义的isbn部分。

XML模式的targetnamespace属性必须是一个有效的非空值,否则该类型个元素不属于一个有效的命名空间。此外,在types元素中定义的XML模式必须属于一个由WSDL文档(通常位于definitions元素中)指定的命名空间,或属于一个导入的WSDL文档的命名空间。换句话说,WSDL文档必须知道文档使用的各个命名空间。
【特别补充】------------------------------------------------------------------------------------------------

SOAP和WSDL均定义了属性与编码类型,用户可以用它们定义数组数据类型。但是这些数组类型和属性引起了混乱,并引起互操作性方面的问题,所以BP严格禁止使用他们。简单地说,不允许使用为SOAP1.1编码定义的Array类型或arrayType属性,也不允许使用由WSDL定义的WSDL arrayType属性。此外,用户不能将数组类型标记为WSDL1.1注释建议的ArrayOfxxxx形式。这些要求并不是障碍,因为XML模式提供了用于定义数组的更加容易的方式。
       定义数组时用户需要做的工作是用大于0的maxOccurs属性加值(如10,222222或unbounded定义)定义一个复杂类型。而且用户还有其自己的基本数组如下例1-5:

<definitions name = “BookQuoteWS”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>

<types>

<xsd:schema
targetNamespace = “http://www.Monson-Haefel.com/jwsbook/BookQuote”>
<!—这是简单的类似数组的类型-->
<xsd:simpleType name = “ISBN”>


<xsd:element name = “arg” type = “xsd:int” maxOccurs = “unbounded”>

</xsd:simpleType>

</xsd:schema>

</types>

【import元素】----------------------------------------------------------------------------------------------
Import元素使得可以在当前WSDL文档中使用在其他WSDL文档中指定的命名空间中的定义有效。如果用户希望模块化WSDL文档(如为了将抽象定义(types,message,porttype元素)与具体定义(binding,services和port元素)相区分),则此功能非常有用。
       使用import元素的另一个原因是,将若干个想要单独维护的定义放在一个WSDL文档中,但要在可由商业伙伴访问的公共目录中对所有Web服务提供一个完整的定义。让我们看看下面的1-6例子吧:
<definitions name = “AllMhWebServices”
Xmlns=http://schemas.xmlsoap.org/wsdl/ >
<import namespace = http://www.Monson-Haefel.com/jwsbook/BookQutoe
Location = “http://www.Monson-Haefel.com/jwsbook/BookPrice.wsdl”>

<import namespace = http://www.Monson-Haefel.com/jwsbook/Po
Location = “http://www.Monson-Haefel.com/jwsbook/wsdl/PurchaseOrder.wsdl”>

<import namespace = http://www.Monson-Haefel.com/jwsbook/Shipping
Location = “http://www.Monson-Haefel.com/jwsbook/wsdl/Shipping.wsdl”>

</definitions>

WSDL的import元素必须声明2个属性,即namespace属性和location属性。Namespace属性的值必须与正导入的WSDL文档中声明的targetnamespace相匹配,location属性必须指向一个实际的WSDL文档,不能为空。
       有人将location属性看成一条线索。如果读WSDL文档的应用程序在本地缓存或储存了所导入的WSDL文档的复制,那么location属性有可能要使用他们。
【特别注意】-----------------------------------------------------------------------------------------------------

Import元素的使用很容易,但它也会引起版本匹配问题。如果WSDL文档是单独维护的,那么就非常有可能出现导入的文档发生更改(希望这里大家好好想想为什么),但没有考虑导入它的WSDL文档的现象。要保证在更改导入的WSDL文档时考虑版本问题。
----------------------------------------------------------------------------------------------------------------------

       用户可以使用import元素和types元素,但应该在WSDL文档的types元素之前列出import元素。
       就WSDL的import元素的目的而言有许多的混乱。有些人认为应该用该元素导入WSDL文档或导入XML模式文档,而有些人则认为它只适用于导入WSDL文档。不同的解释引起了互操作性问题。因此,BP规定WSDL的import元素能能引用WSDL文档。如果用户用户需要导入一个XML模式元素,则应该在WSDL type元素内包含的模式定义中导入。【需要注意的是 用户不能用XML模式的import语句直接从其他一些WSDL文档的types元素中导入一个XML模式】
【WSDL抽象接口:message元素,portType元素和operation元素】-----------------------------------

Message,portType和operation元素均用于描述Web服务的抽象接口。portType元素将operation定义和message定义组合成一个与java的接口定义类似的抽象接口。portType元素描述了Web服务所支持的操作种类(即消息传递模式和有效负载),但没有指定所用的Internet协议或地址。
【message元素】-------------------------------------------------------------------------------------------------

Message元素描述了Web服务使用的消息的有效负载。Message元素可以描述输出或接收消息的有效负载,即直接发送到Web服务或直接从Web服务接收到的消息。此外,message元素可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于用户使用RPC模式或者是文档样式的消息传递模式。
 
 
 TOP
 
 

xt19833 发短消息
加为好友
xt19833 当前离线

UID394352 帖子24 精华0 金币62  代金券35  阅读权限100 在线时间20 小时 注册时间2006-12-18 最后登录2008-4-2 
进士

 

UID394352 帖子24 精华0 金币62  代金券35  阅读权限100  3楼  发表于 2007-8-29 10:28 | 只看该作者
【用于RPC样式Web服务的message元素】------------------------------------------------------
       当使用RPC样式的消息传递时,message元素描述了SOAP请求和应答消息的有效负载。这些元素可以描述调用参数,调用返回值,文件头以及错误。比如,SOAP文档中的BookQuote Web服务用2个message元素来描述该服务的参数与返回值(以后在介绍如何用消息描述错误和文件头)下面1-7例子:
<message name = “GetBookPriceRequest”>

<part name = “isnb” type = “xsd:string”>
</messgae>

<message name = “GetBookPriceResponse”>

<part name = “price” type = “xsd:float”>
</messgae>


GetBookPriceRequest消息表示参数(即输入),GetBookPriceResponse表示应答(即输出)。换句话说,GetBookPriceRequest消息藐视了从SOAP客户向BookQuote Web服务所传递的消息的有效负载,而GetBookPriceResponse消息描述了由BookQuote Web服务传递回客户的有效负载。
       其实命名消息并没有规定习惯,在我这次写的文档中,从SOAP客户传递给服务器的消息附加有后缀Request,而传递回客户的消息则附加后缀Response。大家可以采用自己的命名习惯,就是说消息名称可以是任何名称,它不过是用来标识消息定义的而已。消息元素不能将其本身声明为输入或输出(我想在operation元素中在具体加以区分吧),因此消息命名成request或response并不能确定如何使用这些消息。
       在RPC样式的消息中,消息通常分为多个部分。比如,可以用多个part元素定义一个名为GetBookPriceRequest的消息,其中每个元素表示不同的参数,如下 1-8例:
<message name = “GetBookPriceRequest”>

<part name = “isnb” type = “xsd:string”>

<part name = “quantity” type = “xsd:int” >
</messgae>

<message name = “GetBookPriceResponse”>

<part name = “price” type = “xsd:float”>
</messgae>
Web服务中的输入和输出均可以有多个部分,这一点与Java方法调用语义不同,后者允许多个参数输入,但只有一个输出(看成返回值)。然而,对于像C++,C#和Perl等这样的编程语言来说,更常见的情况是它们声明的参数即可以是输入参数,也可以是输出参数。

Wsdl是一个中性编程语言,所以它必须有足够的灵活性,从而与所有编程语言相兼容,而不是为了某个语言。SAAJ和JAX-RPC均具有用多个部分支持输出消息的功能。
【文档样式Web服务的message元素】------------------------------------------------------------------
       当用户采用文档样式消息传递模式时,message元素定义要引用types定义中的顶级元素。如下例1-9:描述一个SubmitPurchasePrder Web Services的WSDL文档,PO命名空间是以前SOAP文档中的。此例是单向消息传递模式,所以没有应答,这在文档样式中是最常见的了。

<definitions name = “SubmitPurchasePrder”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/PO
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/PO
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>

<types>


<xsd:schema
targetNamespace = “http://www.Monson-Haefel.com/jwsbook/PO”>
<!—导入这个SubmitPurchasePrder XML 规则文档-->
<xsd:import namespace = http://www.Monson-Haefel.com/jwsbook/PO
schemaLocation = http://www.Monson-Haefel.com/jwsbook/po.xsd />

 

</xsd:schema>


</types>
<message name = “SubmitPurchasePrderMessage”>

<part name = “isnb” element = “mh: purchasePrder”>
</messgae>
……………………………………………..
</definitions>
       消息部分可以声明type属性或者element属性,但不能同时声明两者。具体声明哪一种属性取决于传递消息的种类。如果用户使用的是RPC样式的消息传递,那么part元素必须使用type属性:如果用户使用的是文档样式的消息传递,part元素则必须是element属性。RPC样式的消息传递用类型来定义过程调用,该调用中每个元素表示某一类型的参数。此外,文档样式的消息传递要交换XML文档段,并引用它们的顶级元素(即全局元素)。

【声明错误消息】-----------------------------------------------------------------------------------------------
       用户可以用消息定义声明错误,其声明方式与用消息等译声明输入和输出消息的方式相同。比如下面程序2-1定义了一个错误消息,如果BookQuote请求消息包含了一个无效的ISBN,则会将该错误消息返回。它就包含一个部分,就是错误消息。

<definitions name = “BookQuote”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/PO
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/PO
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>


<types>

<xsd:schema

<xsd:element name = “InvalidIsbnFaultDetail”>

<xsd:complexType>

<xsd:sequence>


<xsd:element name = “offending-value” type = “xsd:string” />


<xsd:element name = “conformance-rules” type = “xsd:string” />

</xsd:sequence>

</xsd:complexType>

<xsd:element>

</xsd:schema>

</types>
<message name = “SubmitPurchasePrderMessage”>

<part name = “isnb” element = “mh: purchasePrder”>
</messgae>

<message name = “InvalidArgumentFault”>

<part name = “error_message” element = “mh: InvalidArgumentFault” />
</messgae>

……………………………………………..
</definitions>

【portType元素】-----------------------------------极为重点-----------------------------------------------

portType元素定义了Web服务的抽象接口。从概念上讲,该接口有点像java接口,因为它定义了一个抽象类型和它的方法,但没有定义实现。在WSDL中,portType元素是由binding元素和services元素实现的,这两个元素用于说明Web服务实现使用的Internet协议,编码方案以及Internet地址。

portType元素的“方法”是它的operation元素。portType元素可以有一个或多个operation,其中每个operation元素定义了一个RPC样式或文档样式Web服务方法。每个operation元素最多是由一个input或output元素以及任意数量的fault元素组成。
       在下面的2-2例子中名为“BookQuote”的portType元素(左列)声明了三个操作,即GetBookPrice,GetBulkBookPrice和GetBookIsbn。右为对应的Java接口。如下例:


WSDL portType定义

 
Java接口

 
<portType name = “BookQuote”>
<operation name = “GetBeokPrice”>

<input name = “isbn”
 Public interface BookQuote{

Public float getBookPrice

(String isbn);

 
Message = “mh:GetBookPriceRequest”/>

<output name = “price”
Message = “mh:GetBookPriceResponse” />
</operation>
<!----------------------------------------------->

<operation name = “GetBulkBoekPrice”>

<input name = “request”
Message = “mh: GetBulkBoekPrice”/>

<output name = “price”
Message = “mh: GetBulkBoekPrice” />
</operation>

<!----------------------------------------------->
<operation name = “GetBookIsbn”>

<input name = “title”
Message = “mh: GetBookIsbn Request”/>

<output name = “price”
Message = “mh: GetBookIsbn Response” />
</operation>
 

 

 

 


Public float getBulkBoekPrice

(String isbn,int quantity);

 

 


Public String getBookIsbn(String bookTitle);
 


WSDL,portType与java接口并不完全相同,但它们非常接近。其实,大多数给予java的Web服务代码生成器均在java接口和WSDL portType元素之间创建了映射。它们其实是根据WSDL的portType元素生成java接口,而且也可以根据简单的Java接口生成portType元素,operation元素和message元素。
WSDL文档可以有一个或多个portType元素,其中每个portType元素描述了不同Web服务的抽象接口,比如:一个WSDL Web服务可以定义一个名为BookQuote的PortType元素和一个名为SubmitpurchaseOrder的portType元素。
 
 
 TOP
 
 

xt19833 发短消息
加为好友
xt19833 当前离线

UID394352 帖子24 精华0 金币62  代金券35  阅读权限100 在线时间20 小时 注册时间2006-12-18 最后登录2008-4-2 
进士

 

UID394352 帖子24 精华0 金币62  代金券35  阅读权限100  4楼  发表于 2007-8-29 10:30 | 只看该作者
【operation元素】------------------------------------------------------------------------------------------------
       由portType元素声明的每一个operation元素要用一个或多个消息定义来定义、它的输入、输出已经错误。在2-3例子中,BookQuote portType元素将GetBookPriceRequest声明为它的input元素、将GetBookPriceRsponse声明为它的output元素、并将InvalidArgumentFault声明为它的fault元素。

<portType name = “BookQuote”>


<operation name = “getBookPrice”>

<input name = “isbn” message = “mh:GetBookPriceRequest”/>

<output name = “price” message = “mh:GetBookPriceRsponse”/>

<fault name =“InvalidArgumentFault” message = “mh: InvalidArgumentFault”>

</operation>

</portType>


Input消息表示传递到Web服务的有效负载,output消息则表示传递到客户的有效负载。在RPC样式的消息传递中,input是请求,output是客户。而在文档样式的消息传递中,input是传递到Web服务的XML文档段,output是传递回客户的XML文档段。除input消息和output消息外,一个错做可以不包含fault错误消息或包含多个fault错误消息,其中每个错误消息用于描述不同类型的错误。
【1.0 操作的参数错误】-------------------------------------------------------------------------------------
       在WSDL中,当使用RPC样式的消息传递时,要假设客户使用的是过程调用语义,比如:JAX-RPC使用带方法调用的Java RMI接口对基于SOAP的RPC样式的Web服务建立模型。很多情况下,必须按制定的顺序传输input和output消息的参数,其顺序与过程调用时所使用的参数顺序要完全相同。为了使input和output消息参数采用正确的顺序,operation元素可以声明一个parameterOrder属性。如2-4例一个名为“GetBulkBookPrice”的操作用parameterOrder属性来指定其输入和输出的参数是顺序。
<message name = “GetBulkBookPriceRequest”>

<part name = “isnb” type = “xsd:string”>

<part name = “quantity” type = “xsd:int” >
</messgae>

<message name = “GetBulkBookPriceResponse”>

<part name = “prices” type = “mh:pricet”>
</messgae>

<portType name = “GetBulkBookPrice”>

<operation name = “GetBulkBookPrice” parameterOrder = “isbn quantity”>

<input name = “isbn” message = “mh: GetBulkBookPriceRequest”/>

<output name = “price” message = “mh: GetBulkBookPriceRsponse”/>

 

</operation>

</portType>
使用ParameterOrder属性时,该属性必须包含所有输入部分,并且只包含不是返回类型的输出部分。因此,如果一个output只有一个部分(不如上面的2-4例子),那么会假设它只有一个返回值,故不应该列在ParameterOrder属性中。
如果ParameterOrder属性列出了output部分,那么会将它按OUT参数对待。当portType元素中的input和output元素用相同的名称声明了一个部分时,该部分是一个INOUT参数。而且在input和output元素中的类型必须相同。
对ParameterOrder属性含义的不同解释会引起一些互操作性问题。Basic Profile通过提供单一的ParameterOrder属性解决了问题。从发送方向接收传递的参数顺序必须符合input消息定义和output消息定义中的part声明的顺序。
ParameterOrder属性的目的是说明哪些部分是返回类型。
由ParameterOrder属性提供的列表中忽略的任何部分均假设为操作的返回类型。过程调用可以只有一个返回类型,因此只能从ParameterOrder属性中忽略一个输出部分。
【2.0操作重载】
       这里我不多说这个问题,因为这个会引起极大的互操作问题。因此BP禁止操作重载。
由portType元素定义的每个操作必须有唯一的名称,但允许2个或多个portType元素用完全相同的名称声明操作元素,因为每个portType被认为是一个单独定义。
【WSDL消息传递交换模式】------------------------------------------------------------------------------

Web服务中使用四种基本的消息交换模式(简称MEP),即请求/响应、单向、通知、以及恳求/响应模式。
       虽然WSDL支持通知和恳求/响应消息传递模式,但BP不支持它们。而且实际上用的很少。目前,大多数基于WSDL的Web服务使用请求/响应消息传递模式或单向消息传递模式,而且它们是能与J2EE Web Services 一起使用的MEP。

WSDL文档可以通过声明它的输入和输出元素来为一个具体的操作确定MEP。看下面的1-1图吧。说明了请求/响应消息传递模式或单向消息传递模式的区别。


【1.0请求/响应消息传递】-------------------------------------------------------------------------------------
       在请求/响应消息传递中,客户通过向Web服务发送请求消息来启动通信,而且Web服务要用响应消息来应答。
       如果用一个input元素和一个output元素(output元素位于input元素之后)声明operation,那么它会定义一个请求/响应操作。通过首先列出input元素,operation表示Web服务接收到最初由客户发送的消息:将output元素列在input元素之后,则表示Web服务对消息给于响应,下面2-5例子,表示一个只使用一个input和一个output元素的经典请求/响应模式。
<portType name = “GetBulkBookPrice”>

<operation name = “GetBulkBookPrice” >

<input name = “isbn” message = “mh: GetBulkBookPriceRequest”/>

<output name = “price” message = “mh: GetBulkBookPriceRsponse”/>

 

</operation>
</portType>
       请求/响应操作除了使用一个input元素和一个output元素外,还可以包含多个fault元素。Fault元素要在错误事件中返回给客户。(个人建议弄清客户的含义)请求/响应操作可以没有错误或有多个错误,如下2-6例:
<portType name = “GetBulkBookPrice”>

<operation name = “GetBulkBookPrice” >

<input name = “isbn” message = “mh: GetBulkBookPriceRequest”/>

<output name = “price” message = “mh: GetBulkBookPriceRsponse”/>

<fault name =“InvalidArgumentFault” message = “mh: InvalidArgumentFault”>

<fault name =“SecurityFault” message = “mh: SecurityFault”>

 

</operation>
</portType>
【2.0单向消息传递】--------------------------------------------------------------------------------------------
       在单向消息传递中,客户将消息传递给Web服务,但不期待应答。此MEP通常被认为是异步消息传递。
       单项消息传递是当今仅次于请求/响应消息传递的流行MEP。
       如果用一个input但没有使用output声明了一个操作,那么就定义了一个单向操作。如果只列出了input消息,那么operation表示客户要把消息发送到Web服务,但不期待应答。下面2-7例子说明了一个简单的单向操作SubmitPuraseOrder PortType。
<portType name = “SubmitPuraseOrder PortType”>

<operation name = “SubmitPuraseOrder” >

<input name = “isbn” message = “mh: SubmitPuraseOrderMessage”/>

</operation>
</portType>
       单向操作与请求/响应操作不同。单向操作不可以指定错误,也不需要生成错误消息。单向消息传递模式是严格但方向的,不能把错误传递回客户。
【通知和恳求/响应消息传递】----------------------------------------------------------------------------

J2EE Web Services中不能使用通知和恳求/响应MEP。J2EE Web Services 之所以不支持他们,其原因是因为WSDL1.1规范不能很好的标识他们。而且它们带来的问题比它们所解决的问题还要多,但我们可以理解~~呵呵。
       在通知消息传递中,Web服务将消息发送给客户,但并不期望应答消息。使用通知MEP的Web服务符合分布计算的推模式(Push model 不能理解的可以去百度里搜),假设客户向Web服务进行了注册,以便接收有关一个事件的消息(看成通知)。通过注册来接收通知的客户称为订阅者(Subscriber)。在通知消息传递中,portType包含一个output元素,但不包含input消息定义。
       恳求/响应类似于通知,但客户要期待对Web服务的响应。与通知消息传递一样,恳求/响应Web服务的客户必须订阅服务以便接收消息。在该MEP里,portType元素首先要声明output消息,然后才是input消息。顺序相反。
 
 
 TOP
 
 

xt19833 发短消息
加为好友
xt19833 当前离线

UID394352 帖子24 精华0 金币62  代金券35  阅读权限100 在线时间20 小时 注册时间2006-12-18 最后登录2008-4-2 
进士

 

UID394352 帖子24 精华0 金币62  代金券35  阅读权限100  5楼  发表于 2007-8-29 10:32 | 只看该作者
----------------------------------------------------------------------------------------------------------------------

这里是WSDL文档的一个段落


----------------------------------------------------------------------------------------------------------------------
【WSDL实现:binding元素】

Binding元素将一个抽象portType映射到一组具体协议(如SOAP和HTTP)、消息传递模式(RPC或文档)以及编码样式(字面或SOAP编码)。

Binding元素及其子元素与协议专用的元素组合在一起使用。Binding元素确定出正在绑定的portType元素和operation元素、而协议专用的元素声明与portType关联的协议与编码样式。
       每种类型的协议(如果SOAP、HTTP和MIME)有其自己的一组协议专用元素和其自己的命名空间。如下3-1例声明了将BookQuote portType绑定到使用SOAP专用协议元素的SOAP1.1协议。。。

<?xml version = “1.0” encoding= “UTF-8”>
<definitions name = “BookQuoteWS”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>

。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。

<!—binding 告诉了我们哪些协议和内码样式被使用-->

<binding name = “BookPrice Binding” type = “mh:BookQuote”>

<soapbind:binding style = “rpc”
Transport = http://schemas.xmlsoap.org/soap/http/>
<operation name = “getBookPrice”>

<soapbind: operation styles = “rpc”
Soap:Action =
http://www.Monson-Haefel.com/jwsbook/BookQuote/GetBookPrice/>
<input>

<soapbind.body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</input>

<output>

<soapbind:body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</output>

</operation>

</binding>
。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。。
</definitions>
       我向大家要注意的第一个问题是此例中声明的binding元素实际上是由2个不同的命名空间组成的,没有命名空间前缀的元素是WSDL1.1命名空间http://schemas.xmlsoap.org/wsdl啊成员。此命名空间是WSDL文档的默认命名空间。WSDL1.1通用的绑定元素是binding、operation、input和output。另外,soapbind:binding,soapbind:operation和soapbind:body元素是协议专用的元素,它们是SOAP-WSDL绑定的命名空间http://schemas.xmlsoap.org/wsdl/soap的成员。在来看看3-2的实例:

<?xml version = “1.0” encoding= “UTF-8”>
<definitions name = “BookQuoteWS”
targetNamespace = http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:mh=http://www.Monson-Haefel.com/jwsbook/BookQuote
xmlns:soapbind=http://schemas.xmlsoap.org/wsdl/soap/
xmlns:xsd=http://www.w3.org/2001/XMLScheam
xmlns=”http://schemas.xmlsopa.org/wsdl”>

<!—binding 告诉了我们哪些协议和内码样式被使用-->

<binding name = “BookPrice Binding” type = “mh:BookQuote”>

<soapbind:binding style = “rpc”
Transport = http://schemas.xmlsoap.org/soap/http/>
<operation name = “getBookPrice”>

<soapbind: operation styles = “rpc”
Soap:Action =
http://www.Monson-Haefel.com/jwsbook/BookQuote/GetBookPrice/>
<input>

<soapbind.body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</input>

<output>

<soapbind:body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</output>

</operation>

</binding>
</definitions>

Soapbind:binding元素和soapbind:body元素用于表示Web服务的SOAP专用细节,比如:soapbind:binding说明了消息样式是RPC,并且网络应用协议是HTTP。Soapbind:body元素说明了输入和输出均使用了字面编码。后面会详细接触到SOAP绑定元素。

Binding元素的子元素(operation、input、output元素)可以直接映射到portType元素的子元素。如下3-3:
<portType name = “BookQuote”>

<operation name = “getBookPrice”>

<input name = “isbn” message = “mh:GetBookPriceRequest” />

<output name = “price” message = “mh:GetBookPriceRsponse” />

</operation>
</portType>

<binding name = “BookPrice Binding” type = “mh:BookQuote”>
<soapbind:binding style = “rpc”
Transport = http://schemas.xmlsoap.org/soap/http
/>
<operation name = “getBookPrice”>

<soapbind: operation styles = “rpc”
Soap:Action =
http://www.Monson-Haefel.com/jwsbook/BookQuote/GetBookPrice/>
<input>

<soapbind.body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</input>

<output>

<soapbind:body use = “literal”
Namespace = http://www.Monson-Haefel.com/jwsbook/BookQuote />

</output>

</operation>
</binding>
====================================================================
portType元素的name属性对应着binding元素的 type属性。
portType元素中的operation元素的 name属性对应着binding元素中的operation元素中的name属性
portType元素中的operation元素的input和output元素分别与binding元素中的operation元素中的input和output属性对应。
====================================================================
       虽然到目前为止给出的绑定示例均使用SOAP绑定元素,但WSDL规范上实际还是为HTTP和MIME定义了其他两个协议专用绑定。如下3-4:
<!—HTTP/MIME-binding of BookQuote-->
<binding name = “BookPrice_HttpMimeBinding” type = “mh:BookQuote”>

<Http:binding verb = “GET”>

<operation name = “getBookPrice”>

<http:operation location = “alt.http.service” />

<input>

<http:urlEncoded/>

</input>

<output>

<mime:content type = “text/html”>

</output>

</operation>
</binding>
       虽然WSDL1.1允许使用MIME绑定和HTTP绑定(如上例),但Basic Profile不允许使用这两种绑定,因为他们的文档结构很差。
       此限制只适合BP1.0 WS-I已声明它将下一个版本的Basic Profile中扩展对SwA的支持。其中包括WSDL MIME绑定。 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值