在Eclipse上使用XFire开发WebService.docx
《在Eclipse上使用XFire开发WebService.docx》由会员分享,可在线阅读,更多相关《在Eclipse上使用XFire开发WebService.docx(24页珍藏版)》请在冰点文库上搜索。
在Eclipse上使用XFire开发WebService
在Eclipse上使用XFire开发WebService
WebService概述
什么是WebService
WebService是能够基于网络,尤其是基于万维网(WorldWideWeb)直接调用的能够处理离散任务或连续任务的软件模型。
目前较为流行的应用是,由一家公司对其专有数据进行封装,提供WebService,然后其它公司就可以通过Internet来动态使用这些在线服务。
这为未来全球的电子商务发展提供了新的标准和架构。
WebService架构
WebService是独立的、模块化的应用,能够通过因特网来描述、发布、定位以及调用。
在WebService的体系架构中包括三个角色:
服务提供者(ServiceProvider)、服务请求者(ServiceRequestor)、服务注册器(ServiceRegistry)。
角色间主要有三个操作:
发布(Publish)、查找(Find)、绑定(Bind)。
下图清楚的描述了三种角色,以及角色之间的作用关系。
图示一:
图示二:
这个流程图显示了WebServices中的核心技术是如何工作的。
这里,Provider是提供服务的应用程序组件,Requester是使用服务的客户端程序。
很多其他技术也会参与到交互中,但是这个图只显示了在WebServices环境中必需的核心技术组件。
WebService协议标准
简单对象访问协议(SOAP)
SOAP是SimpleObjectAccessProtocol的缩写,是一种基于XML的不依赖传输协议的表示层协议,用来在分散或分布式的应用程序之间方便地以对象的形式交换数据。
在SOAP的下层,可以是HTTP/HTTP,也可以是SMTP/POP3,还可以是为一些应用而专门设计的特殊的通信协议。
SOAP包括三个主要部分:
² SOAP封装结构:
定义了一个整体框架,以表示消息中包含什么内容,谁来处理这些内容以及这些内容是可选的或是必需的。
² SOAP编码规则:
定义了用以交换应用程序定义的数据类型的实例的一系列机制。
² SOAPRPC表示:
定义了一个用来表示远程过程调用和应答的协定。
WebService描述语言(WSDL)
WSDL是WebServiceDescriptionLanguage的缩写,该语言将网络服务定义成一个能交换消息的通信端点集,为分布式系统提供了帮助文档,同时也可作为自动实现应用间通信的解决方案。
统一描述、发现和集成协议(UDDI)
UDDI是一套基于Web的、分布式的、为WebService提供的、信息注册中心的实现标准规范,同时也包含一组使企业能将自身提供的WebService注册,以使别的企业能够发现的访问协议的实现标准。
以上概念转自
XFire
XFire是一个免费的开源SOAP框架,它不仅可以极大方便地实现这样一个环境,并且可以提供许多WebServices规范中高级特征,这些特征在多数的商业或者开源工具都没有提供。
http:
//xfire.codehaus.org/Download是它的官方网站下载区,同时你也可以了解关于它的更多内容。
创建过程示例
下面我们就来使用Java构建一个WebService并且构建一个客户端来测试访问它。
首先请确保你的JDK和Tomcat在Eclipse环境中是可用的,配置方法不做赘述。
并且你了解一些java编程技术和tomcat的发布常识。
版本信息:
MyEclipse6.0.0M1;Tomcat6.0;JDK1.5;Xfire1.2
1、打开MyEclipse新建一个WebServiceProject,为你的项目命名,我选择了JavaEE5.0,项目在你的WorkSpace目录下。
下一步:
看到了这个界面
在这里Eclipse为你创建了webService的配置文件services.xml(主意文件名是有“s”的),并进行了Xfire的Servlet基本配置告诉项目你使用了Xfire改信息将体现在项目的web.xml文件中。
继续下一步,加载Xfire相关的jar包,你看到了
在这个项目里我勾选了Xfire1.2CoreLibraries;HTTPClientLibraries;XMLBeansLibraries。
主要是确保引入了这些包包:
?
activation-1.0.2.jar
?
commons-codec-1.3.jar
?
commons-httpclient-3.0.jar
?
commons-logging-1.0.4.jar
?
jaxen-1.1-beta-8.jar
?
jdom-1.0.jar
?
log4j-1.2.x.jar
?
mail-1.3.3_01.jar
?
spring-1.2.x.jar
?
stax-api-1.0.jar
?
wsdl4j-1.5.2.jar
?
wstx-asl-2.9.jar
?
xbean-2.1.0.jar
?
xbean-spring-2.2.jar
?
xfire-all-1.0.jar
?
XmlSchema-1.0.jar
如果你好奇其他的包包是做什么用的就有待于我们在今后的学习中继续探究了~点击“Finish”完成了项目创建。
目录结构如下图所示:
打开web.xml我们可以看到如下片断:
xml代码
1.
2. XFireServlet
3. org.codehaus.xfire.transport.http.XFireConfigurableServlet
4. 0
5.
6.
7. XFireServlet
8. /services/*
9.
10.
11. index.jsp
12.
13.
接下来的工作是开始编写java类接下来我们要写一个服务端java类。
模拟应用是一个银行转账应用,从账户A转账到账户B并需要给出金额和货币种类。
我们先来实现一个接口IBankingService.java代码全文如下:
java代码
1.package com.mybank.xfire.example;
2.
3.public interface IBankingService {
4.
5. public String transferFunds(
6. String fromAccount, String toAccount, double amount, String currency);
7.
8.}
9.
然后编写一个普通的Java类BankingService包含了一个叫做transferFunds()的方法来为我们完成这项工作。
它需要四个输入参数:
∙ 1、StringfromAccount
∙ 2、StringtoAccount
∙ 3、doubleamount
∙ 4、Stringcurrency
代码如下:
java代码
1.package com.mybank.xfire.example;
2.
3.import java.text.NumberFormat;
4.import java.text.DecimalFormat;
5.
6.public class BankingService implements IBankingService {
7.
8. //Default constructor.
9. public BankingService(){
10. }
11.
12. /** Transfers fund from one account to another.
13. */
14. public String transferFunds(
15. String fromAccount, String toAccount, double amount, String currency){
16.
17. String statusMessage = "";
18.
19. //调用业务逻辑执行操作.
20. //建立并返回状态信息.
21. try {
22. NumberFormat formatter = new DecimalFormat("###,###,###,###.00");
23. statusMessage = "COMPLETED:
" + currency + " " + formatter.format(amount)+
24. " was successfully transferred from A/C# " + fromAccount + " to A/C# " + toAccount;
25. } catch (Exception e){
26. statusMessage = "BankingService.transferFunds():
EXCEPTION:
" + e.toString();
27. }
28. return statusMessage;
29. }
30.
31.}
32.
你可以看到BankingService是一个普通的Java类,没有任何代码告诉我们它将会在WebServices中使用。
只是要有默认的构造函数,类型是public。
这是必须的。
否则,XFire不能够初始化这个类。
好的,这里我们不需要增加任何东西。
我们所有的工作都在部署描述符里完成。
Web应用的部署描述符
在Java中,Web应用程序通常需要至少一个部署描述符(叫做web.xml)对其进行配置。
XFire本身是一个基于servlet的应用程序。
因此,我们需要增加必要的引用到描述符文件中。
然后我们还必须配置将要创建的WebServices。
我们使用一个称为services.xml的新文件来完成这件事。
在使用Eclipse工具构建工程的时候我们已经完成了这项配置(参见(上)文)。
services.xml
现在我们不得不说一下我们的WebServices的由什么组成的了。
这由一个叫做services.xml的文件完成,当这个项目在tomcat发布后,它存放在WEB-INF/classes/META-INF/xfire目录下,它在Web应用程序的标准类路径中。
而在Eclipse环境中我们可以清楚的看到Eclipse已经为我们把它清楚的列在项目路径中。
这里是services.xml中的基本配置条目:
xml代码
1.//xfire.codehaus.org/config/1.0">
2.
3.
4. Banking
5. mybank
6. com.mybank.xfire.example.IBankingService
7. com.mybank.xfire.example.BankingService
8.
9.
10.
WebServices的定义包含在元素中,它还含有一些子元素。
第一个子元素是Banking,它可以是你提供任何的合法名字。
这将会被客户端程序和其它需要定位你的服务的组件用到。
例如,在服务准备好以后,你将在浏览器上使用这个名字来查看WSDL。
下一个子元素是。
任何合法的XML名字都是可以的。
用来唯一标识你的服务的各个参数。
(注释@)
注释@:
Namespace派什么用?
namespace的作用是要避免命名冲突。
如果我建立一项Web
Service,其中的WSDL文件包含一个名为"foo"的元素,而你想要使用我的服务与另一项服务连接作为补充,这样的话另一项服务的WSDL文件就不能包含名为"foo"的元素。
两个服务器程序只有在它们在两个事例中表示完全相同的东西时,才可以取相同的名字。
如果有了表示区别的namespace,我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。
在你的客户端里,你只要加以限制就可以引用我的"foo"。
元素包含了Java类的名字,它指定了方法签名。
在我们的例子中,它是接口IBankingService。
如果Java类没有实现任何接口,你就需要把类的名字放在这里。
在你的Java类或者接口中可能有几个方法。
只需要一个入口把它们全部发布为WebServices。
保存了实现方法的Java类名。
这是一个可选元素。
如果上一个元素包含了一个接口,那么相应的实现类必须在这里指定。
就是这样。
我们的WebServices配置完成了。
我们如何知道WebService正在工作呢?
为了了解WebService是否正在工作,我们需要测试。
首先,我们测试来看WSDL是否可用。
我们在浏览器中输入URL。
哪个URL?
因为我们的应用程序的war文件是aa.war,并且在services.xml中给出的服务名是Banking,WSDL的URL应该是:
http:
//localhost:
8080/aa/services/Banking?
wsdl。
请注意:
URL的第一部分,例如,http:
//localhost:
8080,可能会根据你的应用服务器不同而不同。
无论怎样,当你输入URL后,将会看到一个XML文档,这个文档叫做服务的WSDL。
如果你看到了,这就是你的应用作为WebService已经可用的第一个证明。
正确的执行情况:
在这个WSDL中我们可以看到elementname="transferFunds">的服务方法明以及他的四个参数描述等信息。
但是这个测试是不够的。
可能会发生这种情况,可以看到WSDL,但是从客户端程序可能会访问不到服务。
因此为了核实服务是否可以访问了,我们必须使用一个客户端进行服务的实际调用来进行一个真正的测试。
开发一个客户端
编写BankClient.java
java代码
1.package com.mybank.xfire.client;
2.
3.import .MalformedURLException;
4.import org.codehaus.xfire.XFire;
5.import org.codehaus.xfire.XFireFactory;
6.import org.codehaus.xfire.client.XFireProxyFactory;
7.import org.codehaus.xfire.service.Service;
8.import org.codehaus.xfire.service.binding.ObjectServiceFactory;
9.
10.import com.mybank.xfire.example.IBankingService;
11./**
12. * @author AdminiDD
13. *
14. */
15.public class BankClient {
16.
17. /**
18. * @param args
19. */
20. public static void main(String[] args) {
21. // TODO Auto-generated method stub
22.
23. }
24. /* Call the Web service
25. *
26. */
27. public String callWebService(
28. String fromAccount, String toAccount, double amount, String currency)
29. throws MalformedURLException, Exception {
30.
31. //Create a metadata of the service 创建一个service的元数据
32. Service serviceModel = new ObjectServiceFactory().create(IBankingService.class);
33. System.out.println("callSoapServiceLocal():
got service model." );
34.
35. //Create a proxy for the deployed service 为XFire获得一个代理工厂对象
36. XFire xfire = XFireFactory.newInstance().getXFire();
37. XFireProxyFactory factory = new XFireProxyFactory(xfire);
38. //得到一个服务的本地代理
39. String serviceUrl = "http:
//127.0.0.1:
8080/wstest/services/Banking";
40.
41. IBankingService client = null;
42. try {
43. client = (IBankingService) factory.create(serviceModel, serviceUrl);
44. } catch (MalformedURLException e) {
45. System.out.println("WsClient.callWebService():
EXCEPTION:
" + e.toString());
46. }
47.
48. //Invoke the service 调用服务 返回状态结果信息
49. String serviceResponse = "";
50. try {
51. serviceResponse = client.transferFunds(fromAccount, toAccount, amount, currency);
52. } catch (Exception e){
53. System.out.println("WsClient.callWebService():
EXCEPTION:
" + e.toString());
54. serviceResponse = e.toString();
55. }
56. System.out.println("WsClient.callWebService():
status=" + serviceResponse);
57.
58. //Return the response
59. return serviceResponse;
60. }
61.
62.}
63.
编写两个JSP页来模拟请求和响应
index.jsp;发送请求
&13;&10;">&13;&10;">
java代码
1.
2.
3.
4."-//W3C//DTD HTML 4.01 Transitional//EN">
5.
6.
7. "">
8.
9.
10. "pragma" content="no-cache">
11. "cache-control" content="no-cache">