WSDL实例解析(1)

XML 前端之家
前端之家收集整理的这篇文章主要介绍了WSDL实例解析(1)，前端之家小编觉得挺不错的，现在分享给大家，也给大家做个参考。

WSDL文档可以分为两部分。顶部分由抽象定义组成，而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息，它们并不包含任何随 机器或语言而变的元素。这就定义了一系列服务，截然不同的应用都可以实现。具体部分，如数据的序列化则归入底部分，因为它包含具体的定义。在上述的文档元 素中，<types>、<message>、<portType>属于抽象定义 层，<binding>、<service>属于具体定义层。所有的抽象可以是单独存在于别的文件中，也可以从主文档中导入。

WSDL文档的结构实例解析
下面我们将通过一个实际的WSDL文档例子来详细说明各标签的作用及关系。

Wsdl代码
  1. <?xmlversion="1.0"encoding="UTF-8"?>
  2. <definitions
  3. xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
  4. xmlns:tns="http://www.jsoso.com/wstest"
  5. xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  6. xmlns="http://schemas.xmlsoap.org/wsdl/"
  7. targetNamespace="http://www.jsoso.com/wstest"
  8. name="Example">
  9. <types>
  10. <xsd:schema>
  11. <xsd:import
  12. namespace="http://www.jsoso.com/wstest"
  13. schemaLocation="http://localhost:8080/hello?xsd=1"></xsd:import>
  14. </xsd:schema>
  15. </types>
  16. <messagename="toSayHello">
  17. <partname="userName"type="xsd:string"></part>
  18. </message>
  19. <messagename="toSayHelloResponse">
  20. <partname="returnWord"type="xsd:string"></part>
  21. <messagename="sayHello">
  22. <partname="person"type="tns:person"></part>
  23. <partname="arg1"type="xsd:string"></part>
  24. <messagename="sayHelloResponse">
  25. <partname="personList"type="tns:personArray"></part>
  26. <messagename="HelloException">
  27. <partname="fault"element="tns:HelloException"></part>
  28. <portTypename="Example">
  29. <operationname="toSayHello"parameterOrder="userName">
  30. <inputmessage="tns:toSayHello"></input>
  31. <outputmessage="tns:toSayHelloResponse"></output>
  32. </operation>
  33. <operationname="sayHello"parameterOrder="personarg1">
  34. <inputmessage="tns:sayHello"></input>
  35. <outputmessage="tns:sayHelloResponse"></output>
  36. <faultmessage="tns:HelloException"name="HelloException"></fault>
  37. </portType>
  38. <bindingname="ExamplePortBinding"type="tns:Example">
  39. <soap:binding
  40. transport="http://schemas.xmlsoap.org/soap/http"
  41. style="rpc"></soap:binding>
  42. <operationname="toSayHello">
  43. <soap:operationsoapAction="sayHello"></soap:operation>
  44. <input>
  45. <soap:bodyuse="literal"
  46. namespace="http://www.jsoso.com/wstest"></soap:body>
  47. </input>
  48. <output>
  49. </output>
  50. <operationname="sayHello">
  51. <faultname="HelloException">
  52. <soap:faultname="HelloException"use="literal"></soap:fault>
  53. </fault>
  54. </binding>
  55. <servicename="Example">
  56. <portname="ExamplePort"binding="tns:ExamplePortBinding">
  57. <soap:addresslocation="http://localhost:8080/hello"></soap:address>
  58. </port>
  59. </service>
  60. </definitions>

由于上面的事例XML较长，我们将其逐段分解讲解

WSDL文档的根元素：＜definitions＞

Xml代码
    <definitions
  1. xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
  2. xmlns:tns="http://www.jsoso.com/wstest"
  3. xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  4. xmlns="http://schemas.xmlsoap.org/wsdl/"
  5. targetNamespace="http://www.jsoso.com/wstest"
  6. name="Example">
  7. ……
  8. </definitions>

＜definitions＞定义了文档中用到的各个xml元素的namespace缩写，也界定了本文档自己的 targetNamespace="http://www.jsoso.com/wstest"，这意味着其它的XML要引用当前XML中的元素时，要声 明这个namespace。注意xmlns:tns="http://www.jsoso.com/wstest"这个声明，它标示了使用tns这个前缀 指向自身的命名空间。

