Web Service實踐之——開始XFire

一、Axis與XFire的比較

XFire是與Axis2 並列的新一代WebService平臺。之所以並稱為新一代，因為它：

1、支援一系列Web Service的新標準--JSR181、WSDL2.0 、JAXB2、WS-Security等；

2、使用Stax解釋XML,效能有了質的提高。XFire採用Woodstox 作Stax實現；

3、容易上手，可以方便快速地從pojo釋出服務； 

4、Spring的結合；

5、靈活的Binding機制，包括預設的Acegis,xmlbeans,jaxb2,castor。

XFire與Axis1效能的比較

1、XFire比Axis1.3快2-6倍

2、XFire的響應時間是Axis1.3的1/2到1/5

XFire與Axis2的比較

雖然XFire與Axis2都是新一代的WebService平臺，但是Axis2的開發者太急於推出1.0版本，所以1.0還不是一個穩定的版本，它的開發者宣稱1.1版本即將推出，希望1.1版本會是個穩定的版本。在XFire捐獻給apache後有人認為Axis2將會滅亡。其實在很多人眼裡，Axis2並不是pojo形式，現在也好象XFire比Axis更有市場，也有很多人開始從Axis轉向XFire。

據說，XFire確實比Axis2簡單很多 

AXIS VS CXF

在SOA

這兩個框架 都是從已有的開源專案發展起來的。Axis2是從Axis1.x系列發展而來。CXF則是XFire和Celtix專案的結合產品。Axis2是從底層全部重新實現，使用了新的擴充套件性更好模組架構。 CXF也重新的深化了XFire和Celtix這兩個開發工具。

新產品的退出導致了幾個問題。是不是現有的使用Axis 1.x

對於系統遷移來說，也許遷移到新的框架並不難。Axis和CXF都提供了遷移的指導。能夠給開發者一些遷移的技巧和經驗。但是對於這樣遷移，這兩個開源專案都沒有提供遷移的工具。對於這樣的遷移工作，儘管很值得去尋找所有的可行方案。Axis2和CXF都有各自不同的WebService開發方法，每個方法都有相當數量擁護者。

通過一個比較矩陣來比較Axis2和CXF變得有現實的意義。這兩個專案都開發不夠成熟，但是最主要的區別在以下幾個方面：

1. CXF支援 WS-Addressing，WS-Policy， WS-RM， WS-Security和WS-I Basic Profile。Axis2不支援WS-Policy，但是承諾在下面的版本支援。

2. CXF可以很好支援Spring。Axis2不能

3. AXIS2支援更廣泛的資料並對，如XMLBeans，JiBX，JaxMe和JaxBRI和它自定義的資料繫結ADB。注意JaxME和JaxBRI都還是試驗性的。CXF只支援JAXB和Aegis。在CXF2.1

4. Axis2支援多語言-除了Java,他還支援C/C++版本。

比較這兩個框架的Web Service開發方法與比較它們的特性同樣重要。 從開發者的角度，兩個框架的特性相當的不同。 Axis2的開發方式類似一個小型的應用伺服器，Axis2的開發包要以WAR的形式部署到Servlet容器中，比如Tomcat，通過這些容器可以對工作中的Web Service進行很好的監控和管理。Axis2 的Web administrion模組可以讓我們動態的配置Axis2.一個新的服務可以上載，啟用，使之失效，修改web服務的引數。管理UI也可以管理一個或者多個處於執行狀態的服務。這種介面化管理方式的一個弊端是所有在執行時修改的引數沒有辦法儲存，因為在重啟動之後，你所做的修改就會全部失效。

Axis2允許自己作為獨立的應用來發布Web Service，並提供了大量的功能和一個很好的模型，這個模型可以通過它本身的架構（modular architecture）不斷新增新的功能。有些開發人員認為這種方式對於他們的需求太過於繁瑣。這些開發人員會更喜歡CXF。

CXF更注重開發人員的工效（ergonomics）和嵌入能力（embeddability）。大多數配置都可以API來完成，替代了比較繁瑣的XML配置檔案， Spring的整合性經常的被提及，CXF支援Spring2.0和CXF's API和Spring的配置檔案可以非常好的對應。CXF強調程式碼優先的設計方式（code-first design)，使用了簡單的API使得從現有的應用開發服務變得方便。

