WebService之XFire组件开发

1.websevice简介

WebService又是一种高级应用，与之前学习的Struts、Spring、Hibernate等框架不同。WebService是面向服务的架构（SOA）。那么它到底是做什么用的？什么才是面向服务的架构？让我们来看一种需求，集团公司可能具有多种WEB应用。比如，前年开发了个进销存系统、去年开发了一个ERP（企业资源计划）、今年又开发了一个OA（办公自动化）。现在这家集团公司需要将这三个系统整合，难道需要重新编码将它们整合吗？而这三个系统又是用不同语言编写的，这种成本对公司来说无疑是一种浪费。WebService可以很好的解决这种需求。

　　WebService是可以进行跨语言、跨平台、分布式系统间整合的方案，WebService像是一条线将这些系统穿起来——企业服务总线（ESB）。WebService使用简单对象访问协议（SOAP）使用http协议传输xml数据（xml是最常用的，也有其他格式数据。）来完成系带间的整合。

什么是整合？当然是功能和数据的整合，也就是一个系统可以调用另一个系统的WebService接口来完成数据的交互。这样我们就需要知道，提供WebService服务功能的应用公开了哪些接口，我们可以通过WebService描述文档（WSDL）得知。WSDL不需要我们手动编写，Java的WebService实现可以为我们自动生成。JDK1.6新增支持WebService，但还不够成熟。所以我们可以使用一些第三方开源组织提供的WebService组件。

2、Xfire组件

XFire 是与Axis 2并列的新一代Web Service框架，通过提供简单的API支持Web Service各项标准协议，帮助你方便快速地开发Web Service应用。

　相对于Axis来说，目前XFire相对受欢迎，加上其提供了和Spring集成的支持，在目前的Web Service开源社区拥有众多的追随者。并且因为XFire为Spring提供的支持，使得我们可以很容易在Spring中使用XFire构建Web Service应用。

　　XFire 与Axis2相比具有如下特征：

· 支持一系列Web Service的新标准–JSR181、WSDL2.0 、JAXB2、WS-Security等；

· 使用Stax解释XML,性能有了质的提高。XFire采用Woodstox 作Stax实现；

· 容易上手，可以方便快速地从pojo发布服务；

· 灵活的Binding机制，包括默认的Aegis,xmlbeans,jaxb2,castor；

· 高性能的SOAP 栈设计；

· 支持Spring、Pico、Plexus、Loom等容器。

　　XFire 与Axis1性能的比较如下：

· XFire 比Axis1.3快2-6倍；

· XFire 的响应时间是Axis1.3的1/2到1/5。

　　XFire 在WebService框架中开始较晚，它从现有的框架中借鉴了许多优秀的理念，力争将Web Service的应用开发难度降到最低。此外，还提供了各种绑定技术、支持多种传输协议，对WebService体系中许多新的规范提供了支持。
　　
　　3. XFire组件下载

XFire在2007年后已停止更新。正式更名为Apache CXF,亦可以说是XFire2.0。

　　XFire - XFire安装包：XFire框架目前最后的一个版本是1.2.6，在2007年5月3日发布，可以访问xfire.codehaus.org下载XFire框架的安装包。

　　解压缩后形成的文件目录结构如下：

· api目录：api目录中是XFire框架中所有类（class）对应的API文档，为开发者使用XFire完成应用开发提供帮助。

· examples目录：examples目录中包含了所有随XFire二进制包发布的实例，包括这些实例的源代码和相关Web应用配置内容。

· lib目录：lib目录中包含XFire运行所需要的外部支持类包（.jar文件），可以根据不同项目所需的XFire特性选择所需要的支持类包。保守的方法是在Web项目中包含所有的外部支持类包（.jar文件）。

· manual目录：manual目录中包含有XFire框架的帮助文档，开发者可以从这些帮助文档中学习更多运用XFire框架实现SOA的知识和技巧。

· modules目录：modules目录中包含了XFire框架根据不同特性分别编译的二进制包文件。发布基于XFire框架的Web项目时，可以选择使用该目录下的所有.jar文件，也可以选择XFire-all-1.2.6.jar文件。

· XFire-all-1.2.6.jar：XFire框架的二进制包文件，包含了全部的模块（modules）。

· LICENSE.txt：LICENSE.txt文件中包含了XFire框架的授权协议。

