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的大致目录结构如下:
WebService之XFire组件开发
首先需要在lib中导入xfire相关的jar包,大致需要导入如下jar包:
WebService之XFire组件开发
其次需要在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的相关信息即说明服务端搭建成功了。

WebService之XFire组件开发
Ø 客户端的开发

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

l 远程访问webservice

client大致目录结构如下:
WebService之XFire组件开发
首先导入相关的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的简单实例大致就完成了!

上一篇:内网安装ansible的两种方法


下一篇:P4语言——p4runtime