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

WSDL 文档

  • 格式：doc
  • 大小：229.50 KB
  • 文档页数：19

为什么使用WSDL?http://zx/saasservice/MainOneService.asmx像Internet协议之类的标准有没有为权威所利用，或者人们这样看待它是因为顺之所获的好处远远超出了代价？曾经有许多试图建立的标准都流产了。

有时候，那些还没有普遍使用的标准甚至由法令或政府规定强行推出：Ada语言就是一例。

我相信正是跟随标准所带来的好处使它广泛接受。

例如，对于铁路服务来说，真正重要的是，不同公司所铺设的铁路结合到一起，或者是来自好几个公司的产品协调的工作在一起。

几家大的企业合力建立了SOAP标准。

Web Service描述语言(WSDL)向这种Web Service的提供商和用户推出了方便的协调工作的方法，使我们能更容易的获得SOAP的种种好处。

几家公司的铁道并在一起不算什么难事，他们所需遵循的只是两轨间的标准距离。

对Web Service来说，这要复杂得多。

我们必须先制定出指定接口的标准格式。

曾经有人说SOAP并不真需要什么接口描述语言。

如果SOAP是交流纯内容的标准，那就需要一种语言来描述内容。

SOAP消息确实带有某些类型信息，因此SOAP允许动态的决定类型。

但不知道一个函数的函数名、参数的个数和各自类型，怎么可能去调用这个函数呢？没有WSDL，我可以从必备文档中确定调用语法，或者检查消息。

随便何种方法，都必须有人参与，这个过程可能会有错。

而使用了WSDL，我就可以通过这种跨平台和跨语言的方法使Web Service代理的产生自动化。

就像COM和CORBA的IDL 文件，WSDL文件由客户和服务器约定。

注意由于WSDL设计成可以绑定除SOAP以外的其他协议，这里我们主要关注WSDL在HTTP上和SOAP的关系。

同样，由于SOAP目前主要用来调用远程的过程和函数，WSDL支持SOAP传输的文档规范。

WSDL 1.1已经作为记录递交给W3C（见/TR/wsdl.html）WSDL文档结构若要理解XML文档，将之看作块状图表非常有用。

下图以XML的文档形式说明了WSDL的结构，它揭示了WSDL文档五个栏之间的关系。

WSDL文档可以分为两部分。

顶部分由抽象定义组成，而底部分则由具体描述组成。

抽象部分以独立于平台和语言的方式定义SOAP消息，它们并不包含任何随机器或语言而变的元素。

这就定义了一系列服务，截然不同的网站都可以实现。

随网站而异的东西如序列化便归入底部分，因为它包含具体的定义。

l 抽象定义Types独立与机器和语言的类型定义Messages包括函数参数（输入与输出分开）或文档描述PortTypes引用消息部分中消息定义来描述函数签名（操作名、输入参数、输出参数）2 具体定义BindingsPortTypes部分的每一操作在此绑定实现Services确定每一绑定的端口地址下面的图中，箭头连接符代表文档不同栏之间的关系。

点和箭头代表了引用或使用关系。

双箭头代表"修改"关系。

3-D的箭头代表了包含关系。

这样，各Messages栏使用Types栏的定义，PortTypes栏使用Messages栏的定义；Bindings栏引用了PortTypes栏，Services栏引用Bindings栏，PortTypes和Bindings 栏包含了operation元素，而Services栏包含了port元素。

PortTypes栏里的operation元素由Bindings 栏里的operation元素进一步修改或描述。

在此背景中，我将使用标准的XML术语来描述WSDL文档。

Element是指XML的元素，而"attribute"指元素的属性。

于是：内容也可能由一个或多个元素以递归的方式组成。

根元素是所有元素之中最高级的元素。

子元素总是从属于另一个元素，父元素。

注意，文档之中可能只有一个Types栏，或根本没有。

所有其他的栏可以只有零元素、单元素或是多元素。

WSDL的列表要求所有的栏以固定的顺序出现：import, types, message, portType, binding, service。

