`
江南白衣
  • 浏览: 550949 次
  • 来自: 广州
社区版块
存档分类
最新评论

XFire生火指南(下)

阅读更多

本文来自SpringSide WIki,请留意Wiki上的最新版本

1. JSR181

     JSR181式通过annotated POJO ,零配置文件的导出Web服务,是BEA倡导的,JavaEE5里的正规方式, XFire作了良好的支持。

     但是,XFire关于JSR181方式的文档还不够清晰,请完整阅读本节以避免其中的陷阱。

1.1 参考文章

1.2 ApplicationContext.xml

    因为Web服务配置都写在了annotation,applicationContext.xml文件的内容变得比较固定。需要注意JSR181WebAnnotations与HandlerMapping不能lazy init。

java 代码
  1. default-autowire="byName">   
  2.   <!---->   
  3.  <import resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>    
  4.   
  5.  <!---->   
  6.  "webAnnotations" class="org.codehaus.xfire.annotations.jsr181.Jsr181WebAnnotations"  lazy-init="false"/>   
  7.   
  8.   
  9.  <!---->   
  10.  "jsr181HandlerMapping" class="org.codehaus.xfire.spring.remoting.Jsr181HandlerMapping"  lazy-init="false">   
  11.   "xfire" ref="xfire"/>   
  12.   "webAnnotations" ref="webAnnotations"/>   
  13.     
  14.   

1.3 Interface+Impl模式

   不同于XFire传统模式,窄接口不是必须的,只是考虑到有个接口,配置都在接口上做,对原来的Manager类侵入较少。

   如果采用Interface,Interface将担任主要的配置工作。

   首先定义@WebService,可定义自己的NameSpace,如果不定义将采用默认的生成算法。

   接口中的函数将默认全部导出,不需要再用@WebMethod注释,也可以如下例般进行关于Param,Result的更进一步配置:

java 代码
  1. @WebService(targetNamespace = "http://www.springside.org.cn")   
  2. public interface BookService {   
  3.   @WebResult(name = "SearchResult")   
  4.   List<book></book> findBooksByCategory(@WebParam(name = "category", header = true)String cateoryId);   
  5. }  

       Manager不是纯粹的POJO,需要带上@WebService注释,指明接口。

java 代码
  1. @WebService(serviceName = "BookService", endpointInterface = "org.springside.bookstore.components.xfire.server.jsr181.BookService")   
  2. public class BookManager implements BookService {   
  3. ...   
  4. }  

      陷阱一:XFire JSR181参考文档  中在Interface中以@WebService(name="BookService")来定义ServiceName,这个做法看起来也比较合理,但实际上需要在Manager中以@WebService(serviceName ="BookService") 来定义,比较古怪。

1.4 纯POJO模式

    参考文档中的例子,需要配置@WebMethod 指定需要导出的函数。

java 代码
  1. @WebService(name = "EchoService", targetNamespace = "http://www.openuri.org/2004/04/HelloWorld")   
  2.         public class Jsr181EchoService   
  3. {   
  4.     @WebMethod(operationName = "echoString", action = "urn:EchoString")   
  5.     @WebResult(name = "echoResult")   
  6.     public String echo(@WebParam(name = "echoParam", header = true) String input)   
  7.     {   
  8.         return input;   
  9.     }   
  10. }  

1.5 Client注意事项

    陷阱二:和传统模式的client有一点最大的区别,serviceModel需要实际的Manager类而不是接口类来做参数:

java 代码

  1. Service serviceModel = new AnnotationServiceFactory().create(BookManager.class);  

 

2. Client

XFire的Client并不算强项,一共有三种模式:

2.1 Client开发者拥有Web服务端的class

  Client与Server是同一个开发团队也好,Server端团队以jar形式提供开发包也好,反正如果能拿到服务端的接口Class和Entity类及aegis 配置文件的话。

  传统POJO模式:

java 代码
  1. Service serviceModel = new ObjectServiceFactory().create(BookService.class);   
  2. BookService service = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);   
  3. service.findBooksByCategory(cateoryId);  

  JSR181模式,注意这里Server端开发组需要向Client提供BookService的实现类BookManager,而不止于接口,有点危险: 

java 代码
  1. Service serviceModel = new AnnotationServiceFactory().create(BookManager.class);   
  2. BookService = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);   
  3. service.findBooksByCategory(cateoryId);  

  SpringSide 用泛型封装了一个XFireClientFactory,调用代码如下:

java 代码
  1. BookService service = XFireClientFactory.getClient(serviceURL, BookService.class);   
  2. BookService service = XFireClientFactory.getJSR181Client(serviceURL, BookService.class, BookManager.class);   

 

2.2 动态模式

    动态模式不需要服务端的class,不过性能和复杂对象映射等估计做得不会太好。

java 代码
  1. Client client = new Client(new URL("http://www.webservicex.net/CurrencyConvertor.asmx?WSDL"));   
  2.   
  3. Object[] results = client.invoke("ConversionRate"new Object[] {"BRL""UGX"});  

2.3 根据WSDL生成Client Stub

    这才是Web Service Client的王道,可以访问任意编写下的Web Service,将在下一个版本中演示。

3. 测试

XFiire很重要的一个特性是提供了无须启动Web容器也能进行单元测试的能力。

原理就是利用XFire的JVM模式,以xfire.local://BookService 而不是http://localhost/service/BookService 来访问服务。

测试的方式分两种:

一种是纯服务器角度,不编写客户端代码,以SOAP XML形式发送请求,返回的也是SOAP XML字串,直接对XML进行测试。

一种是编写2.1 中Client代码来进行测试。

前一种的测试的隔离度较高,而后一种比较简便。

3.1 测试基类 

无论那种方式,都使用Xfire的AbstractXFireSpringTest基类,实现createContext()回调函数。

java 代码
  1. protected ApplicationContext createContext() {    
  2.      return ClassPathXmlApplicationContext(new String[]{"classpath*:applicationContext*.xml"});   
  3.  }   

另外测试基类还要完成一个很重要的工作就是要解决Hibernate的LazyLoad问题,做到OpenSession In Test。因此,SpringSide专门封装了一个XFireTestCase的基类。

3.2 用Client代码直接测试

     下文直接用client代码调用findBooksByCategory方法,得到返回值后进行各种Assert判断。

     注意和普通client code的两处区别:servericeURL换成local,factory须加入getXFire()作参数。

分享到:
评论
1 楼 zhufanamo 2007-01-13  
问一下..web servive 是否提供直接的 url的访问?
动态模型一样.直接通过url..不要client对象,
http://www.webservicex.net/CurrencyConvertor.asmx?WSDL&method=ConversionRate&BRL
返回值是在response里的..


相关推荐

    xfire 开发指南

    xfire开发指南 xfire开发指南 xfire开发指南

    XFire开发指南第二版

    《XFire开发指南第二版》是一本专注于XFire框架深入理解和应用实践的权威教程。XFire,一个曾经在Java世界中流行的轻量级服务框架,为开发者提供了构建基于SOAP和RESTful服务的强大工具。该书的第二版针对XFire的...

    WebService XFire开发指南

    【WebService XFire开发指南】 在IT行业中,WebService是一种基于开放标准(如SOAP、WSDL和UDDI)的协议,允许不同系统之间的应用程序通过互联网进行通信。它提供了一种松散耦合的方式,使得分布式系统可以共享数据...

    xfire开发指南,及与spring集成

    里面包括了3个PDF文档 1:Xfire-野猪书-开发指南 2:xfiretutorial 3:xfire-spring 为你的工程提供一个更好的远程服务,做好数据交换第一步 XFire是当前J2EE领域非常流行的Web Service框架,以其卓越的...

    XFire开发指南.rar

    **XFire开发指南** XFire,作为下一代Java SOAP框架,为开发者提供了一种高效、便捷的方式来构建面向服务架构(Service-Oriented Architecture, SOA)的应用程序。在深入探讨XFire之前,我们先来理解一下SOAP...

    XFire开发指南,很详细的书

    ### XFire开发指南知识点概述 #### 一、XFire简介 - **定义**: XFire是一个高性能的Java SOAP框架,用于构建面向服务架构(SOA)的应用程序。 - **特点**: - 支持多种标准:如SOAP、WSDL、WS-I Basic Profile、WS-...

    xfire开发指南.......

    ### XFire开发指南知识点概述 #### 一、XFire简介 - **定义**: XFire是一个高性能的Java SOAP框架,用于构建面向服务架构(SOA)的应用程序。 - **特性**: - 支持多种标准:如SOAP、WSDL、WS-I Basic Profile、WS-...

    Web Service XFire框架开发指南

    **Web Service XFire框架开发指南** Web Service是一种基于开放标准(如XML、WSDL和SOAP)的互联网通信协议,允许不同系统之间的应用程序进行交互。XFire是Java平台上的一个开源Web Service框架,它提供了一种简单...

    xfire

    压缩包中的"wsbook"可能是xfire相关文档或教程的集合,可能包含了关于xfire的API文档、开发指南、或者是用户手册等内容。这些文档对于想要基于xfire进行二次开发或者了解xfire工作原理的人来说是非常宝贵的资源。 ...

    Xfire WebService框架搭建指南

    本指南将详细介绍如何利用Xfire搭建服务器端和客户端,以便于理解并掌握其核心功能。 ### 一、服务器端搭建 1. **创建Web项目** 由于Web服务是基于网络的,服务器端需要是Java Web项目。首先,我们需要创建一个新...

    xfire依赖jar包

    xfire是一个早期流行的开源Web服务框架,主要用于构建SOAP(简单对象访问协议)和RESTful(Representational State Transfer)服务。这个框架使得Java开发者能够轻松地创建、部署和消费Web服务。xfire依赖于一系列的...

    xfire-all-1.2.6 xfire所需的全部包

    同时,其优秀的兼容性使其能在多种操作系统环境下稳定工作,满足了不同用户的需求。 综上所述,Xfire 1.2.6不仅是一个通讯工具,更是一个游戏世界的社交中心。它通过强大的游戏集成、即时通讯和丰富的社区功能,...

    WebService-xfire和axis开发指南

    "XFire开发指南.pdf" 可能涵盖了如何安装和配置XFire环境,创建第一个WebService,使用XFire的注解和API,以及如何进行测试和调试等内容。而"Axis1[1].4+开发指南_V1.0.pdf"则可能详细介绍了Axis1.4版本的使用,包括...

    Xfire API,Xfire帮助文档

    Xfire API 是一款专为游戏社区设计的接口,它允许开发者构建与Xfire服务交互的应用程序,从而增强玩家的游戏体验并提供社交功能。Xfire API 主要围绕Web服务概念,这意味着它通过网络提供一系列功能,使得第三方...

    Xfire-v1.99 XFire最高版本

    **XFire v1.99:WebService开发框架详解** XFire,全称为XFire Integration Library,是一个基于Java的开源框架,专门用于构建和部署Web服务。这个“XFire最高版本”指的是XFire项目的最终或最优化的版本,它提供了...

    xfire相关jar包

    进行WebService开发中所用到的xfire所有相关包如:xfire-jsr181-api-1.0-M1.jar、xfire-jaxws-1.2.6.jar、xfire-java5-1.2.6.jar、xfire-core-1.2.6.jar、xfire-annotations-1.2.6.jar、xfire-aegis-1.2.6.jar、...

Global site tag (gtag.js) - Google Analytics