不過你選擇Axis2還是CXF，你都可以從開源社群得到大量的幫助。這兩個框架都有商業公司提供服務，WSO2提供AXIS2的支援，Iona提供CXF的支援。這兩公司都有很活躍的開發者社群。 Axis2出現的時間較早，CXF的追趕速度快。我的建議是：如果你需要多語言的支援，你應該選擇AXIS2。如果你需要把你的實現側重JAVA並希望和Spring整合，CXF就是更好的選擇，特別是把你的Web Service嵌入其他的程式中。如果你覺得這兩個框架的新特性對於你並沒有太大的用處，你會覺得Axis1也是不錯的選擇，你應該繼續使用它知道你有充分的理由去更換它。

二、開始XFire的示例程式碼編寫：

以下是對程式碼的解釋,可以把示例專案下載匯入MyEclipse中，匯入相應jar包直接執行。

1、配置XFire執行環境：

在Tomcat下新建一個Web Applications，命名為stove，然後在其WEB-INF目錄下新建一個web.xml檔案，檔案中輸入：

Xml程式碼 

<?xml version="1.0" encoding="GB2312">

<!DOCTYPE web-app

    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

    "http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>

  <servlet>

    <servlet-name>XFireServlet</servlet-name>

    <display-name>XFire Servlet</display-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>

</web-app>

其中主要就是引入了XFireServlet，用以處理Web Service請求，並且負責提供Web Service的WSDL，如果你釋出了一個名為BookService的WebService，則可以通過網址：

http://<伺服器>[:埠]/<webapp名>/services/BookService

來訪問這個WebService，並且通過地址：

http://<伺服器>[:埠]/<webapp名>/services/BookService?WSDL  來得到這個WebService的WSDL資訊。

2、開發最簡單的WebService

在WEB-INF目錄下新建src資料夾，然後再建一個package:

cn.com.pansky.webservice.xfire.study

，在這個包下面新建一個介面：

Java程式碼  

package cn.com.pansky.webservice.xfire.study;

public interface SayHiService{

  public String sayHi(String name);

}

這個介面是告訴伺服器你的WebService哪些方法可以被使用者呼叫的。下面我們再來寫一個SayHiService的實現類，以完成業務邏輯：

Java程式碼 

package cn.com.pansky.webservice.xfire.study;

public class SayHiServiceImpl implements SayHiService{

  public String sayHi(String name){

    if(name==null){

      return "連名字也不肯告訴我嗎？";

    }

    return name+", 你吃了嗎？沒吃回家吃去吧。";

  }

  public String 不告訴你(){

    return "我的名字不告訴你！";

  }

}

 這個類實現了sayHi方法，該方法是可以通過WebService呼叫訪問到的。另外還實現了一個方法“不告訴你”，該方法因為沒有在介面SayHiService中定義，所以不能被WebService呼叫到。

   這個例子足夠簡單吧，就跟我們剛學Java時寫的"Hello world"沒什麼兩樣。

到這裡為止，我們做的跟平時的Java開發沒啥區別，該如何來發布WebService呢？

3、把JAVA類釋出為WebService：

在WEB-INF/classes目錄下新建資料夾：META-INF/xfire，然後在該資料夾下新建一個XML檔案：services.xml，檔案內容如下：

Xml程式碼  

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

  <service>

    <name>SayHiService</name>

    <namespace>http://cn.com.pansky/SayHiService</namespace>

    <serviceClass>cn.com.pansky.webservice.xfire.study.SayHiService</serviceClass>

    <implementationClass>cn.com.pansky.webservice.xfire.study.SayHiServiceImpl</implementationClass>

  </service>

</beans>

 這個檔案定義一個WebService: SayHiService，並同時定義了介面和實現類。

好了，該建的檔案基本建完了，現在想辦法把src下的java檔案編譯成class，並複製到WEB-INF/classes目錄下

4、啟動Tomcat，測試WebService

如果Tomcat還沒配置好，抽兩分鐘再配一下。再把Tomcat啟動起來。

再開啟瀏覽器，輸入：

http://localhost/stove/services

，伺服器返回的結果如下：

