xfire开发实例--HelloWorld篇

本文从最基础的HelloWorld用例开始，介绍如何利用xfire开发web service应用。以后就可以开发复杂的web service应用了。 

开发环境：eclipse3.2+tomcat5.5.9+xfire1.2.6

一：在eclipse中新建项目XFireProject

1、建立源文件夹src.main；新建HelloService.java文件，该java文件只声明了一个简单的sayHello(String name)方法，。java文件内容如下：

2、在src.main目录下新建META-INF/xfire/services.xml文件，该文件用于声明一个service。service.xml文件的内容如下：

3、将将编译后的HelloService.class文件和service.xml文件部署到tomcat中。文件的位置如下：

webapps\xfire\WEB-INF\classes\META-INF\xfire\services.xml;

webapps\xfire\WEB-INF\classes\com\liuxiang\xfire\HelloService.class;

4、启动tomcat;正确启动tomcat之后，在IE地址栏里输入：http://localhost:8080/xfire/services/ 将会出现如下的页面：该页面正常显示了刚才部署的HelloService。如下图：

如果能正确显示上图，说明刚才的部署成功了。如果不能正确显示，请参照我上一篇文章：xfire1.2.6配置篇。

单击[wsdl],将会出现http://localhost:8080/xfire/services/HelloService?wsdl，即生成的一个wsdl文件。

5、生成web service客户端调用文件

      xfire提供了两种生成客户端测试的方式，一种提供了ant脚本，另一种是提供了xfire的eclipse插件；本文介绍了使用ant脚本的方式生成客户端的方式。

    首先在项目XFireProject中增加一个build.xml文件。xfire提供了一个ant任务：

<taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="myclasspath" />

build.xml文件的内容如下：

执行ant脚本，将会生成客户端代码，共三个文件。会放在包com.liuxiang.xfire.client下面，文件分别是：

HelloServiceClient.java、HelloServiceImpl.java、HelloServicePortType.java

6、编写测试代码，通过调用5中生成的代码，编写TestClient.java文件。文件内容如下：

/** *//**
 * 
 */
package com.liuxiang.xfire;

import java.net.MalformedURLException;

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.liuxiang.xfire.client.HelloServiceClient;
import com.liuxiang.xfire.client.HelloServicePortType;

/** *//**
 * 通过XFire生成的客户端进行调用
 * 
 * TestClient.java
 * com.liuxiang.xfire
 * XFireProject
 * @author liuxiang mailto:juxtapose@163.com
 * 2007-9-9 下午06:54:36
 *
 */
public class TestClient ...{
    /** *//**
     * 客户端测试
     * 通过ant脚本生成的客户端进行调用
     * 
     * @param name    传入的参数，客户名字
     * @return    返回sayHello()的返回值
     */
    public static String testClient(String name)...{
        HelloServiceClient helloSC = new HelloServiceClient();
        HelloServicePortType helloSP = helloSC.getHelloServiceHttpPort();
        String result = helloSP.sayHello(name);
        return result;
    }

    /** *//**
     * @param args
     * @throws Exception 
     */
    public static void main(String[] args) throws Exception ...{
        System.out.println(testClient("Liuxiang"));
    }

}

运行该代码，在控制台会输入如下信息：

Liuxiang,你好！

表明，第一个web service用例已经运行成功了。以后，就可以开发需要的web service了。