4、Eclipse使用XFire组件开发WebService实例

Ø 服务端开发

服务端的开发主要为外部提供webservice服务。Eclipse的大致目录结构如下：

首先需要在lib中导入xfire相关的jar包，大致需要导入如下jar包：

其次需要在web.xml中配置如下的信息：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

    <servlet>
        <servlet-name>XFireServlet</servlet-name>
        <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
        <load-on-startup>0</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>XFireServlet</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>

    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>   
</web-app>

具体配置的信息就不说了， 之后在配置好相关需要被调用的接口与方法，这个视自身需要情况而定。我 这里大致写的是求和的接口，IBankService

package com.mybank.xfire.example;

public interface IBankService {
    public int c(int a,int b);
}
//实现的类BankingService实现求和

 ackage com.mybank.xfire.example;

public class BankingService implements IBankService {

    @Override
    public int c(int a, int b) {
        // TODO Auto-generated method stub
        return a+b;
    }
}

然后在services.xml配置相关的bean信息，指定相关调用的名称，命名空间以及实现接口和实现类。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xfire.codehaus.org/config/1.0">          
    <service>   
        <name>Banking</name>   
        <namespace>mybank</namespace>   
        <serviceClass>com.mybank.xfire.example.IBankService</serviceClass>   
        <implementationClass>com.mybank.xfire.example.BankingService</implementationClass>   
    </service>                
</beans>

这样，xfire的webservice服务大致搭建成功了，启动相关的tomcat即可，访问wsdl的相关地址,看到有wsdl的相关信息即说明服务端搭建成功了。

Ø 客户端的开发

Xfire的客户端主要分为2种访问方式（以目前的水平知道有这两种），远程访问以及内部访问，以下是两种访问方式的大致实现：

l 远程访问webservice

client大致目录结构如下：

首先导入相关的jar包，如上所述基本是一样的。相关的client的代码如下（其中c指的是所调用的方法）：

package com.mybank.xfire.client;
import java.net.MalformedURLException;
import java.net.URL;
import org.codehaus.xfire.client.Client;

public class AddWSClient {

    /**
     * @param args
     * @throws Exception 
     * @throws MalformedURLException 
     */
    public static void main(String[] args) throws MalformedURLException, Exception {
        Client client = new Client(new URL("http://localhost:8080/testWebservice/services/Banking?wsdl"));
        Object[] result = client.invoke("c",new Object[]{2,3});
        System.out.println(result[0]);      

    }

}
l l 内部访问webservice

内部访问webservice的client代码大致如下：


package com.mybank.xfire.client;

import org.codehaus.xfire.XFire;
import org.codehaus.xfire.XFireFactory;
import org.codehaus.xfire.client.XFireProxyFactory;
import org.codehaus.xfire.service.Service;
import org.codehaus.xfire.service.binding.ObjectServiceFactory;

import com.mybank.xfire.example.IBankService;
import com.sun.org.apache.xerces.internal.util.URI.MalformedURIException;

public class BankClient {

  public static void main(String[] args) throws MalformedURIException, Exception {
    BankClient bank = new BankClient();
    int s = bank.callWebService(2,3);
    System.out.println(s);
  }

  public int callWebService(int a,int b)
  throws MalformedURIException,Exception
  {
    //Create a metadata of the service 创建一个service的元数据
    Service serviceModel = new ObjectServiceFactory().create(IBankService.class);

    //Create a proxy for the deployed service 为XFire获得一个代理工厂那个对象
      XFire xfire = XFireFactory.newInstance().getXFire();
      XFireProxyFactory factory = new XFireProxyFactory(xfire);

      //得到一个服务的本地代理
      String serviceUrl = "http://localhost:8080/testWebservice/services/Banking";

      IBankService client = null;

      try {
        client = (IBankService) factory.create(serviceModel, serviceUrl);

      } catch (Exception e) {
        System.out.println("WsClient.callWebService():Exception:"+e.toString());

      }

    //invoke the service 调用服务 返回状态结果
      int serviceResponse = 0;
      try {
        serviceResponse = client.c(a, b);
      } catch (Exception e) {
        e.printStackTrace();
      }

    return serviceResponse;
  }

}

Console输出5，则说明调用成功，至此，xfire的简单实例大致就完成了！