本文發(fā)表于《開(kāi)源大本營(yíng)》
作者:錢安川
前言
本篇文章并沒(méi)有太多WebWork 的實(shí)戰(zhàn)代碼細(xì)節(jié)。本人非常希望能充當(dāng)一名導(dǎo)游的角色,帶領(lǐng)讀者逐步游覽WebWork的功能特性和原理。在第一章,我們將提出基于三層架構(gòu)的Web層需要解決的10個(gè)問(wèn)題,這是本文的縱軸。圍繞著縱軸,我們按照橫軸的順序逐步描述講解:WebWork簡(jiǎn)介、WebWork入門、WebWork原理、WebWork實(shí)戰(zhàn)和技巧、展望WebWork未來(lái)、最后是本文的總結(jié)。
基于三層架構(gòu)的 Web 層需要解決的問(wèn)題
我們這里討論的Web層,是基于典型的三層架構(gòu):Web層,業(yè)務(wù)層,數(shù)據(jù)層。故,我們將不討論任何涉及業(yè)務(wù)(業(yè)務(wù)邏輯)層和數(shù)據(jù)層功能的實(shí)現(xiàn)。
Web層需要解決的問(wèn)題:
1、 數(shù)據(jù)的輸入。如何獲得基于無(wú)狀態(tài)HTTP的請(qǐng)求數(shù)據(jù)?如何將請(qǐng)求的字符數(shù)據(jù)轉(zhuǎn)換為對(duì)應(yīng)的模型對(duì)象?
2、 輸入數(shù)據(jù)的驗(yàn)證。如何驗(yàn)證輸入數(shù)據(jù)的合法性并給出明確的錯(cuò)誤消息提示 ?
3、 數(shù)據(jù)的輸出。如何展現(xiàn)復(fù)雜的對(duì)象結(jié)構(gòu)?如何處理復(fù)雜的展現(xiàn)邏輯?
4、 數(shù)據(jù)的傳遞和共享。如何在不同的請(qǐng)求或頁(yè)面之間傳遞和共享數(shù)據(jù)?
5、 頁(yè)面的流程管理。如何管理Web應(yīng)用中的頁(yè)面流程?
6、 模塊化的管理。如何將復(fù)雜的Web應(yīng)用以模塊化的方式管理?
7、 靈活可擴(kuò)展的架構(gòu)。如何支持各種不同的展現(xiàn)層技術(shù)?如何與業(yè)務(wù)層或數(shù)據(jù)層的各種框架整合?
8、 安全和訪問(wèn)控制的管理。如何提供基于Web的安全機(jī)制和資源訪問(wèn)控制的管理?
9、 代碼實(shí)現(xiàn)的簡(jiǎn)潔和高效。如何讓開(kāi)發(fā)步驟和代碼維護(hù)變得簡(jiǎn)單?如何盡量減少開(kāi)發(fā)的中間環(huán)節(jié)?如何將公共的功能剝離出來(lái),并可以靈活的組裝應(yīng)用?
10、 其它問(wèn)題。異步調(diào)用、國(guó)際化支持、文件上傳、防止重復(fù)提交等等。
下面,讓我們來(lái)一起看看WebWork是如何解決上面的這些問(wèn)題。
WebWork 簡(jiǎn)介
WebWork是由OpenSymphony組織開(kāi)發(fā)的,致力于組件化和代碼重用的J2EE Web框架。WebWork目前最新版本是2.2.2,現(xiàn)在的WebWork2.x前身是Rickard Oberg開(kāi)發(fā)的WebWork,但現(xiàn)在WebWork已經(jīng)被拆分成了Xwork1和WebWork2兩個(gè)項(xiàng)目,如下示意圖所示:
work簡(jiǎn)潔、靈活功能強(qiáng)大,它是一個(gè)標(biāo)準(zhǔn)的Command模式框架實(shí)現(xiàn),并且完全從web層脫離出來(lái)。Xwork提供了很多核心功能:前端攔截機(jī)(interceptor),運(yùn)行時(shí)表單屬性驗(yàn)證,類型轉(zhuǎn)換,強(qiáng)大的表達(dá)式語(yǔ)言(OGNL – the Object Graph Notation Language),IoC(Inversion of Control依賴倒轉(zhuǎn)控制)容器等。
WebWork2建立在Xwork之上,處理HTTP的請(qǐng)求和響應(yīng)。所有的請(qǐng)求都會(huì)被它的前端控制器(ServletDispatcher,最新版本是FilterDispatcher)截獲。前端控制器對(duì)請(qǐng)求的數(shù)據(jù)進(jìn)行包裝,初始化上下文數(shù)據(jù),根據(jù)配置文件查找請(qǐng)求URL對(duì)應(yīng)的Action類,執(zhí)行Action,將執(zhí)行結(jié)果轉(zhuǎn)發(fā)到相應(yīng)的展現(xiàn)頁(yè)面。WebWork2支持多視圖表示,視圖部分可以使用JSP, Velocity, FreeMarker, JasperReports,XML等。
下面我們提到的WebWork將為WebWork2,使用的版本是WebWork2.2.2。
WebWork 入門
WebWork 安裝
如果只是搭建一個(gè)WebWork開(kāi)發(fā)環(huán)境,那將非常簡(jiǎn)單:
1、 去網(wǎng)站http://www.opensymphony.com/webwork下載最新的WebWork2.2.2項(xiàng)目。
2、 搭建一個(gè)Web應(yīng)用(這個(gè)不難吧);并拷貝WebWork框架運(yùn)行需要的所有Jar文件到Web應(yīng)用的WEB-INF\lib中。這些Jar文件,可以在WebWork項(xiàng)目中lib\default目錄找到,即那個(gè)目錄里面的所有文件。當(dāng)然,別忘記今天的“主角”,在WebWork跟目錄下的webwork-2.2.2.jar文件。
3、 在Web.xml文件中配置WebWork的前端控制器FilterDispatcher,也就是一個(gè)普通的Servlet Filter(過(guò)濾器)而已。代碼如下:
< filter >
< filter-name > webwork </ filter-name >
< filter-class > com.opensymphony.webwork.dispatcher.FilterDispatcher </ filter-class >
</ filter >
< filter-mapping >
< filter-name > webwork </ filter-name >
< url-pattern > /* </ url-pattern >
</ filter-mapping >
不過(guò)如果是在實(shí)際項(xiàng)目中使用,安裝過(guò)程中還是有一些問(wèn)題需要注意的:
1、 關(guān)于前端控制器。在以前WebWork2版本里面,前端控制器是ServeltDispatcher,它是一個(gè)JavaServlet。而現(xiàn)在是一個(gè)Filter(過(guò)濾器),會(huì)導(dǎo)致無(wú)法在頁(yè)面中使用Jsp的include來(lái)包含一個(gè)WebWork的Action請(qǐng)求的URL。如果真的需要這樣做,可以使用WebWork的action標(biāo)簽庫(kù)。
2、 關(guān)于Action請(qǐng)求URL的后綴。我們知道,在一般的Web框架中,前端控制器會(huì)將特定后綴的請(qǐng)求URL映射到對(duì)應(yīng)的Action請(qǐng)求中。而我們這里的前端控制器會(huì)接受任意的請(qǐng)求,但它默認(rèn)是將.action結(jié)尾的URL映射為WebWork的Action請(qǐng)求。我們可以在webwork.properties文件中,設(shè)置我們自己的后綴名,多個(gè)后綴名可以用逗號(hào)隔開(kāi)。例如:webwork.action.extension=action,do
3、 在 Jsp 頁(yè)面中, WebWork 的標(biāo)簽庫(kù)不需要在 web.xml 中定義,在頁(yè)面中通過(guò)如下的代碼直接引用: <%@ taglib prefix = "ww" uri = "/webwork" %>
4、 在Jsp頁(yè)面中,默認(rèn)“altSyntax”是開(kāi)啟的。它是用來(lái)解決標(biāo)簽庫(kù)中的字符串和表達(dá)式語(yǔ)言混淆的問(wèn)題。所以,作為變量的表達(dá)式語(yǔ)言應(yīng)該放在%{}中,否則WebWork會(huì)把它當(dāng)作字符串處理。
5、 如果展現(xiàn)層技術(shù)使用Freemarker(WebWork官方的推薦,也是我個(gè)人的推薦),如果在頁(yè)面中需要使用標(biāo)簽庫(kù),必須在web.xml中配置JspSupportServlet,代碼如下:
< servlet >
< servlet-name > JspSupportServlet </ servlet-name >
< servlet-class > com.opensymphony.webwork.views.JspSupportServlet </ servlet-class >
< load-on-startup > 1 </ load-on-startup >
</ servlet >
6、 還有一些其它的定制,比如:編碼,標(biāo)簽的模板文件等等,都可以在webwork.properties文件中配置。如果在ClassPath中沒(méi)有這個(gè)文件,WebWork會(huì)自動(dòng)讀取WebWork的Jar包里面的default.properties文件。
WebWork 核心概念
WebWork的三個(gè)關(guān)鍵部分
1、 Actions。一般一個(gè)Action代表一次請(qǐng)求或調(diào)用。在WebWork中,一般Action類需要實(shí)現(xiàn)Action接口,或者直接繼承基礎(chǔ)類ActionSupport。這是,它要實(shí)現(xiàn)默認(rèn)的execute方法,并返回一個(gè)在配置文件中定義的Result(也就是一個(gè)自定義的字符串而已)。當(dāng)然,Action也可以只是一個(gè)POJO(普通Java對(duì)象),不用繼承任何類也不用實(shí)現(xiàn)任何接口。Action是一次請(qǐng)求的控制器,同時(shí)也充當(dāng)數(shù)據(jù)模型的角色,我們強(qiáng)烈建議不要將業(yè)務(wù)邏輯放在Action中。
2、 Results。它是一個(gè)結(jié)果頁(yè)面的定義。它用來(lái)指示Action執(zhí)行之后,如何顯示執(zhí)行的結(jié)果。Result Type表示如何以及用哪種視圖技術(shù)展現(xiàn)結(jié)果。通過(guò)Result Type,WebWork可以方便的支持多種視圖技術(shù);而且這些視圖技術(shù)可以互相切換,Action部分不需做任何改動(dòng)。
3、 Interceptors。WebWork的攔截器,WebWork截獲Action請(qǐng)求,在Action執(zhí)行之前或之后調(diào)用攔截器方法。這樣,可以用插拔的方式將功能注入到Action中。WebWork框架的很多功能都是以攔截器的形式提供出來(lái)。例如:參數(shù)組裝,驗(yàn)證,國(guó)際化,文件上傳等等。
第一個(gè)例子: Welcome
入門,我們從簡(jiǎn)單的Welcome開(kāi)始吧!需求如下:一個(gè)頁(yè)面,有一個(gè)用戶名輸入框;輸入自己的名字,例如Moxie,提交按鈕返回一個(gè)歡迎的頁(yè)面,并顯示前面輸入的用戶名和一句歡迎信息,例如:Moxie, Welcome!頁(yè)面操作流程圖如下:
開(kāi)發(fā)步驟如下:
1、 輸入頁(yè)面。Welcome.jsp是一個(gè)非常簡(jiǎn)單輸入頁(yè)面,代碼如下:
< form name = "register" action = "welcome.action" method = "POST" >
Name: < input name = "username" > Please input your name.
</ form >
2、 WebWork的Action類。它實(shí)現(xiàn)了Action接口,獲得welcome.jsp頁(yè)面?zhèn)魅氲臄?shù)據(jù)即輸入的用戶名,根據(jù)這個(gè)用戶名生成了一條歡迎信息,并在結(jié)果頁(yè)面中打印出來(lái)。WelcomeAction.java代碼如下:
public class WelcomeAction implements Action{
private String username;
private String welcomeMessage;
public String execute() throws Exception {
welcomeMessage = username +",Welcome!";
return SUCCESS;
}
public void setUsername(String username) {
this.username = username;
}
public String getWelcomeMessage() {
return welcomeMessage;
}
}
看了上面的代碼,也許你都不敢相信這就是 Web 編程。沒(méi)有調(diào)用任何一個(gè) JavaServlet 的 API ,它是如何獲得請(qǐng)求的數(shù)據(jù)并將執(zhí)行結(jié)果暴露給輸入頁(yè)面的呢?它是通過(guò)值堆棧和表達(dá)式語(yǔ)言來(lái)實(shí)現(xiàn)(后面會(huì)有詳細(xì)介紹)。我們先看看 Action 是如何獲得請(qǐng)求的數(shù)據(jù)。輸入框的名字“ username ”,即請(qǐng)求的參數(shù)的名字,它就是一個(gè)表達(dá)式語(yǔ)言。 WebWork 遇到這個(gè)表達(dá)式語(yǔ)言,就會(huì)執(zhí)行相應(yīng)的 setUsername 方法,而 username 參數(shù)的值就是執(zhí)行這個(gè)方法的參數(shù)。這些是在 Action 執(zhí)行 execute 方法之前完成,這樣 Action 就可以獲得請(qǐng)求的數(shù)據(jù)對(duì)象。類似的原理, WebWork 也是通過(guò)表達(dá)式語(yǔ)言將 getWelcomeMessage 方法暴露給結(jié)果頁(yè)面。
3、 結(jié)果頁(yè)面。welcomeResult.jsp頁(yè)面,將通過(guò)表達(dá)式語(yǔ)言,取得Action執(zhí)行之后暴露出來(lái)的數(shù)據(jù)對(duì)象。代碼如下:
<%@ taglib prefix = "ww" uri = "/webwork" %>
< ww:property value = "%{welcomeMessage}" />
我們?cè)诮Y(jié)果頁(yè)面中使用了 WebWork 標(biāo)簽庫(kù)。我們用到的是 property 標(biāo)簽,它通過(guò)表達(dá)式語(yǔ)言,打印 Action 暴露出的數(shù)據(jù)對(duì)象。
4、 定義配置文件xwork.xml。代碼如下:
< xwork >
< include file = "webwork-default.xml" />
< package name = "default" extends = "webwork-default" >
< action name = "welcome" class = "com.noname.web.action.WelcomeAction" >
< result name = "success" type = "dispatcher" > /welcomeResult.jsp </ result >
< interceptor-ref name = "params" />
</ action >
</package>
</xwork>
“ name ”參數(shù)用于請(qǐng)求的 URL 。例如: http://localhost/welcome.action ,這樣通過(guò)請(qǐng)求的 url ,我們就可以在配置文件中找到對(duì)應(yīng)的 action 。“ class ”即實(shí)現(xiàn) Action 的類。一個(gè) Action 中可以定義多個(gè) Result 。 Result 的“ name ”對(duì)應(yīng) Action 方法返回的字符串。在我們的 WelcomeAction 方法中,執(zhí)行成功之后返回字符串“ success ”。即我們?cè)谶@個(gè) Action 里定義的那個(gè) result 。“ interceptor-ref ”定義這個(gè) action 所使用到的攔截器。我們這里使用了 WebWork 提供的 params 攔截器,它能自動(dòng)的幫我們將請(qǐng)求的參數(shù)組裝成 Action 中需要的數(shù)據(jù)對(duì)象。通過(guò)這個(gè)攔截器,它會(huì)調(diào)用 Action 的 setUsername 方法,取得 username 參數(shù)的值,這樣 Action 就可以獲得用戶輸入的 username 數(shù)據(jù)。也許你會(huì)奇怪, params 這個(gè)攔截器是從哪里變出來(lái)的?這個(gè) xwork.xml 文件包含了 WebWork 提供的默認(rèn)配置文件 webwork-default.xml,可以在webwork-2.2.2.jar文件中找到。我們定義的這個(gè)package繼承了它里面的package“webwork-default”,這樣就可以共享“webwork-default”package里面定義的所有攔截器。
WebWork 原理
通過(guò)上面的例子,我們已經(jīng)了解WebWork開(kāi)發(fā)、運(yùn)行的基本流程(一定要親自安裝,并開(kāi)發(fā)這個(gè)Welcome的例子哦)。如果要在實(shí)際項(xiàng)目中使用WebWork,我們必須要了解下面的概念和WebWork的原理。
ValueStack( 值堆棧 ) 和 EL( 表達(dá)式語(yǔ)言 )
關(guān)于ValueStack的描述:
1、 ValueStack其實(shí)就是一個(gè)放置Java對(duì)象的堆棧而已,唯一特別的是可以使用EL來(lái)獲得值堆棧中對(duì)象屬性的數(shù)據(jù),并可以為值堆棧的對(duì)象屬性賦值。
2、 EL,全稱Express Language,即表達(dá)式語(yǔ)言。不要被語(yǔ)言嚇倒,它是簡(jiǎn)單的對(duì)象導(dǎo)航語(yǔ)言。有字符串(例如:方法名)和特殊字符組成(例如用.表示調(diào)用對(duì)應(yīng)的屬性方法)。通過(guò)EL,我們可以存、取對(duì)象數(shù)據(jù),而且還可以直接訪問(wèn)類的靜態(tài)數(shù)據(jù),調(diào)用靜態(tài)方法。
3、 WebWork的ValueStack底層有第三方開(kāi)源項(xiàng)目OGNL實(shí)現(xiàn)。所以EL也都遵循OGNL的規(guī)范。我們?cè)陂_(kāi)發(fā)中,幾乎不需要知道OGNL的細(xì)節(jié)。
4、 WebWork為每一次請(qǐng)求構(gòu)建一個(gè)ValueStack,并將所有相關(guān)的數(shù)據(jù)對(duì)象(例如:Action對(duì)象、Model對(duì)象等)放到ValueStack中。再將ValueStack暴露給視圖頁(yè)面,這樣頁(yè)面就可以直接訪問(wèn)后臺(tái)處理生成的數(shù)據(jù)。
下面我們用一個(gè)雇員類為例,使用Junit框架(單元測(cè)試框架)來(lái)展示ValueStack的功能。
我們有一個(gè)Employee類,它有兩個(gè)屬性:姓名,地址。姓名是一個(gè)字符串,地址是一個(gè)對(duì)象,地址類有國(guó)家、城市、街道三個(gè)屬性。代碼如下:
Employee.java代碼如下:
public class Employee {
private String name;
private Address address;
public Employee() {
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Address getAddress() {
if(address == null)
address = new Address();
return address;
}
public void setAddress(Address address) {
this.address = address;
}
}
Address.java代碼如下:
public class Address {
private String country;
private String city;
private String street;
……
//默認(rèn)的Get和Set方法,省略
}
下面出場(chǎng)的是OgnlValueStackTest,它有兩個(gè)測(cè)試方法。分別測(cè)試使用EL從ValueStack中取值和存值。代碼如下:
import com.opensymphony.xwork.util.OgnlValueStack;
import junit.framework.TestCase;
public class OgnlValueStackTest extends TestCase {
private OgnlValueStack valueStack;
private Employee employee;
@Override
protected void setUp() throws Exception {
valueStack = new OgnlValueStack();
employee = new Employee();
valueStack.push(employee);
}
public void testCouldGetDataFromObjectInOgnlValueStackByEL() throws Exception{
employee.setName("Moxie");
Address address = new Address();
address.setCountry("China");
employee.setAddress(address);
assertEquals("Moxie",valueStack.findValue("name"));
assertEquals("China",valueStack.findValue("address.country"));
}
public void testCouldSetDataForObjectInOgnlValueStackByEL() throws Exception{
valueStack.setValue("name","Moxie");
valueStack.setValue("address.country","China");
assertEquals("Moxie",employee.getName());
assertEquals("China",employee.getAddress().getCountry());
}
}
這是一個(gè)Junit Test,關(guān)于Junit的使用不是本篇文章的范疇。作為一個(gè)Java開(kāi)發(fā)者,熟悉這樣的測(cè)試框架是最基本的要求。setUp方法在每個(gè)測(cè)試方法調(diào)用之前都會(huì)執(zhí)行,它用來(lái)初始化每個(gè)測(cè)試方法都需要的對(duì)象和數(shù)據(jù)。我們的setUp方法首先創(chuàng)建兩個(gè)對(duì)象:valueStack對(duì)象和employee對(duì)象,然后將employee對(duì)象入棧。這樣,emloyee對(duì)象就在值堆棧的最上端。
第一個(gè)測(cè)試方法testCouldGetDataFromObjectInOgnlValueStackByEL測(cè)試可以用表達(dá)式語(yǔ)言取得值堆棧里的對(duì)象數(shù)據(jù)。我們首先為值堆棧里的employee對(duì)象設(shè)置數(shù)據(jù),設(shè)置了用戶名和用戶地址所在的國(guó)家。
第一個(gè)驗(yàn)證斷言 assertEquals("Moxie",valueStack.findValue("name"))解釋為:我們期望使用表達(dá)式語(yǔ)言“name”去ValueStack中查找得到的對(duì)象是”Moxie”。即期望valueStack.findValue("name")語(yǔ)句執(zhí)行返回的數(shù)據(jù)是”Moxie”對(duì)象。再深入下去,這條語(yǔ)句會(huì)調(diào)用ValueStack里對(duì)象的getName方法(即employee對(duì)象的getName方法),并返回這個(gè)方法返回的數(shù)據(jù)。
第二個(gè)斷言assertEquals("China",valueStack.findValue("address.country"))。它期望表達(dá)式語(yǔ)言“address.country”取得的數(shù)據(jù)是對(duì)象的address屬性對(duì)象的country屬性,即取得雇員對(duì)象的地址所在的國(guó)家。深入下去,它也就是調(diào)用對(duì)象employee的getAddress().getCountry()方法。 第二個(gè)測(cè)試方法testCouldSetDataForObjectInOgnlValueStackByEL測(cè)試通過(guò)表達(dá)式語(yǔ)言為ValueStack中的對(duì)象設(shè)置數(shù)據(jù)。
第一個(gè)設(shè)值語(yǔ)句valueStack.setValue("name","Moxie"),它通過(guò)表達(dá)式語(yǔ)言“name”將“”Moxie””賦值給ValueStack里的對(duì)象,即調(diào)用值堆棧中的對(duì)象的setName方法,并把后面的值作為方法的參數(shù)。同理,第二個(gè)設(shè)置語(yǔ)句會(huì)調(diào)用值堆棧中的對(duì)象的getAddress().setCountry()方法,把后面的數(shù)據(jù)作為setCountry方法的參數(shù)。
看了這個(gè)例子,我們就會(huì)知道如何通過(guò)ValueStack進(jìn)行數(shù)據(jù)的存取。在我們使用ValueStack時(shí)需要注意:
1、 所有存取操作的目標(biāo)對(duì)象都是已放入ValueStack中的對(duì)象。所以在使用之前,必須要先將對(duì)象入棧。例如我們?cè)?/span>setup方法中的語(yǔ)句:valueStack.push(employee)。
2、 每一次WebWork請(qǐng)求,在創(chuàng)建Action對(duì)象之前都會(huì)先生成一個(gè)ValueStack對(duì)象,再將Action對(duì)象入棧。這樣我們就可以通過(guò)表達(dá)式語(yǔ)言來(lái)直接存取action對(duì)象的數(shù)據(jù),所以在WebWork中,action具有數(shù)據(jù)模型的功能。
3、 在對(duì)ValueStack進(jìn)行存取操作時(shí),我們的操作指令(表達(dá)式語(yǔ)言)并不知道它是對(duì)哪個(gè)對(duì)象進(jìn)行操作。例如,我們?cè)讷@取員工姓名時(shí),我們給的操作指令是”name”,這時(shí),并不知道ValueStack里面的對(duì)象一定就是employee。ValueStack會(huì)從上而下,遍歷棧里面的對(duì)象,并試圖調(diào)用當(dāng)前遍歷對(duì)象的getName方法,當(dāng)它找到了這個(gè)方法,并執(zhí)行之后,就會(huì)將執(zhí)行得到的數(shù)據(jù)返回。這就是那神秘的ValueStack。
4、 關(guān)于值堆棧的context map,它是一個(gè)放置值堆棧上下文數(shù)據(jù)的對(duì)象。通過(guò)符號(hào)“#“再加上對(duì)象的名稱,可以訪問(wèn)這些數(shù)據(jù)(只可以訪問(wèn))。一些JavaServlet相關(guān)的數(shù)據(jù)都放在這個(gè)容器中。這個(gè)對(duì)webwork的標(biāo)簽庫(kù)特別有用,這樣我們可以直接通過(guò)表達(dá)式語(yǔ)言去訪問(wèn)request、attribute、session、application里的數(shù)據(jù)。例如:用property標(biāo)簽庫(kù)打印出所有請(qǐng)求參數(shù)的數(shù)據(jù),代碼如下:<ww:property value="%{#request}"/>。
5、 其它。“top”是ValueStack里面的關(guān)鍵字,通過(guò)它可以找到ValueStack中最上面的那個(gè)對(duì)象。可以試著打印一下valueStack.findValue("top"))看看。表達(dá)式語(yǔ)言除了可以調(diào)用基于JavaBean規(guī)范的get和set方法之外,還可以調(diào)用一般的Java方法(這是需要使用方法的全名,并傳入需要的參數(shù)),也可以直接訪問(wèn)Java類的靜態(tài)字段和靜態(tài)方法。具體的使用,可以查看WebWork的官方文檔。
Interceptor( 攔截器 )
攔截器在前面的“WebWork核心概念”章節(jié)做了簡(jiǎn)單介紹,這里我們將對(duì)它進(jìn)行更進(jìn)一步的探討。關(guān)于攔截器的描述:
1、 一個(gè)攔截器就是在xwork.xml文件中定義的一個(gè)無(wú)狀態(tài)Java類,它至少要實(shí)現(xiàn)XWork的com.opensymphony.xwork.interceptor.Interceptor接口。代碼如下:
public interface Interceptor extends Serializable {
void destroy();
void init();
String intercept(ActionInvocation invocation) throws Exception;
}
2、 實(shí)現(xiàn)Interceptor接口的攔截器,代碼部分在intercept方法中實(shí)現(xiàn)。在intercept方法中,可以直接返回一個(gè)Result字符串,這樣整個(gè)執(zhí)行直接“短路”,這時(shí)Action的execute方法也不會(huì)執(zhí)行(一般很少會(huì)這么用)。所以,一般都會(huì)在這個(gè)方法里調(diào)用參數(shù)對(duì)象invocation的invoke方法,并返回這個(gè)方法執(zhí)行的結(jié)果。這樣會(huì)持續(xù)執(zhí)行后面的攔截器方法以及Action的execute方法等。
3、 大部分的時(shí)候,攔截器直接繼承WebWork的抽象類com.opensymphony.xwork.interceptor.AroundInterceptor就可以了。這時(shí),需要實(shí)現(xiàn)它的before和after方法。Before方法會(huì)在Action執(zhí)行之前調(diào)用,after方法在Action執(zhí)行之后調(diào)用。
4、 攔截器的執(zhí)行順序。我們可將多個(gè)攔截器放一起組裝成一個(gè)攔截器棧。這樣攔截器會(huì)按照棧的順序由上而下執(zhí)行before方法,所有before方法執(zhí)行結(jié)束,再執(zhí)行Action的方法,執(zhí)行Result的方法,再返回執(zhí)行結(jié)果,最后再?gòu)南露蠄?zhí)行攔截器的after方法。
5、 攔截器的過(guò)濾功能。我們通常會(huì)在應(yīng)用中使用一個(gè)通用的定義多個(gè)攔截器的攔截器棧。但有些Action方法在調(diào)用的時(shí)候,不需要要其中的部分?jǐn)r截器。這時(shí),我們就可以使用攔截器過(guò)濾功能。如果攔截器要擁有過(guò)濾功能,必須實(shí)現(xiàn)抽象類com.opensymphony.xwork.interceptor.MethodFilterInterceptor。這樣,攔截器在定義的時(shí)候或者在Action引用攔截器棧的時(shí)候,我們就可以指定哪些Action方法是需要過(guò)濾的,哪些Action是不需要過(guò)濾的。
WebWork提供的攔截器介紹
1、 自動(dòng)為Action設(shè)置Http請(qǐng)求數(shù)據(jù)的攔截器(Parameters Interceptor)。這個(gè)攔截器非常方便實(shí)用,但完全自動(dòng)組裝對(duì)象數(shù)據(jù),很可能會(huì)帶來(lái)安全問(wèn)題。如果Action不需要設(shè)置數(shù)據(jù),那么這個(gè)Action只要實(shí)現(xiàn)com.opensymphony.xwork.interceptor.NoParameters接口即可。如果是Action中部分?jǐn)?shù)據(jù)需要自動(dòng)設(shè)置,部分?jǐn)?shù)據(jù)不允許設(shè)置,這樣可以實(shí)現(xiàn)接口com.opensymphony.xwork.interceptor.ParameterNameAware,可以在這個(gè)接口的acceptableParameterName(String parameterName)方法中,定義我們可以接受哪些方法,如果允許只要讓這個(gè)方法返回True就可以了。
2、 過(guò)慮參數(shù)功能的攔截器(Parameter Filter Interceptor)。它可以全局阻止非法或不允許Action訪問(wèn)的參數(shù)。可以很好的和上面的組裝參數(shù)的攔截器一起使用。
3、 為Action設(shè)置靜態(tài)數(shù)據(jù)的攔截器(Static Parameters Interceptor)。它可以將Action定義的靜態(tài)<param/>參數(shù),設(shè)置到Action中。
4、 數(shù)據(jù)驗(yàn)證攔截器(Validation Interceptor)。定義之后,會(huì)調(diào)用驗(yàn)證文件或?qū)崿F(xiàn)驗(yàn)證接口com.opensymphony.xwork.Validateable的所有驗(yàn)證。
5、 驗(yàn)證流程處理攔截器(Workflow Interceptor)。它和上面的攔截器一起使用,處理驗(yàn)證的流程。如果驗(yàn)證通過(guò)則繼續(xù)前進(jìn),如果發(fā)現(xiàn)有驗(yàn)證錯(cuò)誤消息,直接轉(zhuǎn)到Action中定義的輸入結(jié)果(input)頁(yè)面。
6、 類型轉(zhuǎn)換錯(cuò)誤處理攔截器()。它首先去取得類型轉(zhuǎn)換的錯(cuò)誤消息(主要是由設(shè)置Http請(qǐng)求參數(shù)的攔截器產(chǎn)生),如果取到錯(cuò)誤消息,它會(huì)將錯(cuò)誤消息傳遞給實(shí)現(xiàn)接口com.opensymphony.xwork.ValidationAware的Action,這樣我們可以將這些錯(cuò)誤消息暴露到頁(yè)面中。
7、 Action鏈攔截器(Chaining Interceptor)。它是用來(lái)拷貝前一個(gè)Action的屬性數(shù)據(jù)到當(dāng)前Action中。它要求前一個(gè)Action必須是chain Result(<result type="chain">),這樣才能進(jìn)行Action的數(shù)據(jù)拷貝。
8、 防止頁(yè)面重復(fù)提交(或頁(yè)面重復(fù)刷新)攔截器。Token Interceptor和Token Session Interceptor都是防止重復(fù)提交的攔截器。不同點(diǎn)是后者在Session存貯了最近一次請(qǐng)求的結(jié)果數(shù)據(jù)。
9、 文件上傳的攔截器(File Upload Interceptor)。實(shí)現(xiàn)文件上傳的功能。如果有人曾經(jīng)手工寫過(guò)文件上傳程序,那一定會(huì)驚嘆于這個(gè)攔截器。我們可以在這個(gè)攔截器中設(shè)定上傳文件的大小和類型限制。記得需要第三方的文件上傳庫(kù)的支持,只要在webwork.properties中配置過(guò),并拷貝相應(yīng)的jar包就可以了。
10、 進(jìn)度條等待攔截器(Execute and Wait Interceptor)。當(dāng)Action的執(zhí)行需要很長(zhǎng)實(shí)際的時(shí)候,我們可以使用這個(gè)進(jìn)度條等待的攔截器。它會(huì)將Action放到后臺(tái)執(zhí)行,而在前端顯示進(jìn)度條或等待消息提示的頁(yè)面。
11、 還有一些其它不常用的攔截器,我們可以在WebWork文檔中找到,這里就不再做介紹。
IoC 容器
關(guān)于IoC容器的描述:
1、 它是一個(gè)容器。用來(lái)處理不同對(duì)象之間的依賴,組裝不同的程序元素。
2、 IoC全名是Inversion of Control,即依賴反轉(zhuǎn)控制。它是一種設(shè)計(jì)模式,IoC容器就是基于這個(gè)模式的實(shí)現(xiàn)。
3、 有一個(gè)比IoC更適合用來(lái)命名這一原理的名詞,它叫Dependency Injection,即依賴注入。
4、 有了依賴注入,我們可以將IoC容器簡(jiǎn)單理解為:它是一個(gè)用來(lái)為對(duì)象組裝其依賴的對(duì)象的容器;也就是說(shuō)對(duì)象本身不用關(guān)心它依賴的對(duì)象(可以是組件或者服務(wù),反正就是提供業(yè)務(wù)方法的對(duì)象)的創(chuàng)建,初始化,生命周期等,而是由容器來(lái)控制。
5、 關(guān)于IoC的更多信息可以查看Martin Fowler的經(jīng)典文章《IoC 容器和Dependency Injection 模式》
WebWork框架本身就提供了一個(gè)基于接口的IoC容器。同時(shí)WebWork框架和提供了和第三方IoC容器的集成。在WebWork的項(xiàng)目中,我們可以直接使用Spring框架和Pico框架作為自己的IoC容器。而且Spring是WebWork官方推薦的IoC容器。
下面我們將介紹如何使用Spring作為WebWork的IoC容器。在討論如何集成Spring之前,我們要討論一個(gè)非常有意義的架構(gòu)問(wèn)題:
WebWork的Action類是否需要由Spring管理?
1、 否。這樣Action類還是象以前那樣在xwork文件中定義,我們可以通過(guò)標(biāo)簽<external-ref/>定義Action所依賴的Bean組件,或者根據(jù)Bean的名字或類型進(jìn)行自動(dòng)注入。
2、 是。Action類本身也是有Spring來(lái)管理。在xwork定義文件中的Action class就是對(duì)Bean的引用,具體的類在Spring的Bean配置文件中定義。這樣可以更好的使用Sping為我們提供的更多功能,例如:Spring的復(fù)雜AOP功能,基于Acegi的權(quán)限控制,等等。
兩種方法,根據(jù)需要選擇一種,我個(gè)人更傾向后者。下面我們介紹一下Spring容器的安裝步驟:
1、 拷貝Spring依賴的所有jar文件
2、 在web.xml文件定義和開(kāi)啟Spring的監(jiān)聽(tīng)器,代碼如下:
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
3、 在webwork.properties中設(shè)置WebWork對(duì)Spring的支持:webwork.objectFactory = spring
4、 可以在webwork.properties中設(shè)置Bean組件的默認(rèn)組裝方式,默認(rèn)是按照Bean的名稱,可以選擇按照類型、構(gòu)造函數(shù)、自動(dòng)選擇等方式。
WebWork 原理
WebWork的網(wǎng)站上提供了一個(gè)完整的WebWork架構(gòu)圖。它描述了從客戶端的一次請(qǐng)求到最后服務(wù)器端響應(yīng)的的整個(gè)執(zhí)行過(guò)程。架構(gòu)圖如下:
此架構(gòu)圖一個(gè)分為五個(gè)部分,其中五個(gè)部分分別有五中不同顏色表示。
1、 淺灰色方框。分別代表了客戶端的一次Http請(qǐng)求,和服務(wù)器端運(yùn)算結(jié)束之后的一次響應(yīng)。
2、 淺紅色方框。表示一次Action請(qǐng)求所要經(jīng)過(guò)的Servlet filters(Servlet 過(guò)濾器)。我們可以看到最后一個(gè)filter就是我們前面介紹的WebWork的前端控制器。
3、 藍(lán)色方框。這是WebWork框架的核心部分。
1) 一次請(qǐng)求到了WebWork的前端控制器,它首先會(huì)根據(jù)請(qǐng)求的URL解析出對(duì)應(yīng)的action 名稱,然后去咨詢ActionMapper這個(gè)action是否需要被執(zhí)行。
2) 如果ActionMapper決定這個(gè)action需要被執(zhí)行,前端控制器就把工作委派給ActionProxy。接著她們會(huì)咨詢WebWork的配置管理器,并讀取在web.xml文件中定義的配置信息。接下來(lái)ActionProxy會(huì)創(chuàng)建ActionInvocation對(duì)象。
3) ActionInvocation是Xwork原理的(Command模式)實(shí)現(xiàn)部分。它會(huì)調(diào)用這個(gè)Action已定義的攔截器(before方法),Action方法,Result方法。
4) 最后,看上面流程的圖的方向,它會(huì)再執(zhí)行攔截器(after方法),再回到Servlet Filter部分,最后結(jié)束并傳給用戶一個(gè)結(jié)果響應(yīng)。
4、 靛色方框。這是攔截器部分,在上面的攔截器章節(jié)我們已經(jīng)有了詳細(xì)的介紹。
5、 黃色方框。這是我們?cè)陂_(kāi)發(fā)Web應(yīng)用時(shí),需要自己開(kāi)發(fā)的程序。其中包括:Action類,頁(yè)面模板,配置文件xwork.xml。
WebWork 實(shí)戰(zhàn)和技巧
限于篇幅,我們無(wú)法在本章節(jié)給出很多詳盡的具體實(shí)例。其實(shí),在WebWork的代碼包中,有一個(gè)非常好的演示項(xiàng)目——showcase,它用例子演示了WebWork的幾乎所有特性。值得初學(xué)的朋友反復(fù)研究。我們?cè)诒菊鹿?jié)中會(huì)截取其中的部分代碼腳本。
1、 多視圖支持。WebWork框架天生支持多種視圖技術(shù),包括:Jsp、FreeMarker、Velocity、Jasper Reports、XSLT,還有其它的視圖技術(shù)。這將在敏捷項(xiàng)目中特別有用。在我咨詢的項(xiàng)目中,就有一個(gè)因?yàn)榧夹g(shù)的原因,視圖技術(shù)由最先的Jsp改為Velocity,后來(lái)又改造為FreeMarker。其中,Action類以及后臺(tái)的程序沒(méi)有做任何的改動(dòng)。如果您需要一個(gè)視圖展現(xiàn)層技術(shù),我在這會(huì)好不猶豫的向您推薦FreeMarker。這也是官方的推薦。
關(guān)于視圖技術(shù)的使用,首先是搭建視圖技術(shù)運(yùn)行的環(huán)境。然后就是編寫頁(yè)面腳本,最后就是在xwork.xml文件中配置。Xwork配置文件中,Result的type參數(shù),就是用來(lái)標(biāo)示所使用的視圖技術(shù)。在showcase項(xiàng)目中,使用到的視圖技術(shù)有:Jsp、FreeMarker、Velocity、Jasper Reports。
2、 Action的數(shù)據(jù)驗(yàn)證功能。在WebWork中,可以在三處實(shí)現(xiàn)數(shù)據(jù)驗(yàn)證功能。一、驗(yàn)證文件(例如:ActionClass-validation.xml文件)中定義數(shù)據(jù)驗(yàn)證規(guī)則。二、在Action中實(shí)現(xiàn)com.opensymphony.xwork.Validateable接口的validate方法。三、在Action的執(zhí)行方法中,硬編碼實(shí)現(xiàn)驗(yàn)證功能。當(dāng)然,在實(shí)現(xiàn)驗(yàn)證時(shí),我們盡可能的用前面兩中方法。
關(guān)于驗(yàn)證的說(shuō)明:
1)、第一種驗(yàn)證需要“validation”攔截器的支持。并可以從任意層次綁定驗(yàn)證文件,可以為一個(gè)Action類綁定一個(gè)驗(yàn)證文件,也可以為一個(gè)具體在xwork.xml文件中的Action定義綁定一個(gè)驗(yàn)證文件,可以為Action的一個(gè)屬性對(duì)象綁定一個(gè)驗(yàn)證文件,甚至可以為Action的父類綁定驗(yàn)證文件。
2)、WebWork為驗(yàn)證文件提供了一些標(biāo)準(zhǔn)的驗(yàn)證實(shí)現(xiàn):例如:字段必須填寫,整型、E-mail地址等等。我們也可以使用表達(dá)式語(yǔ)言實(shí)現(xiàn)更復(fù)雜的數(shù)據(jù)驗(yàn)證。
3、 類型轉(zhuǎn)換。前面外面一直提到過(guò),WebWork會(huì)自動(dòng)從請(qǐng)求的字符串參數(shù)中組裝Action需要的數(shù)據(jù)對(duì)象。這樣,就會(huì)存在一個(gè)類型轉(zhuǎn)換的問(wèn)題。如果Action的字段是基本類型或是一個(gè)數(shù)據(jù)對(duì)象,WebWork會(huì)自動(dòng)幫我們處理。如果Action的字段是一個(gè)集合,或者我們需要特定的類型轉(zhuǎn)換,這時(shí),我們可以在類型轉(zhuǎn)換的定義文件(ClassName-conversion.properties)中定義轉(zhuǎn)換規(guī)則。
4、 一個(gè)Action的多個(gè)執(zhí)行方法。WebWork的Action是基于Command模式的實(shí)現(xiàn),在WebWork中,除了實(shí)現(xiàn)Action接口的execute()方法之外,Action還可以定義多個(gè)執(zhí)行方法。這些方法必須要是無(wú)方法參數(shù),并且返回返回字符串的方法。這樣我們?cè)?/span>Url中可以用類似下面的格式訪問(wèn):actionName!methodName.action,例如user!doAdd.action,調(diào)用user Action類的doAdd方法。在最新的WebWork中,Action類甚至可以不實(shí)現(xiàn)Action接口。
5、 Action鏈(Action Chaining)。在WebWork中,一次用戶請(qǐng)求,可由多個(gè)Action共同完成。每個(gè)Action可以只實(shí)現(xiàn)自己本身的功能單元,這樣我們可以根據(jù)業(yè)務(wù)需要為用戶的一次請(qǐng)求選擇一個(gè)或多個(gè)Action功能單元來(lái)實(shí)現(xiàn)。在這樣的多個(gè)Action之間可以通過(guò)chain攔截器共享數(shù)據(jù)。如果請(qǐng)求由Action x 鏈到Action y,如果這時(shí)y需要獲得x的數(shù)據(jù),我們就需要為Action y添加chain攔截器。
例如:在showcase中就由Action Chaining的應(yīng)用。它將Action“actionChain2”鏈到另外一個(gè)Action“actionChain3”,配置文件代碼如下:
< action name = "actionChain2" class = "com.opensymphony.webwork.showcase.actionchaining.ActionChain2" >
< result type = "chain" > actionChain3 </ result >
</ action >
< action name = "actionChain3" class = "com.opensymphony.webwork.showcase.actionchaining.ActionChain3" >
< result > /actionchaining/actionChainingResult.jsp </ result >
</ action >
注意:如果要加 chain 攔截器,是需要加到 actionChain3 中,而不是 actionChain2 。
6、 多模塊支持解決方案。 WebWork 提供了很靈活的多模塊解決方案,這樣我們可以很好的組織復(fù)雜的 Web 應(yīng)用項(xiàng)目。
1 )可以在 xwork.xml 文件中,用 include 標(biāo)簽包含另外的一個(gè) xwork 配置文件。例如: <include file="webwork-default.xml"/>
2 ) xwork.xml 配置文件支持 package 。我們可以將一個(gè)業(yè)務(wù)模塊的定義方到一個(gè) package , package 支持繼承功能,子 package 可以享有父 package 的所有定義。
3 )可以為 package 定義一個(gè)命名空間。不同的命名空間可以定義相同的 action 名字。命名空間會(huì)用于訪問(wèn) action 的 URL ,基于這個(gè)命名空間,我們可以實(shí)現(xiàn)資源權(quán)限的訪問(wèn)控制。
7、 doInput 方法。這是我們常用的小技巧,有時(shí)候請(qǐng)求的就是一個(gè)頁(yè)面模板,總不能為這個(gè)單獨(dú)寫一個(gè) Action 類吧,這時(shí)我們就可以用 ActionSupport 的 doInput 方法,直接返回在 Actoion 中定義為“ input ”的 result 。
8、 prepare方法。如果在Action執(zhí)行之前,必須要初始化一些數(shù)據(jù)。我們可以將這些初始化的代碼方到prepare方法中。這時(shí),Action類要實(shí)現(xiàn)接口com.opensymphony.xwork.Preparable,同時(shí)這個(gè)Action的定義還需要PrepareInterceptor攔截器的支持。
9、 Action的Model Driven。我們大部分的時(shí)候用得都是Action的Field Driven,即直接將Action的字段作為數(shù)據(jù)模型。Model Driven是專門為這個(gè)Action指定一個(gè)模型對(duì)象,這樣有什么好處呢?好處是在表達(dá)式語(yǔ)言中少了一個(gè)對(duì)象名的前綴。例如:前面值堆棧部分關(guān)于Employee的例子,要設(shè)置雇員名稱,我們必須要表達(dá)式語(yǔ)言例如:“employee.name”,如果這個(gè)數(shù)據(jù)是有頁(yè)面輸入得到,那么你就必須有一個(gè)Input輸入框的name為“employee.name”,因?yàn)樗嘘P(guān)鍵字符“.”,如果Javascript腳本使用這個(gè)輸入框的名字,就會(huì)有錯(cuò)誤。使用Model Driven之后,這個(gè)表達(dá)式就可以變?yōu)?#8220;name”,省去了前面的“employee.”。
10、 Quick Start。這是WebWork2.2.2中非常激動(dòng)人心的特性。它可以象perl或PHP可以快速看到程序運(yùn)行結(jié)果。這樣在Web開(kāi)發(fā)時(shí),可以不用編譯Java源代碼,也不用去做打包和部署,就可以快速看到最新程序的運(yùn)行結(jié)果,提高開(kāi)發(fā)效率。我們可以在WebWork源碼解壓包的根目錄,輸入命令:java -jar webwork-2.2.2.jar quickstart:showcase(需要jdk1.5的支持),以Quick Start模式,運(yùn)行showcase項(xiàng)目。
展望 WebWork 未來(lái)
這是很多人非常關(guān)心的一個(gè)問(wèn)題。特別是WebWork2.2版本發(fā)布之后,官方宣稱WebWork框架將要和Struts合并。這讓一些WebWork的用戶產(chǎn)生了擔(dān)憂,合并之后,是不是就意味著自己在WebWork這方面技術(shù)和經(jīng)驗(yàn)的積累都已浪費(fèi)?已使用或即將使用WebWork的項(xiàng)目是不是就意味著更多的風(fēng)險(xiǎn)?
答案是:完全不用擔(dān)心這些。WebWork和Struts的合并,是各取所長(zhǎng),然后誕生出一個(gè)更加高效的Web框架。而這個(gè)框架用得就是WebWork的優(yōu)秀技術(shù)和Struts的強(qiáng)大社區(qū)。
合并的情況如下:
1、 產(chǎn)生一個(gè)新的項(xiàng)目Struts Action 2.0 = WebWork2.2 + 一些Struts的功能和特性。
2、 WebWork框架將會(huì)中止新功能的增加,如果有新的版本發(fā)布都會(huì)是Bug的修改。
3、 代碼、框架的開(kāi)發(fā)者、社區(qū)都將移到Struts。
4、 合并的目標(biāo)是致力于生產(chǎn)率的提高。
5、 Struts不再是一個(gè)框架,它是一個(gè)社區(qū)。
6、 Struts社區(qū)中主要有兩個(gè)Web框架。一個(gè)是基于Action模型的Struts Action;另一個(gè)是基于組件模型的Struts Shale。
總結(jié)
WebWork是本人工具箱中最愛(ài)的一個(gè)J2EE Web框架。本人開(kāi)發(fā)過(guò)單純使用Jsp和JavaServlet的項(xiàng)目;也曾經(jīng)自己開(kāi)發(fā)過(guò)基于MVC的Web框架;在2002年開(kāi)始使用Struts開(kāi)發(fā);后來(lái)也在項(xiàng)目中分別使用過(guò)Tapestry和Spring MVC Web框架;也在當(dāng)今的AJAX潮流中隨波逐流。上面的一些技術(shù)也都非常優(yōu)秀,擅用他們?nèi)魏我粋€(gè)都會(huì)給您帶來(lái)很多生產(chǎn)效率的提高。但我仍然是偏愛(ài)WebWork。WebWork的與眾不同,得力于它基于OGNL的強(qiáng)大的數(shù)據(jù)存、取方式,得力于它那解耦的攔截器功能,得力于它那無(wú)侵入的架構(gòu)設(shè)計(jì)。正是由于它,才讓Web編程變得更加的自然、簡(jiǎn)單、靈活、高效。