WSDL文档数据类型定义元素：<types>

typesxsd:schemaxsd:import
  • namespace="http://www.jsoso.com/wstest"
  • schemaLocation="http://localhost:8080/hello?xsd=1">xsd:import <types>标签定义了当前的WSDL文档用到的数据类型。要说明的是，为了最大程度的平台中立性，WSDL 使用 XML Schema 语法来定义数据类型。这些数据类型用来定义web service方法的参数和返回指。对于通用的原生数据类型如：integer,boolean,char,float等，在W3C的标准文档http://www.w3.org/2001/XMLSchema中已经做了定义。这里我们要引入的schema定义 schemaLocation="http://localhost:8080/hello?xsd=1"是我们自定义的Java对象类型。

    WSDL文档消息体定义元素：< message >

    messagename="toSayHello"partname="userName"type="xsd:string"partmessagemessagename="toSayHelloResponse"partname="returnWord"type="xsd:string"messagename="sayHello"partname="person"type="tns:person"partname="arg1"type="xsd:string"messagename="sayHelloResponse"partname="personList"type="tns:personArray"messagename="HelloException"partname="fault"element="tns:HelloException" ＜message＞元素定义了web service函数的参数。＜message＞元素中的每个＜part＞子元素都和某个参数相符。输入参数在＜message＞元素中定义，与输出参数相 隔离，输出参数有自己的＜message＞元素。兼作输入、输出的参数在输入输出的＜message＞元素中有它们相应的＜part＞元素。输出 ＜message＞元素以"Response"结尾，对Java而言方法得返回值就对应一个输出的＜message＞。每个＜part＞元素都有名字和类 型属性，就像函数的参数有参数名和参数类型。

    在上面的文档中有两个输入参数、两个输出参数和一个错误参数（对应Java中的Exception）。

     输入参数＜message＞的name属性分别命名为toSayHello，sayHello。
    toSayHello对应输入参数userName，参数类型为xsd:string，在Java语言中就是String；
    sayHello对应两个输入参数person和arg1，类型为tns:person和xsd:string。这里tns:person类型就是引用了< types >标签中的类型定义。

    输出参数＜message＞的name属性分别命名为toSayHelloResponse和sayHelloResponse。
    这个名称和输入参数的＜message＞标签name属性对应，在其后面加上Response尾缀。
    toSayHelloResponse对应的返回值是returnWord，参数类型为xsd:string；
    sayHelloResponse对应的返回值是personList，参数类型为tns:personArray（自定义类型）；

    错误参数＜message＞的name属性为HelloException。
    它的<part>子标签element而不是type来定义类型。

    以上的message标签的name属性通常使用web service函数方法名作为参照，错误参数标签则使用异常类名为参照。标签中的参数名称，即part子元素的name属性是可自定义的（下一章节详细说 明）。message标签的参数类型将引用types标签的定义。

    WSDL文档函数体定义元素：< portType >

    portTypename="Example"operationname="toSayHello"parameterOrder="userName"inputmessage="tns:toSayHello"inputoutputmessage="tns:toSayHelloResponse"outputoperationoperationname="sayHello"parameterOrder="personarg1"inputmessage="tns:sayHello"outputmessage="tns:sayHelloResponse"faultmessage="tns:HelloException"name="HelloException"faultportType
    在<operation>元素中，name属性表示服务方法名，parameterOrder属性表示方法的参数顺序，使用空格符分割多个参 数，如：“parameterOrder="person arg1”。<operation>元素的子标签<input>表示输入参数说明，它引用＜message＞标签中的输入参 数。<output>表示输出参数说明，它引用＜message＞标签中的输出参数。<fault>标签在Java方法中的特别 用来表示异常（其它语言有对应的错误处理机制），它引用＜message＞标签中的错误参数。

    WSDL绑定实现定义元素：< binding >

    bindingname="ExamplePortBinding"type="tns:Example"soap:binding
  • transport="http://schemas.xmlsoap.org/soap/http"
  • style="rpc"soap:bindingoperationname="toSayHello"soap:operationsoapAction="sayHello"soap:operationsoap:bodyuse="literal"
  • namespace="http://www.jsoso.com/wstest"soap:bodyoperationname="sayHello"faultname="HelloException"soap:faultname="HelloException"use="literal"soap:faultbinding <binding>标签是完整描述协议、序列化和编码的地方，<types>,<message>和<portType>标签处理抽象的数据内容，而<binding>标签是处理数据传输的物理实现。
    <binding>标签把前三部分的抽象定义具体化。

    首先<binding>标签使用<soap:binding>的transport和style属性定义了Web Service的通讯协议HTTP和SOAP的请求风格RPC。其次<operation>子标签将portType中定义的 operation同SOAP的请求绑定，定义了操作名称soapAction，输出输入参数和异常的编码方式及命名空间。

    WSDL服务地址绑定元素：< service >

    servicename="Example"portname="ExamplePort"binding="tns:ExamplePortBinding"soap:addresslocation="http://localhost:8080/hello"soap:addressportservice service是一套＜port＞元素。在一一对应形式下，每个＜port＞元素都和一个location关联。如果同一个＜binding＞有多个＜port＞元素与之关联，可以使用额外的URL地址作为替换。 一个WSDL文档中可以有多个＜service＞元素，而且多个＜service＞元素十分有用，其中之一就是可以根据目标URL来组织端口。在一个 WSDL文档中，＜service＞的name属性用来区分不同的service。在同一个service中，不同端口，使用端口的"name"属性区 分。 简单的描述了WSDL对SOAP协议的支持，以及在Web Service中的作用。

    原文链接：https://www.f2er.com/xml/298750.html

    • 猜你在找的XML相关文章

    10分钟掌握XML、JSON及其解析
    引言 NOKIA 有句著名的广告语：“科技以人为本”。任何技术都是为了满足人的生产生活需要而...
    [CXF REST标准实战系列] 一、JAXB xml与javaBean的转换
    Writer：BYSocket（泥沙砖瓦浆木匠） 微博：BYSocket 豆瓣：BYSocket Reprint it anywhere...
    [CXF REST标准实战系列] 一、JAXB xml与javaBean的转换
    Writer：BYSocket（泥沙砖瓦浆木匠） 微博：BYSocket 豆瓣：BYSocket Reprint it anywhere...
    10分钟掌握XML、JSON及其解析
    http://blog.jobbole.com/79252/ 引言 NOKIA 有句著名的广告语：“科技以人为本”。任何技...
    自定义圆形控件RoundImageView并认识一下attr.xml
    (点击上方公众号，可快速关注) 公众号：smart_android 作者：耿广龙｜loonggg 点击“阅读原...
    10分钟掌握XML、JSON及其解析
    引言 NOKIA 有句著名的广告语：“科技以人为本”。任何技术都是为了满足人的生产生活需要而...
    10分钟掌握XML、JSON及其解析(上)
     (点击上方公众号，可快速关注) 来源： Long Luo 的博客 链接：http://longluo.github.i...
    10分钟掌握XML、JSON及其解析(中)
    接上文 二、JSON XML很好很强大，但是最近有另外一个时代弄潮儿，这就是JSON。现在JSON的光...
    10分钟掌握XML、JSON及其解析(下)
    接上文 2.4 如何解析JSON？ Android JSON所有相关类，都在org.json包下。 包括JSONObject、...
    10分钟掌握XML、JSON及其解析
    原文出处：  Long Luo 的博客（@Long_Luo）   引言 NOKIA 有句著名的广告语：“科技以人...
    HTMLHTML5JavaScriptCSSjQueryBootstrapAngularjsTypeScriptVueDojoJsonElectronNode.jsextjsExpress XMLES6AjaxFlashUnityReactFlexAnt DesignWeb前端微信小程序微信公众号
    关闭广告单独headers封装代码提示错误整数正则非0开头跳页出页码antd table提示URL未注册公众号支付vue hash模式iSlider车牌键盘循环图片echarts 双折左右布局DllPlugin对象创建打字游戏圈选两栏云函数蒙版ES2020橱窗无缝滚动轮播色块碰撞组件销毁文档操作