l 抽象定义
Types
独立与机器和语言的类型定义
Messages
包括函数参数(输入与输出分开)或文档描述
PortTypes
引用消息部分中消息定义来描述函数签名(操作名、输入参数、输出参数)
2 具体定义
Bindings
PortTypes部分的每一操作在此绑定实现
Services
确定每一绑定的端口地址
下面的图中,箭头连接符代表文档不同栏之间的关系。点和箭头代表了引用或使用关系。双箭头代表"修改"关系。3-D的箭头代表了包含关系。这样,各Messages栏使用Types栏的定义,PortTypes栏使用Messages栏的定义;Bindings栏引用了PortTypes栏,Services栏引用Bindings栏,PortTypes和Bindings栏包含了operation元素,而Services栏包含了port元素。PortTypes栏里的operation元素由Bindings栏里的operation元素进一步修改或描述。
首先看看一段简单的JAVA代码,我们用它作为WSDL的服务实现代码:
public String echo(String u){
return "Hello " + u;
}
}
看看它导出的文件:
<?xml version="1.0" encoding="UTF-8" ?>
- <wsdl:definitions targetNamespace="http://localhost/axis/Test2.jws"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:apachesoap="http://xml.apache.org/xml-soap"
xmlns:intf="http://localhost/axis/Test2.jws"
xmlns:impl="http://localhost/axis/Test2.jws">
- <!--
WSDL created by Apache Axis version: 1.4
Built on Apr 22, 2006 (06:55:48 PDT)
-->
定义好操作(或方法)以后,现在需要指定将向它们发送和从它们返回的参数。在 WSDL 术语中,所有参数称为“消息”。认为您是在递送消息而结果得到返回的消息是有用的。方法调用是这样一种操作:它准备返回“消息”来响应进入的消息。
<message>元素包含了Messages栏。如果我们把操作看作函数,<message>元素定义了那个函数的参数。<message>元素中的每个<part>子元素都和某个参数相符。输入参数在<message>元素中定义,与输出参数相隔离--输出参数有自己的<message>元素。兼作输入、输出的参数在输入输出的<message>元素中有它们相应的<part>元素。输出<message>元素以"Response"结尾,就像以前所用的"fooResponse"。每个<part>元素都有名字和类型属性,就像函数的参数有参数名和参数类型。
- <wsdl:message name="echoResponse"> //返回的消息
<wsdl:part name="echoReturn" type="xsd:string" />
</wsdl:message>
- <wsdl:message name="echoRequest"> //请求的消息
<wsdl:part name="u" type="xsd:string" />
</wsdl:message>
<definitions> 元素包含一个或多个
<portType>
元素,实际上,每个元素都是您希望表示的一系列 operation
。或者,您也可以将单个 portType 元素看作是将各种方法组成类的一个逻辑分组。例如,如果您的供应链管理解决方案需要在客户和供应商之间进行交互,您最可能做的是分别定义与他们交互的功能性;也就是说,您将为用户和供应商各定义一个 portType。应该将每个 portType 称为 服务,因此整个 WSDL 文件将成为一个服务集合。 - <wsdl:portType name="Test2"> //一个portType可以看成一个类
- <wsdl:operation name="echo" parameterOrder="u"> //一个operation就是一个方法
<wsdl:input name="echoRequest" message="impl:echoRequest" /> //输入消息
<wsdl:output name="echoResponse" message="impl:echoResponse" /> //返回消息
</wsdl:operation>
</wsdl:portTyp>
消息传递和传输:
我以一种抽象方式定义了操作和消息,而不考虑实现的细节。实际上,WSDL 的任务是定义或描述 Web 服务,然后提供一个对外部框架的引用来定义 WSDL 用户将如何实现这些服务。可以将这个框架当作 WSDL 抽象定义和它们的实现之间的“绑定(
binding
)”。当前,最流行的绑定( binding
)技术是使用简单对象访问协议(SOAP)。WSDL 将指定能够访问 Web 服务实际实现的 SOAP 服务器,并且从那时起 SOAP 的整个任务就是将用户从 WSDL 文件带到它的实现。
<binding>
元素包括到 <definitions>
元素内。这个 binding 元素应该有 name
和 type
属性。 name
将标识这个绑定而 type
将标识您希望与这个绑定相关联的 portType(一组操作)。<wsdl:binding name="Test2SoapBinding" type="impl:Test2">
<wsdlsoap:binding/> 元素。该元素的用途是声明将把 SOAP 作为绑定和传输服务使用
<wsdlsoap:binding>
元素有两个属性:style 和 transport。style 是一个可选属性,它描述该绑定内操作的性质。transport 属性指定 HTTP 作为该绑定将使用的级别较低的传输服务。SOAP 客户机将从 WSDL 文件中读取 SOAP 结构并与另一端的 SOAP 服务器协调.
WSDL
<operation>
元素,分别表示具体的操作。每个 <operation>
元素提供各自操作的绑定细节。因此,我提供了另一个 extensibility
元素,即 <wsdlsoap:operation/>
(仍然是一个空元素,与它发生的那个操作相关)。该 <soap:operation/>
元素有一个 soapAction 属性,SOAP 客户机将使用该属性创建 SOAP 请求。 //下面将WSDL描述与具体实现进行绑定,这里采用SOAP方式
- <wsdl:operation name="echo">
<wsdlsoap:operation soapAction="" />
- <wsdl:input name="echoRequest">
<wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://DefaultNamespace" />
</wsdl:input>
- <wsdl:output name="echoResponse">
<wsdlsoap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="http://localhost/axis/Test2.jws" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
//下面将发布的服务与前面的SOAP绑定进行关联
- <wsdl:service name="Test2Service">
- <wsdl:port name="Test2" binding="impl:Test2SoapBinding">
<wsdlsoap:address location="http://localhost/axis/Test2.jws" />
</wsdl:port>
</wsdl:service>
每个namespace属性都声明了一个缩略语,用在文档中。例如"xmlns:xsd"就为 http://www.w3.org/2001/XMLSchema定义了一个缩略语(xsd)。这就允许对该namespace的引用只需简单的在名字前加上前缀就可以了,如:"xsd:int"中的"xsd"就是合法的类型名。普通范围规则可运用于缩略前缀。也就是说,前缀所定义的元素只在元素中有效。
Namespace派什么用?namespace的作用是要避免命名冲突。如果我建立一项Web Service,其中的WSDL文件包含一个名为"foo"的元素,而你想要使用我的服务与另一项服务连接作为补充,这样的话另一项服务的WSDL文件就不能包含名为"foo"的元素。两个服务器程序只有在它们在两个事例中表示完全相同的东西时,才可以取相同的名字。如果有了表示区别的namespace,我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。在你的客户端里,你只要加以限制就可以引用我的"foo"。
见下例:http://www.infotects.com/fooService#foo 就是完全限制的名字,相当于"carlos:foo",如果我声明了carlos作为http://www.infotects.com/fooService的快捷方式。请注意namespace中的URL是用来确定它们的唯一性的,同时也便于定位。URL所指向的地方不必是实际存在的网络地址,也可以使用GUID来代替或补充URL。例如,GUID"335DB901-D44A-11D4-A96E-0080AD76435D"就是一个合法的namespace指派。
targetNamespace属性声明了一个namespace,元素中所有的声明的名字都列于其内。在WSDL示例中,<definitions>的targetNamespace 是http://tempuri.org/wsdl。这意味着所有在WSDL文档中声明的名字都属于这个namespace。<schema>元素有自己的targetNamespace属性,其值为 http://tempuri.org/xsd ,在<schma>元素中定义的所有名字都属于这个namespace而不是main的target namespace。
<schema>元素的以下这行声明了默认的namespace。Schema中所有有效的名字都属于这个namespace。
相关推荐
JavaScript调用WSDL(Web Service Definition Language)是Web服务客户端编程的一个重要方面,尤其是在需要与SOAP(Simple Object Access Protocol)服务交互时。本示例主要介绍如何在JavaScript中使用不同的库和...
这个配置文件可能包含了`wsdl.exe`运行时的配置信息,如默认的命名空间映射、数据类型转换规则等。用户可以根据需要修改这些设置来影响`wsdl.exe`生成WSDL文档的方式。 5. **生成的WSDL文档结构** WSDL文档通常...
【javax.wsdl jar包】是Java Web服务定义语言(Web Services Description Language)的一个核心库,主要用在开发基于Java的Web服务中。这个jar包包含了处理WSDL文档所需的所有类和接口,允许开发者创建、读取和修改...
综上所述,WSDL 1.1标准规范是理解和实现网络服务的关键文档,它为开发人员提供了一套全面而细致的规则,用于定义和描述服务,确保不同系统间的无缝集成和通信。通过学习和掌握WSDL,开发者可以更有效地构建和维护...
标题中的“根据一定规则的Excel生成WSDL文件(工具源码)”指的是一个特定的开发工具或程序,它能够从包含特定格式数据的Excel电子表格中生成WSDL(Web Services Description Language)文件。WSDL是一种XML格式的...
2. **定制生成**:利用配置文件(如`wsdl2java.xml`)自定义代码生成规则,如选择数据绑定机制(JAXB、Aegis等)或指定包名。 3. **版本控制**:将生成的代码纳入版本控制系统,以便于团队协作和回溯。 4. **测试**...
`binding`元素定义了端口类型的特定实现,包括通信协议和数据编码规则。例如: ```xml ``` - **name** 属性:定义了绑定的名称。 - **type** 属性:定义了绑定所实现的`portType`。 - **soap:...
5. **互操作性**:ONVIF的WSDL文件确保不同厂商的设备都能理解并遵循同一套规则进行通信,增强了系统的兼容性和扩展性。 6. **XML Schema(XSD)**:虽然WSDL文件不直接包含在文件名中,但通常与之关联。XSD文件...
综合来看,这个压缩包可能是一个用于开发Java Web服务的工具集,包括处理WSDL的API和遵循JSR 94的规则引擎支持,为构建、部署和管理服务提供了基础。在实际开发中,这样的工具集可以帮助开发人员更加高效地创建和...
WSDL文件通常以XML格式编写,遵循一套严格的语法规则,以便于机器解析和理解。 在“wsdl大合集”中,你可能会找到各种类型的WSDL文档,涵盖不同的业务场景和接口设计。这些文档可能包括: 1. **基本WSDL元素**:如...
在ONVIF上下文中,XSD文件定义了交换的数据格式和规则。例如,设备信息、媒体配置、PTZ位置等数据的XML表示都遵循相应的XSD模式。这确保了不同设备之间数据交换的一致性和准确性。 在“onvif网站下载的原wsdl和xsd...
5. **绑定(Binding)**:定义了服务操作如何被实现和访问,包括传输协议(如HTTP或SOAP over HTTP)、消息格式(如SOAP)以及消息的编码规则。 **三、WSDL的使用场景** 1. **服务发布**:服务提供者创建WSDL文档,...
二是使用XSLT转换,定义输入到输出的转换规则。XSLT的优势在于它的通用性、简洁性和广泛的工具支持。相比编程语言,XSLT的转换逻辑更加直观,更便于调试和维护,且可在多种环境下执行。 处理WSDL文档的挑战主要体现...
`encoded`表示SOAP消息体中的XML数据经过特定的编码规则(通常是SOAP Encoding)处理,而`literal`则意味着XML数据直接按照Schema约束进行解析。四种组合分别是`rpc/encoded`、`rpc/literal`、`document/encoded`和`...
XSD文件则用于定义数据结构和数据类型,它为XML文档提供了结构化的语义规则。在ONVIF场景中,XSD文件规定了如设备信息、媒体配置、事件通知等数据应该如何编码成XML。通过XSD,开发者可以验证发送和接收的XML消息...
1. **语法错误**:WSDL文件是基于XML的,因此必须遵循XML的语法规则。如果文件中存在未闭合的标签、非法字符或错误的命名空间引用,解析器会报错。检查文件中的XML结构和语法,确保它们符合WSDL规范。 2. **命名...
在分布式计算环境中,WSDL 文件充当着重要的角色,因为它能够清晰地说明一个 Web 服务的接口、消息格式、调用规则等关键信息。 #### 二、XML 基础结构与命名空间 给定的 WSDL 文件首先声明了其使用的 XML 版本为 ...
每个元素都有明确的语法和语义规则,确保了描述的一致性和清晰度。 - `definitions`元素是WSDL文档的根元素,包含对所有其他元素的引用。 - `message`元素用于描述消息的结构,包括数据类型和消息组成部分。 - `...
完成代码生成后,按照目标系统的编译规则编译生成的代码。 5. **测试和调试**:移植完成后,进行充分的测试至关重要。这包括单元测试、集成测试以及针对新平台的兼容性测试。确保所有ONVIF功能都能正常工作。 6. *...