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