科技行者

行者学院 转型私董会 科技行者专题报道 网红大战科技行者

知识库

知识库 安全导航

至顶网软件频道应用软件XFire 最新生火指南(上)

XFire 最新生火指南(上)

  • 扫一扫
    分享文章到微信

  • 扫一扫
    关注官方公众号
    至顶头条

网上的文档与例子总是不新,大家抛开所有的文档,所有的Axis习惯,单看这份代表XFire1.2.2最简约做法的文档。

作者:江南白衣 来源:CSDN 2008年3月27日

关键字: 指南 最新 XFire Web开发 软件

  • 评论
  • 分享微博
  • 分享邮件

1. 概述

   XFire 是全球众多牛人在与axis系列对比后一致投票的选择。我比较欣赏的特性有:

  1. 与Spring整合,无须生成一堆文件,无须打包独立war,直接将应用中的Pojo导出为服务。
  2. Aegis--超简约的默认Java XML 绑定机制,且可以Plugin其他绑定机制。
  3. JSR181--annotatiton驱动的POJO WebService配置。
  4. 基于Stax的高性能框架
  5. 脱离Web服务器的单元测试能力。

   网上的文档与例子总是不新,大家抛开所有的文档,所有的Axis习惯,单看这份代表XFire1.2.2最简约做法的文档。

2. 生火指南

2.1 修改web.xml,在Web应用中增加XFire的入口

   xfire的入口,注意XFire有了自己的Servlet,不再依赖Spring MVC的Servlet,也就远离了大家不熟悉的Spring MVC URL Mapping,与Spring达致完美的整合。

   这里指定了路径为/service/* ,即WebService的URL会被默认生成为其中BookService默认为2.2中的接口名。

 

<servlet>
  
<servlet-name>xfire</servlet-name>
  
<servlet-class>org.codehaus.xfire.spring.XFireSpringServlet</servlet-class>
 
</servlet>
 
<servlet-mapping>
  
<servlet-name>xfire</servlet-name>
  
<url-pattern>/service/*</url-pattern>
 
</servlet-mapping>

 

2.2 编写窄接口,抽取POJO中要导出的服务

   从已有的BookManager.java中,抽取出一个窄接口,仅暴露需要导出为Web Service的方法。而BookManger.java是POJO,不需要任何WebService相关代码。

  窄接口一方面满足了安全要求,不用整个BookManager所有方法导出为Web Service;另一方面,XFire暂时也只支持基于接口的Proxy。

public interface BookService {
   List
<Book> findBooksByCategory(String cateoryId);
}

 

 2.3 配置Java-XML Binding

   XFire默认的Aegis Binding语法非常简单,在SpringSide的例子里几乎一行配置都不用写,是我见过最简单的binding定义,大大优于其他以设计复杂为终极目标的方案。

   对象的属性、函数的参数和返回值如果为int、String、Date等普通类型以及由普通类型组成的复杂对象都无需定义。我见到只有两种情况需要定义:

  • 无法使用泛型定义Collection中元素的类型时--如List findBooks()。如果能写成List<Book> findBooks()就也不需要了。
  • 需要为属性定义不同的名字,或者定义复杂对象里的某些属性不要输出。

   XFire以约定俗成代替配置,如果万一真的需要aegis配置,所有Service和Entity Bean的binding文件要求命名为xxx.aegis.xml,而且要和原来的类sit together在同一目录里。

<mapping>
        
<!--配置findBooksByName服务的返回值,List内对象为Book-->
        
<method name="findBooksByName">
            
<return-type componentType="org.springside.bookstore.domain.Book"/>
        
</method>
       
<!--配置Category类,忽略内嵌的products属性不要输出XML-->
       
<property name="products" ignore="true"/>
</mapping>

 

   其他语法详见Aegis 参考。

2.4 配置Spring导出

    为了节约代码,配置一个基类,注意导出的服务不能lazy-init:

<!-- 导入XFire基本配置文件 -->
<import resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>

<bean id="baseWebService" class="org.codehaus.xfire.spring.remoting.XFireExporter" lazy-init="false"
    abstract
="true">
  
<property name="serviceFactory" ref="xfire.serviceFactory"/>
  
<property name="xfire" ref="xfire"/>
 
</bean>

 

 每个Web服务的定义:parent为基类,serviceClass property设置Web Service的接口,serviceBean property设置Web Service的实现类。

<bean id="bookService" parent="baseWebService">
  
<property name="serviceBean" ref="bookManager"/>
  
<property name="serviceClass" value="org.springside.bookstore.components.xfire.server.simple.BookService"/>
 
</bean>

Web服务导出完毕,用户可在查看自动生成的WSDL。 

上半章完,关于JSR181,Client API与测试部分请看XFire 生火指南(下)

    • 评论
    • 分享微博
    • 分享邮件
    邮件订阅

    如果您非常迫切的想了解IT领域最新产品与技术信息,那么订阅至顶网技术邮件将是您的最佳途径之一。

    重磅专题
    往期文章
    最新文章