1.框架背景?
??? J2EE是跨平臺的,而WebServices的核心XML也是跨平臺的,,因此兩者結(jié)合更能發(fā)揮它們各自的功效,。關(guān)于WebServices的概念、作用,、實現(xiàn)等,,本文不作詳細的介紹,,背景部分主要介紹一下在J2EE環(huán)境下實現(xiàn)WebServices框架所需要的環(huán)境。?
(1)Tomcat?
??? 本框架使用的Web服務(wù)器為Tomcat4.x,,具體下載地址:http://jakarta.apache.org,。遵循J2EE1.3規(guī)范,包括JSP1.2和Servlet2.3,。由于Axis是以Web應(yīng)用的形式發(fā)布的,,所以需要一個Web服務(wù)器。?
(2)Axis?
??? Axis框架來自 Apache 開放源代碼組織,,它是基于JAVA語言的最新的 SOAP 規(guī)范(SOAP 1.2)和 SOAP with Attachments 規(guī)范(來自 Apache Group )的開放源代碼實現(xiàn),。Axis的最新版本是1.1,可以從http://ws.apache.org/axis/index.html下載,。?
(3)JAXB?
??? JAXB是一個數(shù)據(jù)綁定工具,,相關(guān)資料和下載可以到j(luò)ava.sun.com/webservices/,JAXB主要可以實現(xiàn):把 XML 數(shù)據(jù)轉(zhuǎn)化成 Java 類(或者多個類),;把 Java 數(shù)據(jù)轉(zhuǎn)化成 XML 文檔,。使用 JAXB 時需要一個 XML Schema 以生成類和數(shù)據(jù)結(jié)構(gòu)。?
2.框架目標(biāo)?
??? 本框架主要目的是使開發(fā)WebServices應(yīng)用變得簡單,、高效,,使WebServices應(yīng)用易于擴展和維護。具體來講,,包括以下幾方面:?
(1)提供給用戶的WebServices接口簡單,,提供單點入口,這樣用戶不需要記住很多繁瑣的方法,。?
(2)WebServices的服務(wù)端和客戶端的數(shù)據(jù)全部通過XML交互,,目前很多行業(yè)都形成了XML規(guī)范,例如旅游電子商務(wù),,如果嚴(yán)格按照XML規(guī)范,,可以達到各個系統(tǒng)之間的整合。?
(3)WebService的調(diào)用通過XML事件實現(xiàn),。一個XML文檔就是一個WebServices事件,,激發(fā)一個系統(tǒng)后臺的調(diào)用。?
(4)維護WebServices方便,,例如方便的添加,、修改、刪除一個WebServices提供的功能,。?
(5)方便測試WebServices提供的功能,,可以在脫離WebServices的環(huán)境下測試。?
3.框架實現(xiàn)原理?
??? 一個WebServices訪問大致流程為:首先互聯(lián)網(wǎng)用戶向WebServices客戶端服務(wù)器發(fā)出某請求,然后客戶端服務(wù)器發(fā)送一個XML事件到WebServices服務(wù)器,,WebServices服務(wù)器解析XML事件,,調(diào)用相應(yīng)的后臺業(yè)務(wù)邏輯,并將結(jié)果以XML的形式返回給客戶端,。本框架是用于基于Servlet的WebServices,,主要任務(wù)就是解析XML事件,調(diào)用相應(yīng)的業(yè)務(wù)邏輯,,然后將結(jié)果以XML的格式反饋給客戶方,,其中還包括了錯誤處理。具體的流程圖如下:
①??WebServices客戶端首先根據(jù)用戶的請求封裝XML,,然后發(fā)送到WebServices服務(wù)器端,。其中的XML文檔必須符合WebServices服務(wù)器端定義的Schema,一個不同的XML文檔對應(yīng)一個不同的請求,。其中XML最好能遵循行業(yè)規(guī)范,,例如旅游電子商務(wù)XML規(guī)范,有利于和其他系統(tǒng)交互,。
②??WebServices服務(wù)器端的Servlet服務(wù)程序為WebServicesEngine,,提供唯一的訪問入口doService(),所有的客戶端都是訪問WebServicesEngine的doService()方法,。當(dāng)服務(wù)器端接收到一個XML事件請求,,首先解析這個XML(可以通過JAXB或者castor),然后調(diào)用相應(yīng)的系統(tǒng)Action,,Action的主要任務(wù)為獲取XML中的數(shù)據(jù),。
③??Action將XML數(shù)據(jù)封裝成系統(tǒng)的Model,然后調(diào)用WebServices的業(yè)務(wù)代理層,。
④??WebServices的業(yè)務(wù)代理層調(diào)用后臺應(yīng)用服務(wù)器的EJB,。
⑤??后臺執(zhí)行完后,將結(jié)果返回給WebServices的業(yè)務(wù)代理層,。
⑥??WebServices的業(yè)務(wù)代理層將結(jié)果返回給Action,。
⑦??Action再將具體的結(jié)果封裝成XML返回給WebServicesEngine。
⑧??最后WebServicesEngine將XML返回到WebServices客戶端,。
??? 具體的XML請求和Action的對應(yīng)關(guān)系在一個request.xml中定義,,對于客戶端來說,一個XML文檔就是一個功能請求,,對于WebServices開發(fā)者來說,一個Action就是一個提供給外界的功能,,兩者的關(guān)系由request.xml決定,。其中這個request.xml具體由WebServicesEngine解析。
4.框架具體實現(xiàn)?
(1)? 將XML Schema轉(zhuǎn)化為java程序。
??? 首先需要安裝jaxb,,然后執(zhí)行命令:xjc.bat -p com.webservice.jaxbmodel WebService.xsd -d src,,即可在src目錄下生成java程序,然后編譯,。
(2)? 解析XML請求,,然后選擇相應(yīng)的Action執(zhí)行請求
??? 首先定義request.xml文件,格式如下:
??????
???????
其中CreateOrderRequest是由JAXB從XML Schema生成出來的類,,當(dāng)XML請求到達,,首先通過JAXB把XML文檔unmarshal成java對象,,例如CreateOrderRequest,,然后通過反射機制查找到類CreateOrderAction,,然后實例化,,然后執(zhí)行Action的execute方法調(diào)用后臺具體的業(yè)務(wù)邏輯,。為了提高效率,,可以把Action設(shè)置成單例,,類似于Struts(jakarta.apache.org)的Action,,其中Action只做流程控制,。
(3)? 錯誤處理
??? 考慮到WeServices客戶端的多樣性,,例如.NET、VB,、Delphi等,,有些語言并沒提供類似于java的例外(Exception)處理,因此本框架并未使用例外機制,,而用一個專用的XML文檔表示錯誤信息,,其中有一個ErrorCode來表示具體的錯誤信息。格式如下:
???????
??? 如果返回給客戶端的XML為錯誤文檔,,則可以根據(jù)ErrorCode查詢到具體的錯誤信息,。具體ErrorCode的錯誤信息由WebServices提供者提供。
(4)? 返回XML結(jié)果
??? WebServices客戶端接收到XML文檔后,,需要首先解析此XML是否為錯誤XML文檔,,如果是,則將錯誤的信息顯示給用戶,,否則,,解析XML文檔,將XML數(shù)據(jù)反饋給最終用戶,。
5.框架展望和小結(jié)?
??? 本框架的主要目的就是加快用戶開發(fā)WebServices的速度,,如果對已有系統(tǒng)開發(fā)WebServices,則只需要首先制定一些XML規(guī)范(Schema),,然后編寫相應(yīng)的Action,,Action去調(diào)用現(xiàn)有的業(yè)務(wù)邏輯,,而不用去關(guān)心WebServices的具體細節(jié),如此一來,,可以大大的提高效率,。
??? 當(dāng)然,此框架還有很多未考慮的因素,,例如WebServices安全等,,因此有待進一步改善。
參考資料:
1.http://java.sun.com/webservices/
2.http://ws.apache.org/axis/index.html
3.IBM developerWorks中文網(wǎng)站