XFire组件开发WebService实例

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体系中许多新的规范提供了支持。 

2.  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框架的受权协议。

·         NOTICE.txt/README.txt：这两个文件中包含了XFire发布时的一些有用的信息。

 

3、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的简单实例大体就完成了！