xfire

xfire

XFire是新一代的Java Web服務引擎,XFire使得在JavaEE套用中發布Web服務變得輕而易舉。和其他Web服務引擎相比,XFire的配置非常簡單,可以非常容易地和Spring集成,它使得Java開發人員終於可以獲得和.Net開發人員一樣的開發效率。

概述

xfire xfire

XFire是codeHaus組織提供的一個開源框架,它構建了POJO和SOA之間的橋樑,主要特性就是支持將POJO通過非常簡單的方式發布成Web服務,這種處理方式不僅充分發揮了POJO的作用,簡化了Java套用轉化為Web服務的步驟和過程,也直接降低了SOA的實現難度,為企業轉向SOA架構提供了一種簡單可行的方式。

特性包括

支持

•支持將Web服務綁定到POJO、XMLBeans、JAXB1.1、JAXB2.0和Castor;

•支持基於HTTP、JMS、XMPP等多種協定訪問Web服務;

•支持多種Web服務業界重要標準如SOAP、WSDL、Web服務定址(WS-Addressing)、Web服務安全(WS-Security)等;

•支持JSR181,可以通過JDK5配置Web服務;

•高性能的SOAP實現;

•伺服器端、客戶端代碼輔助生成;

•對Spring、Pico、Plexus等項目的支持等。

目錄

•XFire安裝包:

•XFire框架支撐環境:

•XFire套用配置:

參考資料

XFire在2007年後已停止更新。正式更名為Apache CXF,亦可以說是XFire2.0。

XFire - XFire安裝包:XFire框架目前最後的一個版本是1.2.6,在2007年5月3日發布,可以訪問下載XFire框架的安裝包,下載時請選擇“全部二進制發布包(BinaryDistributioninZipPackage)”,而不僅僅是“XFire Jar檔案(Jar of all XFire modules)”。

下載完成後,我們可以將下載的.zip檔案解壓縮到任意的資料夾中(後面的章節中使用%XFIRE_HOME%表示XFire框架的安裝目錄),

解壓縮後

api目錄

xfire目錄結構 xfire目錄結構

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發布時的一些有用的信息。

Servlet

概述

XFire - XFire框架支撐環境:XFire框架是一種基於Servlet技術的SOA套用開發框架,要正常運行基於XFire套用框架開發的企業套用,除了XFire框架本身之外,還需要JDK和Servlet容器的支持。

JDK版本

XFire支持非常多的特性,其中不同的特性對JDK版本的要求有所不同,比如如果項目中選擇基於JSR181標準發布Web服務,我們就需要選擇JDK5或者以上版本,如果僅僅選擇將Web服務綁定到最簡單的POJO,我們只需要選擇JDK1.4版本即可。

JDK各版本均可以在java.sun.com網站上下載,如何安裝JDK請參考SUN公司的相關技術文檔和JDK的幫助文檔。

Servlet

XFire是一種基於Servlet技術的SOA套用開發框架,需要Servlet容器的支持。XFire支持在多種Servlet容器中運行,包括Websphere、Weblogic、TOMCAT等。為了說明的簡單,我們選擇使用TOMCAT(版本5.0.30)作為XFire的運行容器,所有配置過程和發布步驟的說明也均是針對TOMCAT,如果讀者使用TOMCAT之外的其它Servlet容器或者選擇了TOMCAT的其它版本.

TOMCAT各版本均可以在tomcat.apache.org網站上下載,如何正確安裝TOMCAT伺服器請參考TOMCAT伺服器的幫助文檔。

xalan

XFire需要xalan項目的支持,然而1.2.6版本中並沒有帶有相應的jar檔案,因此請訪問xml.apache.org,下載xalan項目的二進制包。

XFire

概述

XFire - XFire套用配置:前面的章節中我們下載和安裝了XFire安裝包和所需要的支持環境,我們開始學習如何從零開始創建XFire套用開發環境。下面的所有配置過程和發布步驟均針對TOMCAT(版本5.0.30)伺服器,如果選擇其它的Servlet容器,下面的配置過程和步驟可能需要做出調整,請讀者根據實際Servlet容器的幫助文檔進行相應調整。

目錄

在%TOMCAT_HOME%/webapps目錄下創建新的Web套用目錄“XFire”

[注]其中的%TOMCAT_HOME%指向TOMCAT的安裝目錄。

在”XFire”目錄下創建”WEB-INF”目錄、

在”WEB-INF”目錄下創建”lib”目錄和”classes”目錄

在”WEB-INF”目錄下創建Web套用描述檔案”web.xml”,”web.xml”檔案的內容見清單1-1。

清單1-1WEB-INF\web.xml (servlet已定義)

<?xml version="1.0" encoding="ISO-8859-1"?>

<!-- START SNIPPET: webxml -->

<!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>

<!-- END SNIPPET: webxml -->

檔案

拷貝%XFIRE_HOME%/lib目錄下所有檔案到“1、創建Web套用目錄和基本元素”中所創建的”lib”目錄下,將%XFIRE_HOME%/XFire-all-1.2.6.jar檔案也拷貝到“1、創建Web套用目錄和基本元素”中所創建的”lib”目錄下。將xalan安裝包中的所有jar檔案和所需要的支持jar檔案拷貝到相同的”lib”目錄下。

[注]為了減少拷貝的jar檔案的數目,開發者可以根據項目的需要選擇需要拷貝的jar檔案,而不是全部拷貝,如何根據需要選擇拷貝合適的類包檔案請訪問XFire站點。

Servlet

修改web.xml檔案,在其中增加如下Servlet定義內容。

發布檔案

4、創建XFire框架的服務發布檔案services.xml;

在“1、創建Web套用目錄和基本元素”中創建的classes目錄下新建目錄”META-INF\xfire”;

在步驟a)中新建的”xfire”檔案目錄下創建新檔案services.xml,檔案的默認內容如清單1-2。

清單1-2WEB-INF\classes\META-INF\xfire\services.xml

編輯本段 回目錄 XFire - 參考資料:訪問XFire框架用戶指南可以獲得更多關於XFi

Eclipse中配置xfire Eclipse中配置xfire

re的使用幫助。

訪問XFire的Eclipse外掛程式可以獲得關於XFire提供的Eclipse外掛程式的更多信息。

Web服務

XFire 框架中,我們有兩種方式將 POJO 發布成 Web 服務:

一種方式是直接使用 Web 服務接口和 Web 服務實現類(POJO)來發布; 另一種方式是基於 JSR181 標準和注釋技術將被注釋的 POJO 發布成 Web 服務; 下面的章節中我們將學習使用第一種方式來完成 POJO 的 Web 服務發布。我們將使用經典的 ”Hello World!”例子來演示將 POJO 發布成 Web 服務所需要的步驟,不過我們不再是簡單的訪問一個 Java 方法來輸出 ”Hello World!”字元串,而是轉為在 SOA 環境下實現:Web 服務客戶端通過訪問伺服器端發布成 Web 服務的 POJO 獲得返回的 ”Hello World!”字元串後輸出到客戶端的控制台上。

將 POJO 發布成 Web 服務的基本步驟如下:

創建 Web 服務接口,聲明該 Web 服務對外暴露的接口; 創建 Web 服務實現類,為 Web 服務接口提供實現; 修改 XFire 框架的服務發布檔案 ---- services.xml,將 POJO 發布成 Web 服務。

相關詞條

相關搜尋

熱門詞條

聯絡我們