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.框架目標?
??? 本框架主要目的是使開發(fā)WebServices應(yīng)用變得簡單、高效,使WebServices應(yīng)用易于擴展和維護。具體來講,包括以下幾方面:?
(1)提供給用戶的WebServices接口簡單,提供單點入口,這樣用戶不需要記住很多繁瑣的方法。?
(2)WebServices的服務(wù)端和客戶端的數(shù)據(jù)全部通過XML交互,目前很多行業(yè)都形成了XML規(guī)范,例如旅游電子商務(wù),如果嚴格按照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)站