Available Services:

    * SayHiService [wsdl]

     Generated by XFire ( http://xfire.codehaus.org/ ) 

我們看到我們的WebService已經佈署成功了，我們再看看它的WSDL資訊：

Xml程式碼 

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

<wsdl:definitions targetNamespace="http://cn.com.pansky/SayHiService" xmlns:tns="http://cn.com.pansky/SayHiService" xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" xmlns:soapenc12="http://www.w3.org/2003/05/soap-encoding" xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">

  <wsdl:types>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" attributeFormDefault="qualified" elementFormDefault="qualified" targetNamespace="http://cn.com.pansky/SayHiService">

<xsd:element name="sayHi">

<xsd:complexType>

<xsd:sequence>

<xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

<xsd:element name="sayHiResponse">

<xsd:complexType>

<xsd:sequence>

<xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string"/>

</xsd:sequence>

</xsd:complexType>

</xsd:element>

</xsd:schema>

  </wsdl:types>

  <wsdl:message name="sayHiRequest">

    <wsdl:part name="parameters" element="tns:sayHi">

    </wsdl:part>

  </wsdl:message>

  <wsdl:message name="sayHiResponse">

    <wsdl:part name="parameters" element="tns:sayHiResponse">

    </wsdl:part>

  </wsdl:message>

  <wsdl:portType name="SayHiServicePortType">

    <wsdl:operation name="sayHi">

      <wsdl:input name="sayHiRequest" message="tns:sayHiRequest">

    </wsdl:input>

      <wsdl:output name="sayHiResponse" message="tns:sayHiResponse">

    </wsdl:output>

    </wsdl:operation>

  </wsdl:portType>

  <wsdl:binding name="SayHiServiceHttpBinding" type="tns:SayHiServicePortType">

    <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>

    <wsdl:operation name="sayHi">

      <wsdlsoap:operation soapAction=""/>

      <wsdl:input name="sayHiRequest">

        <wsdlsoap:body use="literal"/>

      </wsdl:input>

      <wsdl:output name="sayHiResponse">

        <wsdlsoap:body use="literal"/>

      </wsdl:output>

    </wsdl:operation>

  </wsdl:binding>

  <wsdl:service name="SayHiService">

    <wsdl:port name="SayHiServiceHttpPort" binding="tns:SayHiServiceHttpBinding">

      <wsdlsoap:address location="http://localhost/stove/services/SayHiService"/>

    </wsdl:port>

  </wsdl:service>

</wsdl:definitions>

 這個檔案跟我們用Axis生成的基本是一樣的。

5、享受美味的時刻

WebService這道大餐算是烹製好了，現在是享用美餐的時候了。

我們寫一個客戶端吃掉這道大餐：

Java程式碼 

package cn.com.pansky.webservice.xfire.study;

import java.net.MalformedURLException;

import java.util.Map;

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 SayHiClient{

  public static void main(String args[]) {

    String serviceURL = "http://localhost/stove/services/SayHiService";

    Service serviceModel = new ObjectServiceFactory().create(SayHiService.class,null,"http://cn.com.pansky/SayHiService",null);

    XFireProxyFactory serviceFactory = new XFireProxyFactory();

    try{

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

      Client client = Client.getInstance(service);

      //client.addOutHandler(new OutHeaderHandler());

      // disable timeout

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

      String hello = service.sayHi("張山瘋");

      System.out.println("伺服器對[張山瘋] 的回答是：" + hello );

      hello = service.sayHi(null);

      System.out.println("伺服器胡言亂語說：" + hello );

    } catch (MalformedURLException e) {

      e.printStackTrace();

    }

  }

}

 編譯這個類，再執行一下，伺服器服務的結果是：

2008-5-22 17:39:17 org.apache.commons.httpclient.HttpMethodBase writeRequest

資訊: 100 (continue) read timeout. Resume sending the request

2008-5-22 17:39:17 org.apache.commons.httpclient.HttpMethodBase readResponse

資訊: Discarding unexpected response: HTTP/1.1 100 Continue

伺服器對[張山瘋] 的回答是：張山瘋, 你吃了嗎？沒吃回家吃去吧。

2008-5-22 17:39:20 org.apache.commons.httpclient.HttpMethodBase writeRequest

資訊: 100 (continue) read timeout. Resume sending the request

2008-5-22 17:39:20 org.apache.commons.httpclient.HttpMethodBase readResponse

資訊: Discarding unexpected response: HTTP/1.1 100 Continue

伺服器胡言亂語說：連名字也不肯告訴我嗎？

好了，WebService佈署成功。

到這就結束了，有問題給我留言吧！