Web ServiceWord文件下载.docx
- 文档编号:781826
- 上传时间:2023-04-29
- 格式:DOCX
- 页数:17
- 大小:572.86KB
Web ServiceWord文件下载.docx
《Web ServiceWord文件下载.docx》由会员分享,可在线阅读,更多相关《Web ServiceWord文件下载.docx(17页珍藏版)》请在冰点文库上搜索。
所有的抽象可以是单独存在于别的文件中,也可以从主文档中导入。
WSDL文件示例
让我们来研究一下WSDL文件,看看它的结构,以及如何工作。
请注意这是一个非常简单的WSDL文档实例。
我们的意图只是说明它最显著的特征。
以下的内容中包括更加详细的讨论。
<?
xmlversion="
1.0"
encoding="
UTF-8"
?
>
<definitionsname="
FooSample"
targetNamespace="
http:
//tempuri.org/wsdl/"
xmlns:
wsdlns="
typens="
//tempuri.org/xsd"
xmlns:
xsd="
//www.w3.org/2001/XMLSchema"
soap="
//schemas.xmlsoap.org/wsdl/soap/"
stk="
xmlns="
//schemas.xmlsoap.org/wsdl/"
<types>
<schema
SOAP-ENC="
//schemas.xmlsoap.org/soap/encoding/"
wsdl="
elementFormDefault="
qualified"
>
</schema>
</types>
<messagename="
Simple.foo"
<partname="
arg"
type="
xsd:
int"
/>
</message>
Simple.fooResponse"
result"
<portTypename="
SimplePortType"
<operationname="
foo"
parameterOrder="
<inputmessage="
wsdlns:
<outputmessage="
</operation>
</portType>
<bindingname="
SimpleBinding"
<stk:
bindingpreferredEncoding="
/>
<soap:
bindingstyle="
rpc"
transport="
//schemas.xmlsoap.org/soap/http"
/>
<operationname="
operationsoapAction="
//tempuri.org/action/Simple.foo"
<input>
bodyuse="
encoded"
namespace="
//tempuri.org/message/"
encodingStyle="
</input>
<output>
namespace="
encodingStyle="
</output>
</binding>
<servicename="
FOOSAMPLEService"
<portname="
SimplePort"
binding="
addresslocation="
//carlos:
8080/FooSample/FooSample.asp"
</port>
</service>
</definitions>
第一行申明该文档是XML。
尽管这并不是必需的,但它有助于XML解析器决定是否解析WSDL文件或只是报错。
第二行是WSDL文档的根元素:
<definitions>。
一些属性附属于根元素,就像<schema>子元素对于<types>元素。
<types>元素包含了Types栏。
如果没有需要声明的数据类型,这栏可以缺省。
在WSDL范例中,没有应用程序特定的types声明,但我仍然使用了Types栏,只是为了声明schemanamespaces。
<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>元素中定义一个或是多个操作。
示例仅使用了一个名为"
的<operation>元素。
这和某个函数名相同。
<operation>元素可以有一个、两个、三个子元素:
<input>,<output>和<fault>元素。
每个<input>和<output>元素中的消息都引用Message栏中的相关的<message>元素。
这样,示例中的整个<portType>元素就和以下的C函数等效。
Bindings栏可以有零个、一个或者多个<binding>元素。
它的意图是制定每个<operation>通过网络调用和回应。
Services栏同样可以有零个、一个、多个<service>元素。
它还包含了<port>元素,每个<port>元素引用一个Bindings栏里的<binding>元素。
Bindings和Services栏都包含WSDL文档。
Namespace
<definitions>和子节点<schema>都是namespace属性:
每个namespace属性都声明了一个缩略语,用在文档中。
例如"
xsd"
就为http:
//www.w3.org/2001/XMLSchema定义了一个缩略语(xsd)。
这就允许对该namespace的引用只需简单的在名字前加上前缀就可以了,如:
"
中的"
就是合法的类型名。
普通范围规则可运用于缩略前缀。
也就是说,前缀所定义的元素只在元素中有效。
Namespace派什么用?
namespace的作用是要避免命名冲突。
如果我建立一项WebService,其中的WSDL文件包含一个名为"
的元素,而你想要使用我的服务与另一项服务连接作为补充,这样的话另一项服务的WSDL文件就不能包含名为"
的元素。
两个服务器程序只有在它们在两个事例中表示完全相同的东西时,才可以取相同的名字。
如果有了表示区别的namespace,我的网络服务里的"
就可以表示完全不同于另一个网络服务里"
的含义。
在你的客户端里,你只要加以限制就可以引用我的"
targetNamespace属性声明了一个namespace,元素中所有的声明的名字都列于其内。
在WSDL示例中,<definitions>的targetNamespace是http:
//tempuri.org/wsdl。
这意味着所有在WSDL文档中声明的名字都属于这个namespace。
<schema>元素有自己的targetNamespace属性,其值为http:
//tempuri.org/xsd,在<schma>元素中定义的所有名字都属于这个namespace而不是main的targetnamespace。
<schema>元素的以下这行声明了默认的namespace。
Schema中所有有效的名字都属于这个namespace。
SOAP消息
对于使用WSDL的客户机和服务机来说,研究WSDL文件的一种方法就是决定什么来接受所发送的信息。
尽管SOAP使用底层协议,如IP和HTTP等,但应用程序决定了服务器与客户机之间交互的高级协议。
也就是说,进行一项操作,比如"
echoint"
把输入的整数送回,参数的数目、每个参数的类型、以及参数如何传送等因素决定了应用程序特定的协议。
有很多方法可以确定此类协议,但我相信最好的方法就是使用WSDL。
如果我们用这种视角来看待它,WSDL不只是一种接口协议,而且是一种协议特定的语言。
它就是我们超越"
固定"
协议(IP、HTTP等)所需要的应用程序特定协议。
WSDL可以确定SOAP消息是否遵从RPC或文档风格。
RPC风格的消息(就是示例中所用的)看起来像是函数调用。
而文档风格的消息则更普通,嵌套层次更小。
下面的XML消息就是示例WSDL文件解析后的发送/接受效果,解析使用的是MSSOAPToolkit2.0(MSTK2)中的SoapClient对象。
WSDL的Types栏和Messages栏中的XMLSchema
WSDL数据类型是基于"
XMLSchema:
Datatypes"
(XSD)的,现在已经被W3C推荐。
这一文档共有三个版本(1999,2000/10,2001),因此必须在namespace属性的<definitions>元素中指明所使用的是哪一个版本。
在本栏和以后各部分,需使用以下简缩或前缀
前缀
代表的Namespace
描述
Soapenc
//schemas.xmlsoap.org/soap/encoding
SOAP1.1encoding
Wsdl
//schemas.xmlsoap.org/wsdl/soap
WSDL1.1
Xsd
//www.w3.org/2001/XMLSchema
XMLSchema
XSD基类型
下表是直接从MSTK2文档中取出的,列举了MSTK2所支持的所有XSD基类型。
它也告诉在客户端或服务器端的WSDL读取程序如何把XSD类型映射到在VB、C++和IDL中相应的类型。
XSD定义了两套内建的数据类型:
原始的和派生的。
在下文中查阅内建数据类型的层次十分有益:
http:
//www.w3.org/TR/2001/PR-xmlschema-2-20010330
complex类型
XMLschema允许complex类型的定义,就像C里是struct。
例如,为了定义类似如下的C的struct类型:
四、d\
五、Axis(ApacheeXtensibleInteractionSystem)讲解及发布过程
是一款开源的webservice运行引擎,它是SOAP协议的一个实现。
下载地址:
//www.apache.org/dyn/closer.cgi/ws/axis/1_4下载axis-bin-1_4.zip后将压缩包解压出来的目录结构是:
Docs:
存放Axis的说明文档。
Lib:
存放Axis的二进制发布包。
Samples:
存放利用Axis发布的WebService的示例代码。
Webapps:
存放安装Axis的基础应用。
Xmls:
存放相关说明文档。
把webapps下的文件夹axis拷到tomcat对应的webapps下,把tomcat运行起来访问:
//localhost:
8080/axis
然后点击上面页面的”Validation”连接,如图:
该页显示Axis的必需组件还缺少一个没有安装,两个可选组件也没有安装,单击上面的提示:
必需组件:
可选组件:
//xml.apache.org/security/
分别下载:
jaf-1_1-fr.zip,javamail-1_4.zip,xml-security-bin-1_2_1.zip包,然后把jaf-1_1-fr.zip里的Activation.jar,javamail-1_4.zip里的mail.jar,
xml-security-bin-1_2_1.zip里的xmlsec-1.2.1.jar,xalan.jar都放到你的axis应用的WEB-INF/lib下然后在校验Axis,看到页面提示全部安装成功。
Axis的WebService定制发布—WSDD
第一步:
这时的准备工作已经做好,就把你写好的服务端应用文件包拷贝到%TOMCAT_HOME%\webapps\axis\WEB-INF\classes目录下
第二步:
在WEB-INF目录下创建一个deploy.wsdd文件,文件内容如下:
<
deploymentxmlns="
//xml.apache.org/axis/wsdd/"
java="
//xml.apache.org/axis/wsdd/providers/java"
>
servicename="
HelloWorldWSDD"
provider="
java:
RPC"
parametername="
className"
value="
com.java.axis.HelloWorldWSDD"
/>
allowedMethods"
*"
scope"
request"
/service>
/deployment>
简单的介绍下各个节点的含义,“HelloWorldWSDD”当然是这个WebService的名字,后面紧跟的java:
RPC指的是服务类型。
这里一共有有4种类型,分别RPC,Document,Wrapped和Message;
parameter节点第一个当然是指出具体的类,第二个从字面上也很好理解:
允许调用的方法。
这里的配置告诉引擎可以调用所有的public方法,当然你也可以自己指定。
第三步:
cmd打开windows的控制台,进入:
%TOMCAT_HOME%\webapps\axis\WEB-INF目录下键入如下命令:
java-Djava.ext.dirs=liborg.apache.axis.client.AdminClient-lhttp:
8080/axis/servlet/AxisServletdeploy.wsdd
(注意:
该命令的后半部分是你部署的axis的Servlet访问地址加上你创建deploy.wsdd
文件名,很多文档里给的此命令是错误的,执行时就会抛出异常)
执行成功就会在控制台输出:
同时也会在WEB-INF下生成一个server-config.wsdd文件;
这时候你通过http:
8088/axis/servlet/AxisServlet访问,在页面上就会多出你发布的名称HelloWorldWSDD及包括的方法
或通过http:
8088/axis/services/HelloWorldWSDD?
wsdl直接访问到发布的信息页面:
取消一个WebService的发布
在WEB-INF目录下创建一个undeploy.wsdd文件,内容为:
undeploymentxmlns="
/>
/undeployment>
文件创建好后同样采用cmd命令到到%TOMCAT_HOM\webapps\axis\WEB-INF目录下,然
后CMD打开控制台,在控制台输入一个我们很熟悉的命令:
8088/axis/servlet/AxisServletundeploy.wsdd
运行后结果:
以上就是一个简单的WebService的发布全过程。
六、WSDD介绍
Axis特性介绍
在编写deploy.wsdd文件时,每个service节点都有这样的子节点
value"
这个节点配置着你的serviceobject也就是你WebService服务的那个object,在后面的value里可以有三个选项request、session、application。
requst:
这个选项会让AXIS为每一个SOAP的请求产生一个服务对象,可以想像如果这个webservice的对象足够复杂,而且SOAP的请求过多,这个选项是非常耗费服务器性能的。
session:
如果选择了session,程序就会给每个调用这个WebService的客户端创造一个
服务对象。
application:
这个选项最彪悍,程序只会在内存里new出来一个服务对象,然后为所有
WebService客户端服务。
很显然这个选项不能储存客户端的一些个性化数据。
所以在功能性上很多时候不能满足要求。
示例创建:
1.创建一个Handler类继承自BasicHandler抽象类,并且实现invoke方法同时做自己需要的处理即可
2.配置deploy.wsdd文件,如下:
3.编写Client端程序
4.服务端响应:
客户端输出:
Axis的Handler和Chain机制
就是一连串的Handler组成的链,由Chain来管理.通过创建一个HeadlerChain类继承于SimpleChain,在构造函数中实例出所需要的Handler类对象并使用this.addHandler(handler)方法添加。
接下来编辑deploy.wsdd文件如下:
七、
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Web Service