所有的抽象可以是单独存在于别的文件中，也可以从主文档中导入。

图一：抽象定义和具体定义WSDL文件示例让我们来研究一下WSDL文件，看看它的结构，以及如何工作。

请注意这是一个非常简单的WSDL文档实例。

我们的意图只是说明它最显著的特征。

以下的内容中包括更加详细的讨论。

xmlns:typens="/xsd"xmlns:xsd="/2001/XMLSchema"xmlns:soap="/wsdl/soap/"xmlns:stk="/soap-toolkit/wsdl-extension"xmlns="/wsdl/"＞＜types＞＜schema targetNamespace="/xsd"xmlns="/2001/XMLSchema"xmlns:SOAP-ENC="/soap/encoding/"xmlns:wsdl="/wsdl/"elementFormDefault="qualified" ＞＜/schema＞＜/types＞＜message name="Simple.foo"＞＜part name="arg" type="xsd:int"/＞＜/message＞＜message name="Simple.fooResponse"＞＜part name="result" type="xsd:int"/＞＜/message＞＜portType name="SimplePortType"＞＜operation name="foo" parameterOrder="arg" ＞＜input message="wsdlns:Simple.foo"/＞＜output message="wsdlns:Simple.fooResponse"/＞＜/operation＞＜/portType＞＜binding name="SimpleBinding" type="wsdlns:SimplePortType"＞＜stk:binding preferredEncoding="UTF-8" /＞＜soap:binding style="rpc"transport="/soap/http"/＞＜operation name="foo"＞＜soap:operation soapAction="/action/Simple.foo"/＞＜input＞＜soap:body use="encoded" namespace="/message/"encodingStyle="/soap/encoding/" /＞＜/input＞＜output＞＜soap:body use="encoded" namespace="/message/"encodingStyle="/soap/encoding/" /＞＜/output＞以下是该实例文档的总述：稍后我将详细讨论每一部分的细节。

第一行申明该文档是XML。

尽管这并不是必需的，但它有助于XML解析器决定是否解析WSDL文件或只是报错。

第二行是WSDL文档的根元素：＜definitions＞。

一些属性附属于根元素，就像＜schema＞子元素对于＜types＞元素。

＜types＞元素包含了Types栏。

如果没有需要声明的数据类型，这栏可以缺省。

在WSDL范例中，没有应用程序特定的types声明，但我仍然使用了Types栏，只是为了声明schema namespaces。

＜message＞元素包含了Messages栏。

如果我们把操作看作函数，＜message＞元素定义了那个函数的参数。

＜message＞元素中的每个＜part＞子元素都和某个参数相符。

输入参数在＜message＞元素中定义，与输出参数相隔离--输出参数有自己的＜message＞元素。

兼作输入、输出的参数在输入输出的＜message＞元素中有它们相应的＜part＞元素。

输出＜message＞元素以"Response"结尾，就像以前所用的"fooResponse"。

每个＜part＞元素都有名字和类型属性，就像函数的参数有参数名和参数类型。

用于交换文档时，WSDL允许使用＜message＞元素来描述交换的文档。

＜part＞元素的类型可以是XSD基类型，也可以是SOAP定义类型(soapenc)、WSDL定义类型(wsdl)或是Types栏定义的类型。

一个PortTypes栏中，可以有零个、单个或多个＜portType＞元素。

由于抽象PortType定义可以放置在分开的文件中，在某个WSDL文件中没有＜portType＞元素是可能的。

上面的例子里只是用了一个＜portType＞元素。

而一个＜portType＞元素可在＜operation＞元素中定义一个或是多个操作。

示例仅使用了一个名为"foo"的＜operation＞元素。

这和某个函数名相同。

＜operation＞元素可以有一个、两个、三个子元素：＜input＞, ＜output＞和＜fault＞元素。

每个＜input＞和＜output＞元素中的消息都引用Message栏中的相关的＜message＞元素。

