当前位置：文档之家 › WebService之WSDL

WebService之WSDL

  • 格式：doc
  • 大小：85.50 KB
  • 文档页数：8

一，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、以及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=/jwsbook/BookQuotexmlns:mh=/jwsbook/BookQuotexmlns:soapbind="/wsdl/soap/"xmlns:xsd=/2001/XMLSchemaxmlns="/wsdl/">definition元素中一般包括若干个XML命名空间；/wsdl/是默认的命名空间，这样就可以不用显式地定义每一个WSDL元素的命名空间了，例如：<ty pes><messages><portType>…；文档中所有的元素缺省应该属于这个命名空间。

defi nition元素的的一个属性是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元素通常被称为定义。

文档中的其他元素用标签和命名空间前缀去应用定义，例如上面的例子中：input元素是使用mh:GetBookPriceRequest来引用标签GetBookPriceRequest。

3.3 Types元素Types元素用作一个容器，定义了自定义的特殊数据类型，在声明消息部分（有效负载）的时候，messages定义使用了types元素中定义的数据类型与元素。

<?xml version="1.0" encoding="UTF-8"?><definitions name="BookQuoteWS"targetNamespace=/jwsbook/BookQuotexmlns:mh=/jwsbook/BookQuotexmlns:soapbind=/wsdl/soap/xmlns:xsd=/2001/XMLSchemaxmlns="/wsdl/"><types><xsd:schema targetNamespace="/jwsbook/Boo kQuote"><!-- The ISBN simple type --><xsd:simpleType name="ISBN"><xsd:restriction base="xsd:string"><xsd:pattern value="[0-9]{9}[0-9Xx]"/></xsd:restriction></xsd:simpleType></xsd:schema></types>Types元素作为一个容器，用来定义XML模式内置的数据类型（即复杂类型和定制的简单类现，详细见Web Service XML文章）中没有描述的各种数据类型。

例如：ISBN。

上面的例子中，types元素中直接嵌套了一个完整的W3C XML模式文档，此文档中targetNamespace必须是一个有效的非空值，而且必须属于由WSDL文档。

3.4 Import元素Import元素可以让当前的文档使用其他WSDL文档中指定命名空间中的定义。

<definitions name="AllMhWebServices"xmlns="/wsdl/"><import namespace=/jwsbook/BookQuote location="/jwsbook/BookPrice.wsdl"/><import namespace=/jwsbook/polocation="/jwsbook/wsdl/PurchaseOrder.wsdl"/> <import namespace=/jwsbook/Shippinglocation="/jwsbook/wsdl/Shipping.wsdl"/></definitions >WSDL的import元素必须声明两个属性，即namespace属性和location 属性。

namespace属性必须和正导入的WSDL文档中声明的targetNamespace相匹配。

location属性必须指向一个实际的WSDL文档。

四、WSDL抽象接口Message、portType和operation元素用于描述Web服务的抽象接口，相当于JAVA 或者C++中编程中的类的接口。

其中portType相当于类接口的名称；operation相当于接口中包含的函数，message相当于函数的参数和返回值。

4.1 Message元素Message元素描述了Web服务的有效负载。

相当于函数调用中的参数和返回值。

<message name="GetBulkBookPriceRequest"><part name="isbn" type="xsd:string"/><part name="quantity" type="xsd:int"/></message><message name="GetBulkBookPriceResponse"><part name="price" type="mh:prices"/></message>RPC式样的Web服务的message服务GetBulkBookPriceRequest表示消息的输入（相当于函数的参数），GetBulkBookPriceResponse表示消息的输出（相当于函数的返回值）We b Service的输入和输出参数可以是多个（一个特点），每一个输入或者输出使用part元素定义，RPC样式必须使用type来定义类型RPC样式用类型来数据定义过程调用，调用中的每一个元素表示某一个类型的参数。

<types><xsd:schema targetNamespace="/jwsbook/PO"> <!-- Import the PurchaseOrder XML schema document --><xsd:import namespace=/jwsbook/PO schemaLocation="/jwsbook/po.xsd"/></xsd:schema></types><!-- message elements describe the input and output parameters --><message name="SubmitPurchaseOrderMessage"><part name="order" element="mh:purchaseOrder"/></message>文档式样Web服务的Messages元素：当用户采用文档式样消息传递模式的时候，messag es元素要应用types定义中的顶级元素。

合集下载

springboot项目整合webservice，wsdl生成客户端，服务端文件

springboot项目整合webservice，wsdl生成客户端，服务端文件

springboot项⽬整合webservice，wsdl⽣成客户端，服务端⽂件这是⼀次实际的项⽬对接经验，⼚家提供⽂档，我们这边根据⽂档⽣成接⼝。

对初次对接的⼈来说很有帮助。

1.⼚家提供wsdl⽂件、我们这边⽣成客户端，然后发送⼯单，注⼊数据。

2.⼚家提供wsdl⽂件、我们这边⽣成服务端，然后接收⼚家的回调3.本次实现⼜是请教别⼈，⼜是各种查⽂档，⼜是各种bug摸索。

先导⼊依赖本次项⽬步骤 1.根据⼚家提供的wsdl⽣成客户端代码，然后注⼊内容。

⼚家⼀般都是提供⼀个地址，然后访问地址下载wsdl⽂件。

2.我是在linux上使⽤wget，然后下载格式：wget ⼚家地址 3.下载之后是个wsdl⽂件 4.我是⽤eclipse⽣成的客户端代码（idea我没找到，抱歉） 将上⼀步提供的wsdl⽂件拷贝到⼀个项⽬中，随便创建⼀个java项⽬，然后按照途中步骤依次执⾏，就会⽣成客户端代码。

5.将⽣成的客户端代码，拷贝到实际项⽬中，⾥⾯有很多报错，需要加上项⽬的⽬录结构，其他不要动，就会全部解决掉爆红的问题。

6.再就是具体的业务逻辑，然后⽣成xml⽂件，这⾥就不叙述了。

下⼀步就是注⼊(⽣成的客户端⽂件名称不⼀样，也不要慌，就看结尾⼀样的就⾏)　7.以上就是根据wsdl⽣成客户端代码，然后注⼊xml内容　8.写⼀个服务端，根据⼚家提供的wsdl⽂件，写服务端代码。

记住是服务端的wsdl⽂件，没有的可以询问下⼚家。

　9.分析wsdl⽂件⽣成接⼝、接⼝的⽅法、⽅法的参数顺序，类型、返回值。

具体会在项⽬中截图，看看就明⽩了。

10.项⽬中的⽬录结构等等 在java⽬录下创建⽂件夹，boot启动类上需要添加扫描，不然⽆法交给容器管理。

11.这个接⼝跟上⾯分析的xml是⼀样的，不过是换成代码了。

12.这⾥是实现类，具体是对返回的回调进⾏处理。

修改注⼊的状态等等 13.服务端写好之后，需要提供地址给⼚家，不然他找不到调⽤接⼝的地址。

生成WebService简易文档

生成WebService简易文档

根据java类生成WebService0、先从菜单上选择自动编译，此项一定要选。

1、右键点击需要生成WebService的类，选择“create Web service”2、出现如图所有对话框，配置好后，点击“next”3、出现如下对话框勾上你想公布的WebService 接口方法，其他默认，点击下一步即可，注意要publish 该工程，否则可能无法生成server-config.wsdd ，导致后期无法部署该服务。

此处选择到“start service ”的位置 如果需要同时生成客户端，这里可以适当选择勾上这里这里配置成测试的容器注意这里的EAR 不要选错1.新建项目（Dynamic Web Project）2.填写正确的项目，一路“next”直到完成。

3.新建文件夹wsdl，把厂家提供的wsdl文件放入该文件夹下。

4.5.将文件server-config.wsdd文件copy到WebContent/WEB-INF下面6.7.8.Finsh完成后，修改增加配置文件server-config.wsdd，服务端代码增加在ISPPNPIserviceImpl.java类中，至此，服务端开发已经完成，可以打包ear部署测试。

AAA客户端新建步骤：项目名为NPIServiceAAAClient 1.新建项目（Java Project）2.3.4.新建文件夹wsdl，把厂家提供的wsdl文件放入该文件夹下。

5.6.把lib包copy到项目下，并且添加到项目：7.8.把XmlToRoot.java和RootToXml.java两个类copy放到.ispp.ispp_npi包下。

将Msg_head.java和ResponseSubClass.java中的成员变量设置成public，注意：private ng.String name; // attribute这些属性不要改，保持private。

