WebService之WSDL.doc

一，WSDL概述 ??????? WebServices Description Language (WSDL Web服务语言)是一个用于精确描述Web Service的文档格式。 ??????? WSDL非常适合于用作代码生成器，它能够读取WSDL文档，并且可以为访问Web服务生成一个程序化的接口，大多数软件供应商和主要的标准机构（包括 W3C、WS-I和OASIS）都支持WSDL。例如：JAX-RPC provider（例如：BEA Weblogic）通过API用WSDL生成相应的占位程序；IBM WebSphere、Microsoft.NET以及Apache Axis都有自己的工具生成相关的代码。下图是一个例子： ?????????????????????????????? ??????? ?????? 上面的例子JAX-RPC通过读取WSDL文档，创建JAX-RPC RMI接口（endpoint接口）和实现此接口的网络占位程序（stub）。客户端程序通过RMI接口，Stub和Web Service服务端交换SAOP消息。 二、WSDL基本结构 ??????? WSDL文档是一个遵循WSDL XML模式的XML文档（文档实例）；类似于：SOAP文档是一个遵循SOAP XML模式的XML文档（文档实例）； ??????? 一个WSDL文档的根元素是definitions元素，WSDL文档包含7个重要的元素：types, import, message, portType, operations, binding和service元素。 三、WSDL声明 ?????? ?????? ?3.1 XML声明 ?????????? ?xml?version=1.0?encoding=UTF-8? WSDL的声明必须定义成使用：UTF-8 或者UTF-16 编码。 ??3.2 definition元素 ????????????? 所有WSDL文档的根元素都是definition元素。??? definitions?name=BookQuoteWS ????????????????????? targetNamespace=http://www.Monson-H/jwsbook/BookQuote xmlns:mh=http://www.Monson-H/jwsbook/BookQuote ????????????????????? xmlns:soapbind=/wsdl/soap/ ??????????????????????? xmlns:xsd=/2001/XMLSchema ???????????????????? xmlns=/wsdl/ ? definition元素中一般包括若干个XML命名空间； ?/wsdl/是默认的命名空间，这样就可以不用显式地定义每一个WSDL元素的命名空间了，例如：types?messages?portType…；文档中所有的元素缺省应该属于这个命名空间。 definition元素的的一个属性是name，此属性不重要可以没有； ? ?定义了targetNamespace命名空间，它为在模式中显式创建的所有新类型均声明了XML命名空间，而且上面的例子中赋予了mh前缀。 !--?message?elements?describe?the?input?and?output?parameters?-- message?name=GetBookPriceRequest ?????? part?name=isbn?type=xsd:string?/ /message message?name=GetBookPriceResponse ???? part?name=price?type=xsd:float?/ /message !--?portType?element?describes?the?abstract?interface?of?a?Web?service?-- portType?name=BookQuote ??? operation?name=getBookPrice ????????? input?name=isbn?message=mh:GetBookPriceRequest/ ????????? output?name=price?message=mh:GetBookPriceResponse/ ?? /operation /portType ? ???????? 上面的例子中：message元素利用name属性指定了标签（例如：GetBookPriceRequest），这些标签会自动使用targetNamespace的命名空间，标签了的messages元素通常被