使用XFire组件开发WebService实例

 

使用XFire组件开发WebService实例

 

1、WebService简介

  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组件

  1.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、MyEclipse使用XFire组件开发WebService实例

  服务端(为客户端提供WebService接口)开发:

  1.创建工程,导入XFire组件所需jar包到lib下:xfire-all-1.2.6.jar和lib目录所有jar包(根据实际需要确定)。

  2.创建完成后,打开web.xml,XFire的配置如下:

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    version="2.5" 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>

  3.创建Java Code和services.xml。

  服务端接口和默认实现:

public interface HelloWebService {

    public String example(String message);

}

 

public class HelloWebServiceImpl implements HelloWebService {

    public String example(String message) {

        return "这是服务端返回:" + message;

    }

}

  创建对应的services.xml配置文件,xfire默认的加载services.xml路径是classes\META-INF。代码如下:

<?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://xfire.codehaus.org/config/1.0">

    <service>

        <name>HelloWebService</name>

        <serviceClass>com.server.HelloWebService</serviceClass>

        <implementationClass>com.server.HelloWebServiceImpl</implementationClass>

    </service>

</beans>

  至此,服务端代码生成完毕!工程结构如图:

使用XFire组件开发WebService实例

  部署并测试服务端:

  1. 将服务端部署到Tomcat上,并启动Tomcat。
  2. 选择Toolbars上的Launch SOAP Web Service Explorer,Web Services Explorer窗口右侧WSDL Page,输入网址:http://localhost:8080/WebServiceServer/services/HelloWebService?wsdl,点Go,若成功则Status会提示。
  3. 双击examlpe,输入hello,下面会显示out(string):hello,测试通过。

  开发客户端(调用服务端提供的WebService接口方法):

  经过以上几步,我们已经成功发布了一个WebService,现在需要创建一个客户端来调用该服务

  1. 创建Java Project:WebServiceClient
  2. 引入XFire组件所需jar包:commons-codec-1.2.jar、commons-httpclient-3.0.jar、jdom.jar、xfire-all-1.2.6.jar、wsdl4j-1.5.1.jar、commons-logging-1.0.4.jar。
  3. 创建Java Code客户端,调用WebService:
import java.net.URL;

import org.codehaus.xfire.client.Client;

public class HelloWSClient {

    public static void main(String[] args) throws Exception{

        Client client = new Client(new URL("http://localhost:8080/WebServiceServer/services/HelloWebService?wsdl"));

        Object[] result = client.invoke("example", new Object[]{"Hello World!"});

        System.out.println(result[0]);

    }

}

  或将接口HelloWebService.java复制到工程中来,调用接口的方法。不止可以返回字符串,也可以是集合数组等。

import java.util.List;



import org.codehaus.xfire.client.Client;

import org.codehaus.xfire.client.XFireProxyFactory;

import org.codehaus.xfire.service.Service;

import org.codehaus.xfire.service.binding.ObjectServiceFactory;

import org.codehaus.xfire.transport.http.CommonsHttpMessageSender;



public class HelloWSClient {

    public static void main(String[] args) throws Exception{

        String serviceURL = "http://localhost:8080/WebServiceServer/services/HelloWebService";

        Service serviceModel = new ObjectServiceFactory().create(HelloWebService.class,null,"http://localhost:8080/WebServiceServer/services/HelloWebService?wsdl",null);

        

        XFireProxyFactory serviceFactory = new XFireProxyFactory();

        

        HelloWebService service = (HelloWebService) serviceFactory.create(serviceModel, serviceURL);

        Client client = Client.getInstance(service);

        // disable timeout

        client.setProperty(CommonsHttpMessageSender.HTTP_TIMEOUT, "0");

        

        List<String> list = service.getList();

        for (String string : list) {

            System.out.println(string);

        }

    }

}

  客户端工程结构如图:

使用XFire组件开发WebService实例

  运行客户端代码,输出:这是服务端返回:Hello World!

  调用WebService成功!

 

你可能感兴趣的:(webservice)