web serviceWord文档下载推荐.docx
- 文档编号:22058769
- 上传时间:2023-02-02
- 格式:DOCX
- 页数:15
- 大小:68.88KB
web serviceWord文档下载推荐.docx
《web serviceWord文档下载推荐.docx》由会员分享,可在线阅读,更多相关《web serviceWord文档下载推荐.docx(15页珍藏版)》请在冰豆网上搜索。
7070/itcast"
)//试试将这里的itcast改名为it315。
@SOAPBinding(style=SOAPBinding.Style.RPC)
publicclassHelloService
{
publicstaticvoidmain(String[]args)
{
Endpoint.publish("
newHelloService());
}
@WebMethod
publicvoidsayHello()
System.out.println("
hello"
);
}
2.接着调用
3.本页PPT的总体思路:
前面两段是在纵向解释Webservice自己是什么,第三段则是在横向比较Webservice与其他同类的技术,就像生活中的许多实例一样,某领域的一个专家不仅要能说清出了自己的产品,还要对同行的产品也有所了解,知己知彼,才能更加凸显自己确实对Webservice这个领域有深入的研究和认识。
待深入研究问题:
经常有人说,WebService比较慢,我想是因为没有把创建Service对象前面的工作缓存吧!
如果仅仅是进行SOAP调用,性能应该不低。
例如,让客户端的代码对象只创建一次,然后一直缓存。
WebService的调用原理
WebService使用SOAP协议实现跨编程语言和跨操作系统平台
WebService采用HTTP协议传输数据,采用XML格式封装数据(即XML中说明调用远程服务对象的哪个方法,传递的参数是什么,以及服务对象的返回结果是什么)。
WebService通过HTTP协议发送请求和接收结果时,发送的请求内容和结果内容都采用XML格式封装,并增加了一些特定的HTTP消息头,以说明HTTP消息的内容格式,这些特定的HTTP消息头和XML内容格式就是SOAP协议(simpleobjectaccessprotocol,简单对象访问协议)。
SOAP协议=HTTP协议+XML数据格式
SOAP协议是基于HTTP协议的,两者的关系就好比高速公路是基于普通公路改造的,在一条公路上加上隔离栏后就成了高速公路。
商店的服务员只要收到了钱就给客户提供货物,商店服务员不用关心客户是什么性质的人,客户也不用关心商店服务员是什么性质的人。
同样,WebService客户端只要能使用HTTP协议把遵循某种格式的XML请求数据发送给WebService服务器,WebService服务器再通过HTTP协议返回遵循某种格式的XML结果数据就可以了,WebService客户端与服务器端不用关心对方使用的是什么编程语言。
HTTP协议和XML是被广泛使用的通用技术,各种编程语言对HTTP协议和XML这两种技术都提供了很好的支持,WebService客户端与服务器端使用什么编程语言都可以完成SOAP的功能,所以,WebService很容易实现跨编程语言,跨编程语言自然也就跨了操作系统平台。
这里提到了SOAP协议,就一定要做个试验,来增加学员的感性认识,学员才能真正理解上面精辟的理论总结,试验步骤如下:
1)接着前面的实验,使用浏览器访问http:
7070/itcast?
wsdl,可以看到一个wsdl文件内容(这个wsdl文件描述了Webservice服务的有关信息,客户端根据这个信息去调用服务)。
接着使用MyEclipse附带的WebServiceExplorer去调用上面发布的Webservice服务,尽管在最终结果的status视窗中可以通过”source”超链接查看WebService调用时的请求和响应消息的实体内容,但这种方式仍然不是很直观。
2)画图解释清楚代理监控器程序的运行原理,然后使用Myeclipse附带的TcpMonitor来检测Webservice调用过程的消息传输情况,监听的类型要设置为Tcp类型,它就不会修改HTTP请求头中的Host字段,最终使得WSDL文件中的绑定地址还是我们访问wsdl文件时的代理地址(WebService服务器程序是根据Http消息中的Host头字段来生成绑定地址信息)。
如果监听的类型设置为HTTP类型,它会修改Host头字段为目标地址,这样导致WSDL文件中的绑定地址又成了目标地址最终导致WebService调用过程跨过监听程序而无法实施监听。
另外,意外发现在TcpMonitor监听的地址上单击鼠标右键,发现还可以修改请求消息后再发发送请求,这个功能真好!
看来以后要多多到处单击鼠标右键试试,说不定就会有意外惊喜。
再另外,MyEclipse的TcpMonitor有一个显示头的菜单项,可以显示出http的请求头和响应头信息。
3.在myeclipse的工具栏上有一个lauchwebserviceexplorer的按钮,打开webserviceexplorer窗口后,要单击该窗口左上角的wsdlpage按钮,这样不必自己编写WebService客户端程序就可以WebService服务进行测试调用了,测试下前面两个例子。
WebService调用之前的工作
WSDL文件
好比我们去商店买东西,首先要知道商店里有什么东西可买,然后再来购买,商家的做法就是张贴广告海报。
WebService客户端要调用一个WebService服务,首先要知道这个服务的地址在哪,以及这个服务里有什么方法可以调用,所以,WebService服务器端首先要通过一个WSDL文件来说明自己家里有啥服务可以对外调用,服务是什么(服务中有哪些方法,方法接受的参数是什么,返回值是什么),服务的网络地址用哪个url地址表示,服务通过什么方式来调用。
WSDL(webservicedescriptionlanguage)是基于XML格式的,它是WebService客户端和服务器端都能理解的标准格式,其中描述的信息可以分为what,where,how等部分!
WSDL文件保存在Web服务器上,通过一个url地址就可以访问到它。
客户端要调用一个WebService服务之前,要知道该服务的WSDL文件的地址。
WebService服务提供商可以通过两种方式来暴露它的WSDL文件地址:
注册到UDDI服务器,以便被人查找
直接告诉给客户端调用者,例如,在自己网站给出信息或邮件告诉。
提问:
客户端首先要知道服务的信息,然后再来调用服务。
服务的信息用什么规范进行说明,调用服务采用什么协议。
Wsdl文件中的web服务的名称空间和连接的远程服务器本来相当于一个商标的产品不一定只在自己的公司卖的道理,wsdl文件中包含了连接服务的地址和名称空间两个东西。
wsdl文件用于描述对外的一项服务,其中的<
service>
元素中包含多个<
port>
元素,<
元素中又包含多个<
option>
元素,每个<
元素又包含一个<
input>
和一个<
output>
元素和<
元素的内容分别指向前面定义的一个<
message>
元素。
每个<
元素对应一个Java类,其中的每个<
元素对应Java类中的一个方法。
wsdl文件的组成,主要包括三个方面的内容:
what(服务是什么),where(服务在哪里),how(怎么调用服务)
WebService的工作过程
WebService的开发应用
WebService开发可以分为服务器端开发和客户端开发两个方面:
把公司内部系统的业务方法发布成WebService服务,供远程合作单位和个人调用。
(借助一些WebService框架可以很轻松地把自己的业务对象发布成WebService服务,Java方面的典型WebService框架包括:
axis,xfire,cxf等,javaee服务器通常也支持发布WebService服务,例如JBoss。
这框架应用不是学习的重点,看看相关的技术手册都很轻松地掌握,关键还是要了解WebService的工作原理。
)
调用别人发布的WebService服务,大多数人从事的开发都属于这个方面,例如,调用天气预报WebService服务。
(使用厂商的WSDL2Java之类的工具生成静态调用的代理类代码;
使用厂商提供的客户端编程API类;
使用SUN公司早期标准的jax-rpc开发包;
使用SUN公司最新标准的jax-ws开发包。
例如,参照axis的userguide目录下的第一个例子写客户端,就是使用厂商提供的编程API类。
WebService的客户端编程原理
代理图
我们给这个类WebService客户端API传递wsdl文件的url地址,这些API就会创建出底层的代理类,我调用这些代理,就可以访问到webservice服务。
代理类把客户端的方法调用变成soap格式的请求数据再通过HTTP协议发出去,并把接收到的soap数据变成返回值返回。
我们平常写的程序都是在同一个程序中调用其他对象的方法,而webservice是怎样实现调用其它计算机中的对象的方法的呢?
其基本原理是在客户端程序的本地有一个代理对象,这个代理对象和远程对象具有相同的方法声明,这个代理程序不用我们自己编写,工具可以帮我们生成。
客户端程序调用本地代理对象的方法时,代理对象会通过某种网络传送技术去联系远程的程序,远程程序再调用代理对象请求的相应本地对象的方法,然后将方法执行的结果返回给客户端代理程序。
远程调用技术就是要解决客户端如何将请求信息传送给远程的程序,远程的程序如何将结果回应给客户端,并且其实现技术对开发人员来说是透明的,即不需要开发人员自己的考虑和实现这些细节。
写多种客户端程序,每个客户端程序用一个单独的工程,如jaxrpcclient(分别用axis和xfire的实现),staticstub(分别用axis和xfire的实现),axisclient(包括代理与DII),xfireclient(包括代理与DII),jaxwsclient,wsstaticstub。
WebService客户端编程──工具生成静态代理类方式
xfire的WSGen
还需要额外导入ant.jar包
axis的WSDL2java
写批处理或直接在eclipse中运行这个类
jdk6的wsimport
cxf的…
每个工具的那么多内部细节,我就没有时间去深入研究了,但是,我对webservice的原理和这些工具的共同应用方式进行了很好的总结,所以,随便来个工具,我基本上都能随时玩起来。
在写批处理的过程中,如果%1参数代表的是文件,那么最好是用"
%1"
来表示,这样可以解决文件路径中有空格的问题。
使用axis的wsdl2java时,客户端程序如何调用,是参看userguide下的example6知道的。
生成的静态代理类内部其实还是包装了jax-rpc或jax-wsapi。
使用cxf的步骤:
1.搜索cxf,然后下载cxf开发包,解压后的文档中只有api类的doc,所以,还得在网站上读userguide和faq,并且多切换点击几次看到的内容不一样。
2.先试试其客户端的功能,在bin目录中看到wsdl2java.bat,看调用的是哪个java类,然后再eclipse中执行这个类,看提示信息,就知道要传递哪些命令参数了。
另外,在cxf的官网中,也能看到wsdl2java命令的选项的帮助。
设置的参数信息如下:
-dclient-pcn.clienthttp:
wsdl
运行时出了问题,要使用较新的jax-ws版本,覆盖jdk的endorsed目录。
3.生成的客户端代码有误,可能是我的jdk6中的jax-ws版本较低的缘故吧,删除掉这个错误方法就可以继续用了。
按老黎的提醒,把新版本的jax-ws.jar包拷贝到myelcipse的jdk的额外jar包中,并将它们移动到最前面,这个编译器问题就解决了。
对于获取手机号的例子,一下子出现了多个类,这些类之间的关系最好是参看wsdl来推敲:
<
wsdl:
servicename=“MobileCodeWS”>
往往对应了工厂类(Service类)的名字,其中的<
portname=“MobileCodeWSSoap12”>
说明了接口类的名称。
有空再看看wsimportc:
\a.wsdl生成的java源代码是怎样的,这时候程序内部的wsdl的url是什么?
WebService客户端编程──动态代理类方式
使用jax-rpc
第一步是创建xxx.Service实例对象
调用getPort返回代理,客户端的接口要实现remote接口,因为客户端代理是用java技术生成的,java生成的远程调用的代理必须实现remote接口,即我实现的代理靠的是java的remote技术。
使用jax-ws
第一步就是创建出javax.xml.ws.Service实例对象
jax-ws是代替jax-rpc的webservice标准,如果遇到还在使用jax-rpc,要知道是什么意思就可以了。
jaxrpcapi犹如jdbcapi,axis和xfire的实现犹如jdbcdriver包,在编程时只要jaxrpc.jar即可,运行时必须axis.jar或xfire.jar,通过ServiceFactory.SERVICEFACTORY_PROPERTY属性来选择具体的实现类
客户端程序并不包含指定连接远程服务器地址的途径,只包含指定wsdlURL和名称空间这两个参数。
这些api为什么接受的参数都是wsdl文件的路径,而不是服务绑定的地址呢?
这是因为解耦,假设服务路径变了,wsdl文件中的信息随主改变,客户端程序根据wsdl文件就知道要去新地址去服务,不需要修改源码。
客户端工程要与服务器端工程完全独立创建,并且编写客户端程序时,不要从服务器上拷贝任何东西,包括接口类,这才能体现异构平台的调用。
客户端的接口中的方法名与服务器端的接口的方法名必须一样,但参数的类型可以不完全一样(必须兼容,例如,整数可以用字符串方式传递,但字符串中的内容必须兼容整数)
客户端程序获取接口实例的代码可以抽取成一个方法或工具类,该方法接收一些相应参数,返回接口的代理实现。
用jax-rpc进行远程调用时,虽然服务器端的接口是普通接口,但客户端接口必须继承remote接口(但是用xfire自带的客户端api时,接口可以不继承remote接口,并且接口的名称可以与服务器不一致),这是因为java生成的远程调用代理对象有此要求,这与webservice本身没有关系,而是java在远程调用实现上的一个技术要求而已。
webservice可以返回复杂对象类型,从wsdl文件的描述上可以推测出,这个复杂类型只是描述有哪些属性而已,也就是只描述数据而已,不能描述方法,所以,如果服务器返回一个File对象,客户端会生成一个File类,该File类中只有原始File类中的get和set方法。
直接使用jws文件和jax-rpc的代理调用方式做webservice的实验中遇到的问题:
1.必须设置ServiceFactory.SERVICEFACTORY_PROPERTY属性
2.产生Service时必须指定wsdl文件的url地址
3.端口号和服务名的QName必须由两部分组成。
客户端程序总是报告方法的参数类型不一致,实在找不出错误来,结果重新启动程序后就好了。
使用jax-ws开发客户端时,那个Port对应的接口类不能随便自己写,必须用wsimport工具生成,并且要把所有生成的.java源文件都带上。
WebService客户端编程──动态方法调用(DII)
调用getCall返回Call对象,call的invoke实现动态调用。
jax-ws的DII比较麻烦,看了看那个dispatch的例子,暂时不想花时间去专研了
WebService客户端编程──用Socket编程方式调用
WebService框架的底层实现原理
技术实现原理:
各类WebService框架的本质就是一个大大的Servlet,当远程调用客户端给它通过http协议发送过来soap格式的请求数据时,它分析这个数据,就知道要调用哪个java类的哪个方法,于是去查找或创建这个对象,并调用其方法,再把方法返回的结果包装成soap格式的数据,通过http响应消息回给客户端。
只要把WebSerive框架做成一个Servlet,放在Tomcat中,是不是就具备Tcp服务器和接受客户端网络访问的功能了呢?
客户端访问这个Servlet,这个Servlet的功能充当WebService框架,客户端说的SOAP话是基于http协议的。
由于webservice是基于http协议的,所以webservice服务器端框架通常就是一个servlet程序,该servlet程序接收客户端的xml格式的请求,然后根据请求内容调用本地对象的方法,再将结果封装成xml格式返回给客户端。
如果传递的参数是复杂对象类型,这就又涉及到了xml2object和object2xml了。
使用任何框架进行配置时,都应该思考一个问题:
webservice框架调用服务类时,是只创建服务类的一个对象,还是每次创建一个对象,带着问题去找配置答案。
服务器工程也分成多个,分别是axisserver,xfireserver,jbossserver,wsriserver(参考实现,jdk6server
Axis
步骤:
1.首先直接把axis包中webapps目录下的axis例子程序复制到tomcat中,就配置好了axis的服务器端环境
2.写好一个服务类,将.java复制一份,改名为jws后介绍一下jws的即时发布技术。
3.读帮助文档,参照docs目录下的userguide目下中的第三个例子,获得一份wsdd文件,然后进行修改。
4.使用adminclient进行发布,需要使用setclasspath=%classpath%;
和拖动的方式逐一加入各个jar包,更好的办法是编写一个批处理,设置axis_lib=,然后设置classpath,然后用%1%2%3%4等执行adminclient。
更好的方式是将所有jar包导入到eclispe中,再eclipse中运行adminclient将更简捷)
5.给大家看发布后的结果,也就是生成了server-config.wsdd文件,要重新启动应用程序,才会生效。
6.直接访问axis的核心Servlet映射的URL地址(去掉*),可以看到部署的所有服务,看wsdl文件,说明wsdl文件的作用。
7.使用jdk6自带的wsimport生成客户端,报告错误,然后修改server-config.wsdd文件,在service中增加style="
document"
属性,重启动程序再次执行,成功搞定。
比较两次的wsdl文件不相同。
演示将wsdl保存到本地也是可以的,说清楚只要得到wsdl文件或其url地址,都可以知道对方的服务如何调用了。
(以前用myeclipse的tcpmonitor进行监视时,由于采用的是HTTP监视类型,所以只能是先把wsdl文件拿到手,然后改其中的连接信息,修改完后将这个文件放在tomcat服务器下的一个目录中进行访问,这倒是更好地说清楚了WSDL文件与SOAP的关系)
jws的一些问题:
1.jws文件不能采用utf-8编码
2.学员们在myeclipse启动tomcat,jws文件无法完成编译,直接手工启动tomcat则没问题。
adminclient的一些问题:
1.使用adminclient工具进行部署时,服务类要提前放在web项目的WEB-INF/classes目录中。
2.如果发布到的webapp的路径不是/axis,该怎么做?
看adminclient打印出的错误信息,接着单独执行adminclient看提示,解释下adminclient的工作方式即可搞定。
第7步正好可以根据上面的错误来引出soap消息的几种格式,推荐看黎活明的ejb书。
soap规定了如何将程序的数据和调用表示为xml格式,其格式可以分为rpc格式、文档格式和消息格式等,较常见的是rpc格式和消息格式,rpc格式就是将xml中的数据转换成java对象后处理和将java对象转换成xml数据后传输。
消息格式就是程序直接接收和发送xml对象,例如程序的方法定义为:
publicDocumentmethod(Documentbody),该方法接收的参数和返回值都是Document对象。
xfire
1.参照手册做第一个webservice服务器端例子,可以用config初始化参数来修改配置文件的位置,文件路径是相对当前web.xml文件的位置。
1)编写服务类
2)将服务类注册和部署成WebService
2.针对xfire项目,访问/mywebapp/services,可以验证xfir
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- web service