这样，示例中的整个＜portType＞元素就和以下的C函数等效：这个例子足见XML和C相比要冗长的多。

（包括＜message＞元素，XML在示例中共使用了12行代码来表达相同的单行函数声明。

）Bindings栏可以有零个、一个或者多个＜binding＞元素。

它的意图是制定每个＜operation＞通过网络调用和回应。

Services栏同样可以有零个、一个、多个＜service＞元素。

它还包含了＜port＞元素，每个＜port＞元素引用一个Bindings栏里的＜binding＞元素。

合集下载

wsdl文件用法

wsdl文件用法

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

WSDL文件用于定义如何访问和使用特定的Web服务。

它包含了Web服务的详细信息，包括服务地址、可用的操作、操作所需的参数、操作返回的数据类型等。

WSDL文件是从服务端生成的，客户端可以通过解析WSDL文件来了解和使用该Web服务。

以下是WSDL文件的用法和功能的一些详细解释。

1. 描述服务：WSDL文件描述了一个Web服务的所有相关信息。

它指定了服务的名称、命名空间、服务的端口、地址和可用的操作。

2. 定义操作：WSDL文件定义了Web服务可用的操作，并指定了每个操作的名称、输入参数和输出结果。

操作的输入和输出可以是简单的数据类型，也可以是复杂的结构体或对象。

3.指定数据类型：WSDL文件可以定义自定义的数据类型，包括简单类型（如整数、字符串等）和复杂类型（如结构体、数组等）。

4.生成客户端代码：通过解析WSDL文件，客户端可以自动生成与服务进行通信所需的代码。

客户端可以根据WSDL文件中定义的操作和数据类型生成对应的函数调用和相关数据结构。

5.交互规范：WSDL文件规定了客户端与服务端之间的通信协议和消息格式。

它指定了使用哪种协议（如SOAP、HTTP等）来发送请求和接收响应，并定义了请求和响应的消息结构和格式。

6. 发现服务：WSDL文件可以作为服务目录的一部分，提供给其他开发人员用于发现和了解可用的Web服务。

其他人员可以通过查看WSDL文件来了解服务的功能和使用方式。

7. 服务的版本控制：WSDL文件可以将一个Web服务的不同版本进行区分。

通过在WSDL文件中指定版本号，客户端可以选择使用特定版本的服务。

8. 修改服务：当Web服务的接口发生变化时，需要更新对应的WSDL文件。

客户端可以根据新的WSDL文件生成新的代码，以便与更新后的服务进行交互。

10.跨平台和跨语言支持：WSDL文件是基于XML的，具有良好的可扩展性和互操作性。

java解析wsdl文档获取方法与参数

java解析wsdl文档获取方法与参数

java解析wsdl文档获取方法与参数Java是一种流行的编程语言，它提供了多种方法来解析WSDL文档，从而获取方法和参数。

本文将分步骤阐述如何使用Java解析WSDL 文档以获取方法和参数。

1. 首先，我们需要了解什么是WSDL。

WSDL全称为Web Services Description Language，即Web服务描述语言。

它是一种XML格式的文档，用于描述Web服务的接口和相关信息。

2. 在Java中，我们可以使用JAX-WS包来解析WSDL文档。

JAX-WS是Java API for XML Web Services的缩写，它提供了一个标准的方式来创建和部署Web服务。

3. 要解析WSDL文档，我们需要创建一个JAX-WS客户端。

可以通过使用wsimport命令生成JAX-WS客户端代码，该命令将根据WSDL 文档生成客户端Java类。

4. 使用JAX-WS客户端代码，我们可以使用以下步骤来获取WSDL 文档中的方法和参数。

a. 创建一个服务对象，该对象包含服务的名称和所需的端口。

例如，以下代码片段创建了一个服务对象，该对象包含名称为“HelloService”的服务和名为“HelloPort”的端口。

```HelloService service = new HelloService();HelloPort port = service.getHelloPort();```b. 使用端口对象调用Web服务的方法。

例如，以下代码片段调用了“HelloWorld”方法，并传递了一个字符串参数。

