在这里,我们将给大家分享关于WebService之WSDL文件讲解的知识,让您更了解webservice的wsdl文件的本质,同时也会涉及到如何更有效地java学习笔记之webservice(二)--
在这里,我们将给大家分享关于WebService 之 WSDL文件 讲解的知识,让您更了解webservice的wsdl文件的本质,同时也会涉及到如何更有效地java学习笔记之webservice(二)--WSDL文档及用myeclipse测试webservice、SOAP WebService的wsdl文件生成类、WebService --WSDL文档解析、WEBService wsdl文件中xsd:date参数问题的内容。
本文目录一览:- WebService 之 WSDL文件 讲解(webservice的wsdl文件)
- java学习笔记之webservice(二)--WSDL文档及用myeclipse测试webservice
- SOAP WebService的wsdl文件生成类
- WebService --WSDL文档解析
- WEBService wsdl文件中xsd:date参数问题
WebService 之 WSDL文件 讲解(webservice的wsdl文件)
恩,我想说的是,是不是经常有人在开发的时候,特别是和第三方有接口的时候,走的是SOAP协议,然后用户给你一个WSDL文件,说按照上面的进行适配,嘿嘿,这个时候,要是你以前没有开发过,肯定会傻眼,那如果你想学习的话,就认真的看下面的讲解咯:
一、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都有自己的工具生成相关的代码。下图是一个例子:
二、WSDL基本结构
WSDL文档是一个遵循WSDL XML模式的XML文档(文档实例);类似于:SOAP文档是一个遵循SOAP XML模式的XML文档(文档实例);
一个WSDL文档的根元素是deFinitions元素,WSDL文档包含7个重要的元素:types,import,message,portType,operations,binding和service元素。
三、WSDL声明
3.1 XML声明
WSDL的声明必须定义成使用:UTF-8 或者UTF-16 编码。
3.2 deFinition元素
所有WSDL文档的根元素都是deFinition元素。
xmlns:xsd ="http://www.w3.org/2001/XMLSchema"
定义了targetNamespace命名空间,它为在模式中显式创建的所有新类型均声明了XML命名空间,而且上面的例子中赋予了mh前缀。
上面的例子中:message元素利用name属性指定了标签(例如:GetBookPriceRequest),这些标签会自动使用targetNamespace的命名空间,标签了的messages元素通常被称为定义。
文档中的其他元素用标签和命名空间前缀去应用定义,例如上面的例子中:input元素是使用mh:GetBookPriceRequest来引用标签GetBookPriceRequest。
3.3 Types元素
Types元素用作一个容器,定义了自定义的特殊数据类型,在声明消息部分(有效负载)的时候,messages定义使用了types元素中定义的数据类型与元素。
上面的例子中,types元素中直接嵌套了一个完整的W3C XML模式文档,此文档中targetNamespace必须是一个有效的非空值,而且必须属于由WSDL文档。
3.4 Import元素
Import元素可以让当前的文档使用其他WSDL文档中指定命名空间中的定义。
namespace属性必须和正导入的WSDL文档中声明的targetNamespace相匹配。
location属性必须指向一个实际的WSDL文档。
四、WSDL抽象接口
Message、portType和operation元素用于描述Web服务的抽象接口,相当于JAVA或者C++中编程中的类的接口。其中portType相当于类接口的名称;operation相当于接口中包含的函数,message相当于函数的参数和返回值。
4.1 Message元素
Message元素描述了Web服务的有效负载。相当于函数调用中的参数和返回值。
4.2 portType元素
PortType元素定义了Web服务的抽象接口,它可以由一个或者多个operation元素,每个operation元素定义了一个RPC样式或者文档样式的Web服务方法。
4.3 operation元素
Operation元素要用一个或者多个messages消息来定义它的输入、输出以及错误。
4.4 WSDL消息交换模式(MEP)
Messaging Exchange Patterns(MEP)
Web服务中使用了四种消息交换模式,即请求/响应、单向、通知以及恳求/响应模式。大多数基于WSDL的web服务使用请求/响应和单向两种模式。
WSDL通过operation元素的input/output来定义使用那种模式,如果有input+output+可选的fault参数,那就使用请求/响应模式;如果只使用input,那就使用单向模式。
在通知模式中:Web服务将消息发送给客户,但不等待回复;一般客户通过注册来接收通知;在恳求/响应模式中类似通知模式,唯一的区别要期待客户对Web服务的响应。
五、WSDL实现:binding元素
Binding元素将一个抽象的portType映射到一组具体的协议(SOAP或者HTTP)、消息传递样式(RPC或者document)以及编码样式(literal或者SOAP encoding)。
Binding的类似于将接口或者函数的调用绑定到某种协议上:例如CORBA、COM或者RPC的方式,这里使用SOAP协议。
5.1 soapbind:binding元素
5.2 soapbind:operation元素
5.3 soapbind:body元素
="rpc" input soapbind:body use ="literal"
5.4 soapbind:fault元素
soapbind:fault use fault
5.5 soapbind:header元素
xsd:schema
5.6 soapbind:headerfault元素
六、WSDL实现:Service和Port元素
service ="BookPriceService" port ="BookPrice_Port" binding ="mh:BookPrice_Binding" soapbind:address location =
java学习笔记之webservice(二)--WSDL文档及用myeclipse测试webservice
>>接上篇
一、WSDL
定义:web services description language,用来描述web服务的xml格式的信息。
标签的解释
1. <types>:定义了服务的namespace和关键信息的类型(方法的参数类型和返回值的类型)。
2. <message>:定义了多个SOAP消息,每个方法通常都有2个message标签,name属性分别是xxx和xxxResponse。
3. portType:指明服务器的接口,并且通过operation绑定相应的in和out的消息:其中in表示参数,out表示返回值
4. binding:指定消息传递的格式。
5. service:指定服务所发布的名称
二、使用Myeclipse的webservcie浏览器去测试webservice
启动服务以后:
1.点击图中红色矩形内的图标,启动Myeclipse自带的webservice浏览器:
2.点击下图中的红色矩形内的图标,进入wsdl页面:
3.点击下图中的“WSDL Main”,即可看到右边Action界面:
4.输入WSDL地址,点击"Go"
5.看到下面的几面以后,点击"Add":
6.输入参数,如"Beauxie",点击“Go”,即可在Status窗口看到结果,至此说明Webservice服务发布成功。
7.点击上图的"source",可查看soap:
》》接下一篇
SOAP WebService的wsdl文件生成类
/** * Copyright (c) 2005, Braulio Jos?Solano Rojas * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * Redistributi
/** * Copyright (c) 2005, Braulio Jos?Solano Rojas * All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright notice, this list of * conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of * conditions and the following disclaimer in the documentation and/or other materials * provided with the distribution. * Neither the name of the Solsoft de Costa Rica S.A. nor the names of its contributors may * be used to endorse or promote products derived from this software without specific * prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * * @version $Id: SoapDiscovery.class.php 66 2013-04-10 07:12:21Z ideaa $ * @copyright 2005 */ /** * SoapDiscovery Class that provides Web Service Definition Language (WSDL). * * @package SoapDiscovery * @author Braulio Jos?Solano Rojas * @copyright Copyright (c) 2005 Braulio Jos?Solano Rojas * @version $Id: SoapDiscovery.class.php 66 2013-04-10 07:12:21Z ideaa $ * @access public * */ class SoapDiscovery { private $class_name = ''''; private $service_name = ''''; /** * SoapDiscovery::__construct() SoapDiscovery class Constructor. * * @param string $class_name * @param string $service_name * */ public function __construct($class_name = '''', $service_name = '''') { $this->class_name = $class_name; $this->service_name = $service_name; } /** * SoapDiscovery::getWSDL() Returns the WSDL of a class if the class is instantiable. * * @return string * */ public function getWSDL() { if (empty($this->service_name)) { throw new Exception(''No service name.''); } $headerWSDL = "<?xml version=\"1.0\" ?>\n"; $headerWSDL.= "\n"; $headerWSDL.= "\n"; if (empty($this->class_name)) { throw new Exception(''No class name.''); } $class = new ReflectionClass($this->class_name); if (!$class->isInstantiable()) { throw new Exception(''Class is not instantiable.''); } $methods = $class->getMethods(); $portTypeWSDL = ''''; $bindingWSDL = ''service_name . ''Binding" type="tns:'' . $this->service_name . "Port\">\n\n"; $serviceWSDL = ''service_name . "\">\n\nservice_name . ''Port" binding="tns:'' . $this->service_name . "Binding\">\n\n\n"; $messageWSDL = ''''; foreach ($methods as $method) { if ($method->isPublic() && !$method->isConstructor()) { $portTypeWSDL.= ''getName() . "\">\n" . ''getName() . "Request\" />\ngetName() . "Response\" />\n\n"; $bindingWSDL.= ''getName() . "\">\n" . ''service_name . ''#'' . $this->class_name . ''#'' . $method->getName() . "\" />\n\n\n\n\n\n\n"; $messageWSDL.= ''getName() . "Request\">\n"; $parameters = $method->getParameters(); foreach ($parameters as $parameter) { $messageWSDL.= ''getName() . "\" type=\"xsd:string\" />\n"; } $messageWSDL.= "\n"; $messageWSDL.= ''getName() . "Response\">\n"; $messageWSDL.= ''getName() . "\" type=\"xsd:string\" />\n"; $messageWSDL.= "\n"; } } $portTypeWSDL.= "\n"; $bindingWSDL.= "\n"; return sprintf(''%s%s%s%s%s%s'', $headerWSDL, $portTypeWSDL, $bindingWSDL, $serviceWSDL, $messageWSDL, ''''); } /** * SoapDiscovery::getDiscovery() Returns discovery of WSDL. * * @return string * */ public function getDiscovery() { return "<?xml version=\"1.0\" ?>\n\n\n"; } }
本文标题:soap webservice的wsdl文件生成类
本文链接:http://www.maben.com.cn/archives/702.html转载请注明出处
WebService --WSDL文档解析
WHAT--该 Web Service包含"什么"操作
HOW--该 Web Service的操作应该"怎样"调用
WHERE--该 Web Service的服务地址。
XML里的两个属性
targetNamespace --相当于java语言里的package
xmlns --相当于java语言的import
Web Servic的技术基础
1.WSDL Web Service DeFinition Language
2.soAP Simple Object Access Protocol 简单对象访问协议
3.uddi
一次web Service调用 --其实并不是方法调用,而是发送SOAP消息(即XML文档片段)
调用一次web Service的本质:
1.客户端把调用方法参数.转换生成XML文档片段 (SOAP消息 --input消息)
---- 该文档片段必须符合WSDL定义的格式。
2.通过网络,把XML文档片段从传给服务器
3.服务器接收到XML文档片段
4.服务器解析XML文档片段,提取其中的数据,并把数据转换
调用Web Service所需要的参数值
5.服务器执行方法
6.把执行方法得到的返回值,再次转换生成为XML文档片段(SOAP消息--output消息)
---- 该文档片段必须符合WSDL定义的格式。
7.通过网络,把XML文档片段从传给客户端
8.客户端接收到XML文档片段
9.客户端解析XML文档片段,提取其中的数据,并把数据转换
调用Web Service的返回值。
从上面调用的本质来看,要一个语言支持web Service,唯一的要求是,改语言支持XML文档解析,生成,支持网络传输。
WEBService wsdl文件中xsd:date参数问题
最近在做WEBService Client端开发,Server端是JAVA的,我需要调用它的a方法并发送一个XML,我是直接传递的XML对象,他们那边有一个标签的值接收不到,下面我给大家发下WSDL文件中节点定义
<xsd:element name="PlannedStartDate" type="xsd:date">
<xsd:annotation><xsd:appinfo source="xxxxx">xxxxx</xsd:appinfo>
</xsd:annotation>
</xsd:element>
PHP请求方法:
$xml = simplexml_load_file(''test.xml'');
$result = $client->a($xml);
test.xml中<PlannedStartDate>2012-02-02</PlannedStartDate>,完全符合xsd:date格式。但不知道为什么他们接收不到。。。(他们用SOAPUI测试是可以的(直接填写2012-02-02),用PHP去Client就不行。)。
关于WebService 之 WSDL文件 讲解和webservice的wsdl文件的问题我们已经讲解完毕,感谢您的阅读,如果还想了解更多关于java学习笔记之webservice(二)--WSDL文档及用myeclipse测试webservice、SOAP WebService的wsdl文件生成类、WebService --WSDL文档解析、WEBService wsdl文件中xsd:date参数问题等相关内容,可以在本站寻找。
本文标签: