用Xfire发布Webservice应用(转载)

开发的IDE我用的是Eclipse3.2,下面简单说一说用Xfire发布一个Webservice的步骤：
(1)获取Xfrie的发布包，可以到http://xfire.codehaus.org/ 去下载最新的发布包，目前最新的版本是1.2.4,获取到发布包后解压待用（文件名为xfire-distribution-1.2.4.zip，大概18M大小）
(2)打开Eclipse,新建一个Web项目，名称为：TestWeb,这个主要是为了测试Webservice服务端功能新建的，再新建一个项目叫TestConsole,这里面是业务逻辑，如下图所示：

(3)我们需要在TestConsole里面构建自己业务逻辑。这里我写了4个类，一个类是接口文件BusinessInterface.java，作为发布给客户端的业务方法接口，一个是具体的实现类BusinessObject.java，这个类是不用发布到客户端的，两外两个类一个是入口参数类TestVO.java，一个是出口参数类ReturnVO.java，设置这两个类的目的是为了模拟最一般的情形，代码分别如下：
BusinessInterface.java：

package com.zhiyuansoft.test;
/**
* 定义了一个业务方法
*/
public interface BusinessInterface {
    public ReturnVO getTestString(TestVO vo);
}
在这个接口里面定义了一个需要用Webservice进行调用的业务方法

BusinessObject.java：
package com.zhiyuansoft.test;

/**
* @author king
*
*/
public class BusinessObject implements BusinessInterface {
    public ReturnVO getTestString(TestVO vo) {
        System.out.println("in Webservice invoke!!!!");
        ReturnVO revo=new ReturnVO();
        revo.setDescStr("the "+vo.getName()+"'s age is "+vo.getAge());
        return revo;
    }
   
    public BusinessObject(){
       
    }

}
这个类是具体的业务实现类，对业务方法的具体实现放在里面，我们模拟的业务逻辑很简单，就是构建一个返回类并返回。
下面是两个参数类：
TestVO.java
package com.zhiyuansoft.test;

import java.io.Serializable;

public class TestVO implements Serializable {
    private static final long serialVersionUID = 1L;
   
    private String name;
    private int age;
   
    public int getAge() {
        return age;
    }
   
    public void setAge(int age) {
        this.age = age;
    }
   
    public String getName() {
        return name;
    }
   
    public void setName(String name) {
        this.name = name;
    }
}

ReturnVO.java
package com.zhiyuansoft.test;
import java.io.Serializable;

public class ReturnVO implements Serializable {
    private String descStr;

    public String getDescStr() {
        return descStr;
    }

    public void setDescStr(String descStr) {
        this.descStr = descStr;
    }
}
(4) 业务逻辑写好以后，就可以对Xfire进行配置了，要使用Xfrie发布Webservice项目，先要把Xfire加载到系统中来，具体的定义在Web项目的web.xml中，其片段如下：
    <servlet>
        <servlet-name>XFireServlet</servlet-name>       
        <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>XFireServlet</servlet-name>
        <url-pattern>/servlet/XFireServlet/*</url-pattern>
    </servlet-mapping>
    <servlet-mapping>
        <servlet-name>XFireServlet</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>
即Xfire的Servlet匹配形如/services/XXXX的地址 或者形如/servlet/XFireServlet/XXX的地址。
Xfire自身的配置文件放在Web项目的META-INF目录下面,目录结构如下图所示/WebRoot/META-INF/xfire/service.xml,可以看到Xfire的配置文件名为services.xml：

该文件的具体内容如下：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xfire.codehaus.org/config/1.0">
<service>
    <name>Business</name>
    <namespace>mytest</namespace>
    <serviceClass>com.zhiyuansoft.test.BusinessInterface</serviceClass>
    <implementationClass>com.zhiyuansoft.test.BusinessObject</implementationClass>
</service>
</beans>
其中serviceClass为对外的业务接口类，如果不是接口的话就直接写业务类，如果是接口的话下面还需要指明实现类，即implementationClass。
到此为止，服务器端的功能就完成了，验证无误后我们可以把这个项目发布到服务器上，我用的中间件是Jboss4.0。服务器端的功能发布完成后，接下来就要写一个客户端来调用服务器端发布的这个Webservice。
（5）新建一个工作区，建好后同样新建一个Web项目，名为ClientWeb，这个项目只是用来调用一个Webservice服务之用。将Xfire的库文件拷贝到Web项目的WEB-INF下面，同时需要将服务器端发布的服务打包发布给客户端，发布给客户端的代码只需要打包接口和参数类即可，实现类不必打包到客户端，类似于EJB的分发。
(6)在这个Web项目里面新建一个Servlet作为测试的Servlet,我这里叫做ClientServlet.java，在web.xml里面配置好这个Servlet后，就可以在Servlet里面写Webservice调用的代码了。客户端的web.xml如下所示：
========================
<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4"
    xmlns="http://java.sun.com/xml/ns/j2ee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
    http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<servlet>
    <description>This is the description of my J2EE component</description>
    <display-name>This is the display name of my J2EE component</display-name>
    <servlet-name>ClientServlet</servlet-name>
    <servlet-class>com.zhiyuansoft.servlet.ClientServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>ClientServlet</servlet-name>
    <url-pattern>/servlet/ClientServlet</url-pattern>
</servlet-mapping>
</web-app>
==========================
我们在这个Servlet里面增加一个方法如下（这个方法就是客户端调用服务器端Webservice的核心方法）
    public ReturnVO callWebService()
        throws MalformedURLException, Exception {   
        Service serviceModel = new ObjectServiceFactory().create(BusinessInterface.class);      
        XFire xfire = XFireFactory.newInstance().getXFire();
        XFireProxyFactory factory = new XFireProxyFactory(xfire);    
        String serviceUrl = "http://localhost:8080/TestWeb/services/Business";
        BusinessInterface client = null;
        try {
            client = (BusinessInterface) factory.create(serviceModel, serviceUrl);
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }        
        //调用服务
        ReturnVO serviceResponse = null;
        try {
            int age=30;
            TestVO tvo=new TestVO();
            tvo.setName("test-name");
            tvo.setAge(age);
            serviceResponse = client.getTestString(tvo);
       } catch (Exception e){
            e.printStackTrace();
        }      
        return serviceResponse;
    }

这个方法我们通过在Servlet的doGet方法里调用来实现最终对Webservice的调用，代码如下：
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException{
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out.println("<!DOCTYPE HTML PUBLIC /"-//W3C//DTD HTML 4.01 Transitional//EN/">");
        out.println("<HTML>");
        out.println(" <HEAD><TITLE>A Servlet</TITLE></HEAD>");
        out.println(" <BODY>");
        out.print("    the result of Call Webservice is ");
        try{
            out.print(callWebService().getDescStr());
        }catch(Exception e){
            e.printStackTrace();
        }
        out.println(", using the GET method");
        out.println(" </BODY>");
        out.println("</HTML>");
        out.flush();
        out.close();
    }
整个Servlet的代码如下 ClientServlet.java:
package com.zhiyuansoft.servlet;

import java.io.IOException;
import java.io.PrintWriter;
import java.net.MalformedURLException;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

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.zhiyuansoft.test.BusinessInterface;
import com.zhiyuansoft.test.BusinessObject;
import com.zhiyuansoft.test.ReturnVO;
import com.zhiyuansoft.test.TestVO;

public class ClientServlet extends HttpServlet {

    /**
    * Constructor of the object.
    */
    public ClientServlet() {
        super();
    }

    /**
    * Destruction of the servlet. <br>
    */
    public void destroy() {
        super.destroy(); // Just puts "destroy" string in log
        // Put your code here
    }

    /**
    * The doDelete method of the servlet. <br>
    *
    * This method is called when a HTTP delete request is received.
    *
    * @param request the request send by the client to the server
    * @param response the response send by the server to the client
    * @throws ServletException if an error occurred
    * @throws IOException if an error occurred
    */
    public void doDelete(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {

        // Put your code here
    }

    /**
    * The doGet method of the servlet. <br>
    *
    * This method is called when a form has its tag value method equals to get.
    *
    * @param request the request send by the client to the server
    * @param response the response send by the server to the client
    * @throws IOException
    * @throws Exception
    */
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException{
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out.println("<!DOCTYPE HTML PUBLIC /"-//W3C//DTD HTML 4.01 Transitional//EN/">");
        out.println("<HTML>");
        out.println(" <HEAD><TITLE>A Servlet</TITLE></HEAD>");
        out.println(" <BODY>");
        out.print("    the result of Call Webservice is ");
        try{
            out.print(callWebService().getDescStr());
        }catch(Exception e){
            e.printStackTrace();
        }
        out.println(", using the GET method");
        out.println(" </BODY>");
        out.println("</HTML>");
        out.flush();
        out.close();
    }

    /**
    * The doPost method of the servlet. <br>
    *
    * This method is called when a form has its tag value method equals to post.
    *
    * @param request the request send by the client to the server
    * @param response the response send by the server to the client
    * @throws ServletException if an error occurred
    * @throws IOException if an error occurred
    */
    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out
                .println("<!DOCTYPE HTML PUBLIC /"-//W3C//DTD HTML 4.01 Transitional//EN/">");
        out.println("<HTML>");
        out.println(" <HEAD><TITLE>A Servlet</TITLE></HEAD>");
        out.println(" <BODY>");
        out.print("    This is ");
        out.print(this.getClass());
        out.println(", using the POST method");
        out.println(" </BODY>");
        out.println("</HTML>");
        out.flush();
        out.close();
    }

    /**
    * The doPut method of the servlet. <br>
    *
    * This method is called when a HTTP put request is received.
    *
    * @param request the request send by the client to the server
    * @param response the response send by the server to the client
    * @throws ServletException if an error occurred
    * @throws IOException if an error occurred
    */
    public void doPut(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        // Put your code here
    }

    /**
    * Returns information about the servlet, such as
    * author, version, and copyright.
    *
    * @return String information about this servlet
    */
    public String getServletInfo() {
        return "This is my default servlet created by Eclipse";
    }

    /**
    * Initialization of the servlet. <br>
    *
    * @throws ServletException if an error occure
    */
    public void init() throws ServletException {
        // Put your code here
    }

    /* Call the Web service
    *
    */
    public ReturnVO callWebService()
        throws MalformedURLException, Exception {   
        Service serviceModel = new ObjectServiceFactory().create(BusinessInterface.class);      
        XFire xfire = XFireFactory.newInstance().getXFire();
        XFireProxyFactory factory = new XFireProxyFactory(xfire);    
        String serviceUrl = "http://localhost:8080/TestWeb/services/Business";
        BusinessInterface client = null;
        try {
            client = (BusinessInterface) factory.create(serviceModel, serviceUrl);
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }        
        //Invoke the service
        ReturnVO serviceResponse = null;
        try {
            int age=30;
            TestVO tvo=new TestVO();
            tvo.setName("test-name");
            tvo.setAge(age);
            serviceResponse = client.getTestString(tvo);
       } catch (Exception e){
            e.printStackTrace();
        }      
        return serviceResponse;
    }
}
（7）同样将这个Web项目发布，然后在地址栏里面输入：
http://localhost:8080/ClientWeb/servlet/ClientServlet ,此时会调用客户端的Servlet，然后调用其doGet方法，如果正常的话，可以看到页面输出结果为：
the result of Call Webservice is the test-name's age is 30, using the GET method
在这里我们看到，服务器端正确的完成了我们的业务操作，即将入参里面的名字和年龄组装成一句话返回。俗话说，麻雀虽小，五脏俱全，这个例子虽然很简单，但是完整的展示了一个最简单的Xfrie发布一个Wevservice应用的过程。