```String response = port.HelloWorld("David");```c. 通过调用“getBinding”方法获取服务端点的绑定。

例如，以下代码片段获取服务端点的绑定。

```Binding binding = port.getBinding();```d. 通过调用“getBindingOperation”方法获取绑定操作。

WSDL文档编写规范与调用优化指南

WSDL文档编写规范与调用优化指南

WSDL文档编写规范与调用优化指南一、引言Web Services Description Language（WSDL）是一种用于描述和定位Web服务的XML格式。

WSDL文档的编写规范和调用优化对于确保Web服务的可靠性和性能至关重要。

本文将详细介绍WSDL文档的编写规范以及调用优化的指南。

二、WSDL文档编写规范1. 命名规范在编写WSDL文档时，应遵循一致的命名规范。

建议使用有意义的、描述性的名称来定义WSDL元素和属性，以便于其他开发人员理解和使用。

例如，使用清晰的名称来命名消息、操作和端口等。

2. 合理组织结构WSDL文档应具有良好的组织结构，以便于阅读和理解。

建议使用合适的层次结构和标签来组织信息，并根据需要使用注释或文档注释来提供额外的解释。

3. 准确描述Web服务接口在WSDL文档中，准确描述Web服务接口是至关重要的。

应明确列出每个操作的输入和输出消息，并定义它们的数据类型、格式和协议。

此外，还应指定操作的访问方式（如HTTP、SOAP等）和所需的参数。

4. 使用注释提供额外信息通过使用注释和文档注释，可以为其他开发人员提供有关WSDL文档的附加信息。

注释可以包括一些操作的特殊要求、调用示例或其他相关说明。

这有助于提高文档的可读性和易用性。

5. 更新及时随着Web服务的演进，可能会对其进行修改和更新。

为了确保WSDL文档的准确性和实用性，应定期进行更新，使其始终与实际代码保持一致。

三、调用优化指南1. 合理选择通信协议在使用Web服务时，应根据实际需求合理选择通信协议。

如果需要高可靠性和安全性，可以选择基于SOAP的协议，如SOAP 1.2。

如果数据量较小且需要更低的延迟，可以选择RESTful风格的Web服务。

2. 精简消息传输在WSDL文档中定义的消息结构应尽可能精简和高效。

避免在消息中包含过多的冗余信息，减少网络传输的数据量，提高调用效率。

3. 使用数据压缩对于大数据量的消息，可以考虑使用数据压缩来减少网络传输的数据量。

WSDL文件结构详解

WSDL文件结构详解

wsdl文件结构分析WSDL (Web Services Description Language,Web服务描述语言)是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程过程调用)。

WSDL首先对访问的操作和访问时使用的请求/响应消息进行抽象描述，然后将其绑定到具体的传输协议和消息格式上以最终定义具体部署的服务访问点。

相关的具体部署的服务访问点通过组合就成为抽象的Web服务。

本文将详细讲解WSDL文档的结构，并分析每个元素的作用。

一：WSDL定义WSDL是一个用于精确描述Web服务的文档，WSDL文档是一个遵循WSDL XML模式的XML文档。

WSDL 文档将Web服务定义为服务访问点或端口的集合。

在 WSDL 中，由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来，因此可以对抽象定义进行再次使用：消息，指对交换数据的抽象描述；而端口类型，指操作的抽象集合。

用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。

将Web访问地址与可再次使用的绑定相关联，可以定义一个端口，而端口的集合则定义为服务。

一个WSDL文档通常包含7个重要的元素，即types、import、message、portType、operation、binding、 service元素。

这些元素嵌套在definitions 元素中，definitions是WSDL文档的根元素。

文章的下一部分将会详细介绍WSDL 的基本结构。

二：WSDL的基本结构--概述如第一部分最后描述的那样，一个基本的WSDL文档包含7个重要的元素。

下面将分别介绍这几个元素以及他们的作用。

WSDL 文档在Web服务的定义中使用下列元素：· Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。