至此，客户端开发已经完成，可以打包jar测试注意事项：（安徽测试ivpn发现的问题）1.wsdl文件应该取独立的wsdl，不取接口文档里面的，生成客户端代码的时候先修改命名空间为/ivpn/而不是默认的/ispp_npi/2、命令配置：（增加集团）注意节点<?xml version="1.0" encoding="GB2312"?><Interface_msg><Directive><ServiceClass Name="CSService"><ServiceSubClass Name="CSVpnGroupService"><Method Name="CreateVPN"><VPNNUM>9999</VPNNUM><VPNNAME>99</VPNNAME><VPNTYPE>99</VPNTYPE><SERVICESTART>99</SERVICESTART><SERVICESTOP>99</SERVICESTOP><HALL>99</HALL><FEEGROUP>99</FEEGROUP><VPNKIND>99</VPNKIND></Method></ServiceSubClass></ServiceClass></Directive></Interface_msg>3、注意命名空间/ivpn/不是4、乱码问题没解决5、xmltoroot类中elemList = new ArrayList<Leaf>();不能定义为static，否则就会每次发送的xml是一样的Ppc ews_id=23531。

如何查看WSDL文档

如何查看WSDL文档

如何查看WSDL文档经过前面的几个例子，想必大家对webService有了初步的了解，当然只是照着模板写代码而已，要正确的调用别人的webService服务，读懂WSDL说明书非常重要，在这里我们就一起来讨论一下如何正确的查看WSDL文档。

启动服务，进入wsdl文件，以上一个自定义的服务而言就是输入http://localhost:8888/sayHello?wsdl进入到WSDL页面：查看WebService服务名前面说过，看这个服务的名字是从最底下开始看的，所以我们先把网页拉到最下面：可以看到这个服务里面还包含了端口（port），在前面，我把端口写成服务的集合（serviceList），理由是：一个服务下面包含多个具体的小功能。

查看端口信息除此之外，还可以看到这个端口的具体信息，虽然这段标签里面没有详细的写，但是有一个绑定（binding），我们复制绑定中的内容，然后在页面中查找。

查看参数和返回值从里面我们可以看到刚刚自定义的方法：sayHello,里面也有输入和输出标签，但是没有详细的指明数据类型，根据刚刚的经验，我们继续从这个标签中的type='tns:HelloWS'中查找，复制后半部分，即HelloWS，继续进行查找：如大家所见，每次的查找都能找出很多个结果，但是我们要找到完全匹配的结果！在这个标签中，我们看到了这里把输入和输出又封装起来了，于是我们继续根据后面提示的名称空间：名称来查找。

这次的查找结果有两个完全匹配，但是由于这里的提示是message，所以我们要看上面那个结果！但是这个结果好像指向了自己，这样就没意思了……但是仔细想想，有没有可能在另外一个文档里面，毕竟在开头的标签中还有另外一个地址：打开该链接：其中的参数类型就一目了然了……。

webservice的组成

webservice的组成

webservice的组成WebService 是一种基于 XML 和 HTTP 协议的远程通信技术，通过网络提供应用程序之间的交互性和互操作性。

它是一种服务导向架构（Service-Oriented Architecture，SOA）的实现方式之一。

WebService 可以使用简单对象访问协议（Simple Object Access Protocol，SOAP）和 Web 服务描述语言（Web Services Description Language，WSDL）来描述和访问。

WebService 的组成包括：SOAP、WSDL、UDDI、XML 和HTTP。

SOAP（Simple Object Access Protocol）是一种基于 XML 的协议，用于在 Web 应用程序之间进行通信。

它定义了消息的结构和传输方式，使得不同平台上的应用程序能够相互通信和交换数据。

SOAP 是一种独立于语言和平台的协议，支持基于HTTP、SMTP、FTP 等传输协议，可以保证数据的安全性和可靠性。

WSDL（Web Services Description Language）是一种用于描述Web 服务的语言。

它定义了 Web 服务的接口、参数和消息格式。

WSDL 使用XML 描述Web 服务的组成部分，包括消息、端口、操作和绑定。

通过 WSDL，客户端可以了解 Web 服务的功能和调用方式，实现和使用 Web 服务的互操作性。

UDDI（Universal Description, Discovery and Integration）是一个用于注册和发现 Web 服务的目录服务。

它提供了一个公共的注册表，用于存储 Web 服务的描述信息，以便客户端可以通过查找和查询来找到需要的服务。

UDDI 使用标准的 XML 和 SOAP 协议来进行通信，并提供了一组 API 接口，方便开发人员进行注册和发现的操作。

XML（eXtensible Markup Language）是一种用于定义可扩展标记语言的语法和结构。