隨筆檔案

作者：施偉，原文出處： http://www.aygfsteel.com/crespo9907/archive/2007/03/10/webworkinaction_note3.html，轉(zhuǎn)載請保留。

??????在上一篇筆記WebWork In Action學(xué)習(xí)筆記(二) WebWork方式的HelloWorld 中我們已經(jīng)學(xué)會了如何構(gòu)建一個(gè)簡單的WebWork應(yīng)用程序，除了創(chuàng)建幾個(gè)簡單的Java和Jsp程序外還配置了web.xml和xwork.xml。本篇我們就來繼續(xù)討論都是在xwork.xml中配置的action、result和interceptor三個(gè)極其重要的部分。正是它們實(shí)現(xiàn)了WebWork中優(yōu)雅的MVC，result更是支持多種表現(xiàn)方式讓開發(fā)Viewer變得更加容易，而interceptor則讓W(xué)ebWork變得異常強(qiáng)大并具有魔法。下面我們就開始吧！

??????一、action? 絕對的核心

??????在實(shí)際應(yīng)用中不出意外action總是一個(gè)擴(kuò)展com.opensymphony.xwork.ActionSupport的Java類，或者說總是會繼承ActionSupport（直接或間接）。我們在上篇筆記的HelloWorld程序中就可以知道WebWork的通過Servlet-Dispatcher（新版本已經(jīng)更改為過濾器實(shí)現(xiàn)）接收道Http請求后分析特定的URL形式后調(diào)用action。如/hello.action樣式的URL請求就調(diào)用了HelloWorld類的execute()方法。

??????配置一個(gè)action需要的最少信息是action名和對應(yīng)的action類。當(dāng)它們添加到xwork.xml文件中時(shí)，就建立了一個(gè)action的映射。還是列出一個(gè)最簡潔的例子：將action名login映射到Login類。
??????
??????上面的代碼中action標(biāo)簽是自封閉的，你肯定會想這有什么用啊？確實(shí)，除了象使用<ww:action/>標(biāo)簽這種極少數(shù)的情況下，沒有result信息的action是沒有什么實(shí)際作用的。幸運(yùn)的是WebWork內(nèi)置了幾乎所有常用的result類型，當(dāng)然你也可以建立自定義的result類型（在后面的筆記會詳細(xì)介紹）。我們現(xiàn)在就來為上面的配置添加result吧，讓它成為一個(gè)真正能在實(shí)際中使用的action。


??????比較上面兩個(gè)例子有兩個(gè)重要的變化：引入了webwork-default.xml以及加入了兩個(gè)result節(jié)點(diǎn)。每個(gè)result都有一個(gè)名字、一個(gè)可選的類型和一個(gè)具體的值。當(dāng)沒有指定類型時(shí)就會使用package或者superpackage的默認(rèn)result類型。在這種情況下就是webwork-default.xml文件中定義的dispatcher（分發(fā)器）。

??????在上面的例子中，如果返回的result code是success那么用戶就會被重定向到/secure/dashboard.action（這是另外一個(gè)action，現(xiàn)在暫時(shí)還沒有定義，我們先不管它）。如果返回為input瀏覽器會在此顯示login.jsp，并且用戶剛才輸入的信息還在，因?yàn)榇藭r(shí)的類型為默認(rèn)的分發(fā)器，action會把參數(shù)值繼續(xù)傳遞給login.jsp。注意result映射可以是絕對路徑也可以是相對路徑。在討論namespace概念的時(shí)候，這個(gè)會很重要。

??????下面我們來討論一下為action提供別名。在配置中每一個(gè)action節(jié)點(diǎn)就是一個(gè)action映射，但是也可以將多個(gè)名字映射到相同的action類。WebWork是一個(gè)實(shí)現(xiàn)了泛化command模式的框架。在默認(rèn)情況下，WebWork調(diào)用action類的execute()方法。但是你也可以通過在action映射中增加一個(gè)可選的method屬性，指定WebWork應(yīng)該調(diào)用哪個(gè)方法。不過所指定的方法必須和execute()方法具有相同的“形狀”，即沒有輸入?yún)?shù)，返回一個(gè)String類型的result code并且有選擇的拋出異常。下面給出一個(gè)例子：

???
??????三個(gè)action均是關(guān)聯(lián)到UserAction類，第一個(gè)執(zhí)行默認(rèn)的execute()方法，而后兩個(gè)則執(zhí)行edit()方法。（注：WebWork通過xwork.xml映射到方法有兩種機(jī)制：通過查找與method屬性值一致的方法；通過查找doMethod()形式的方法。這是為了兼容舊版本的一些做法，因?yàn)橛行┰~是Java關(guān)鍵字不能作為方法名，如default。這個(gè)時(shí)候就把方法名寫為doDefault，method值為default同樣可以工作。不過上次看Struts的文檔發(fā)現(xiàn)WebWork2遷移到Struts2后取消了這種機(jī)制，所以建議大家最好不要使用。）還有一個(gè)小技巧請大家注意：后兩個(gè)action映射的方法都是一樣，但是配置了兩組不同的result，這也是action別名的好處之一。

??????WebWork還有一種很方便的不需要配置的別名語法，支持形為name!method.action的映射。如上面的例子中，users!edit.action就會被映射到edit()方法中。在Struts2中可以通過設(shè)置打開或者關(guān)閉這種語法。

??????附Struts2相關(guān)資源：
????? WebWork2與Struts2的一些區(qū)別???http://struts.apache.org/2.x/docs/key-changes-from-webwork-2.html
??????WebWork2如何遷移到Struts2?? http://struts.apache.org/2.x/docs/webwork-2-migration-strategies.html

??????我們還可以通過使用<param>標(biāo)簽來實(shí)現(xiàn)action的參數(shù)化，從而自定義action。舉個(gè)例子就很好理解了：假如已經(jīng)寫好了一個(gè)處理Web Service請求的action，現(xiàn)在你可能需要將action的不同實(shí)例綁定到不同的URL，你也可能為每個(gè)action建立一個(gè)獨(dú)立的timeout值。使用<param>標(biāo)簽?zāi)憔涂梢允褂猛粋€(gè)WebServiceAction類來實(shí)現(xiàn)你的想法。



??????當(dāng)action執(zhí)行時(shí)，WebWork會自動根據(jù)action映射中指定的值調(diào)用相應(yīng)的setter方法來設(shè)置這些參數(shù)值。當(dāng)然這些都是借助與interceptor的魔力。眼尖的人可能發(fā)現(xiàn)了一個(gè)問題，那就是我們在<param>中配置的可以看作都是字符串，而這里的timeout為long類型，還能正常工作嗎？回答是可以的，這借助了WebWork值得炫耀的自動類型轉(zhuǎn)換功能，因?yàn)閬碜杂谕饨绲妮斎雲(yún)?shù)其實(shí)都是字符串形的，而在Java對象內(nèi)部會有各種各樣復(fù)雜程度不一的類型，它們之間的轉(zhuǎn)換均交由WebWork的自動類型轉(zhuǎn)換功能來處理，是多么的方便啊！這不也就是我們平時(shí)編程中最容易出錯(cuò)、最煩人和最耗時(shí)的工作嗎？這么重要的功能我們當(dāng)然會在后面專門的一篇中來講述，在這里暫且按下不表。

??????現(xiàn)在你至少應(yīng)該知道action映射是如何配置了吧，下面我們就開始研究result映射和result類型吧。

??????二、result? 我們怎么顯示呢？

??????在WebWork應(yīng)用程序中主要要配置兩類與result相關(guān)的東西，一個(gè)是result類型，一個(gè)就是在上面的例子中反復(fù)出現(xiàn)的action的result。

??????首先我們來看看如何配置result類型。其實(shí)在webwork-default.xml中就配置了很多默認(rèn)的result類型，一般情況下這些就已經(jīng)足夠了，當(dāng)然你也可以配置自己的result類型，和默認(rèn)的配置方式是一致的。我們來看兩個(gè)使用最多的result類型。


??????result-types都是被包含在package中的，作為此package的類型設(shè)置，子package可以繼承父package的result-types。因?yàn)檫@里關(guān)注的是如何配置result類型，所以class用...來代替。第一個(gè)result-typ比第二個(gè)多處了default="true"，這個(gè)表示此result類型被設(shè)置為默認(rèn)的，當(dāng)action中配置的result不指定type屬性時(shí)就應(yīng)用此默認(rèn)result-types。

??????講一個(gè)關(guān)于result很重要的技巧，運(yùn)用全局的result映射可以減少重復(fù)的配置。告訴你一個(gè)最簡單的方法，你沒必要在一開始就想辦法應(yīng)用此技巧，套用一個(gè)很流行的詞匯這叫“過度設(shè)計(jì)”（當(dāng)然很明顯的例外），而是當(dāng)你配置完action如果發(fā)現(xiàn)同一個(gè)package中多個(gè)action配置了同樣的result時(shí)，你就可以應(yīng)用這個(gè)技巧。下面我們來看個(gè)典型的例子。


??????定義了login和unauthorized，一個(gè)對應(yīng)登錄頁面而另一個(gè)對應(yīng)沒有管理員權(quán)限時(shí)用戶被“丟去”的地方。顯然這兩種情況是常用的，定義為全局正好合適，省去了很多重復(fù)的配置，也顯得更加清晰。

??????在定義全局result的時(shí)候最好使用絕對路徑，因?yàn)樽鳛槿峙渲媚悻F(xiàn)在并不能夠確定它在什么context中被調(diào)用。所以使用絕對路徑一勞永逸。

??????三、interceptor?? WW城中的大魔法師

??????在決定性的攻城戰(zhàn)中大魔法師可不是隨意使用的，interceptor正是WebWork全面超越其他MVC框架的秘密武器！

??????interceptor是在圍繞action及result的執(zhí)行過程中釋放魔力的，然而在日常開發(fā)新的action的過程中，我們并不需要直接使用它們。典型的做法是創(chuàng)建一組或者一個(gè)堆棧的interceptor，并且在全局范圍內(nèi)將它們應(yīng)用到action中。就像大魔法師的群療術(shù)一樣，一旦釋放全屏補(bǔ)血。

??????在實(shí)際開發(fā)過程中，一個(gè)package可能包含一組interceptor。用一個(gè)<interceptors>節(jié)點(diǎn)來包含若干個(gè)<interceptor>來實(shí)現(xiàn)。


??????配置好interceptors后就可以應(yīng)用到action中了。


??????這個(gè)時(shí)候當(dāng)login這個(gè)action被調(diào)用的時(shí)候timer和logger這兩個(gè)interceptor也會相應(yīng)的被調(diào)用來施放魔法。我們想象一下如果某個(gè)action需要配置一百個(gè)interceptor那我們豈不是要在action中寫一百個(gè)interceptor這樣的東西，如果你是一個(gè)正常的程序員你肯定會瘋掉的。不過還好我們的大魔法師魔力無邊，提供了interceptor-stack這樣的一個(gè)東西來一系列的interceptor組合在一起形成一個(gè)stack，從而用stack來代替多個(gè)獨(dú)立的interceptor，這個(gè)時(shí)候action就不需要做那么傻的事情了。


??????可以看到action在引用一個(gè)獨(dú)立的interceptor和包含多個(gè)interceptor的stack時(shí)都是使用interceptor-ref，并不會區(qū)別對待，這就使得一個(gè)interceptor stack又可以同時(shí)包含獨(dú)立的interceptor和另外的interceptor stack。

??????是不是非常的靈活，也節(jié)省大量的重復(fù)代碼。WebWork盡量讓代碼量減少，不重復(fù)一句。這也是我們希望看到的，也是我們選擇使用框架的原因。并不是有了框架就能夠去除多變的需求，就能夠編碼如飛；框架僅僅是告訴我們什么不可以做，什么可以做，怎么樣做最好。下面讓我們繼續(xù)減少重復(fù)配置和代碼。

??????前面的result應(yīng)用全局的概念來減少配置的方法應(yīng)該還記得吧，intercetpro同樣也可以。（在coding的時(shí)候我們應(yīng)該把多處的重復(fù)匯集到一起，從而減少重復(fù)；而在thinking的時(shí)候我們應(yīng)該把一種思維和方法應(yīng)用到多處去，從而提高質(zhì)量）我們可以為每一個(gè)package建立一個(gè)默認(rèn)的interceptor-ref。


????? 這個(gè)時(shí)候package中的所有沒有定義interceptor-ref的action都會應(yīng)用此default-interceptor-ref指定的interceptor。并且一般情況下定義在同一包內(nèi)的action都會應(yīng)用相同的interceptor，所以這樣可以節(jié)約很多配置和代碼。不過需要注意的是只有沒有定義interceptor-ref的action才會應(yīng)用這個(gè)默認(rèn)配置，當(dāng)為action指定了interceptor-ref時(shí)，此action只會應(yīng)用這個(gè)interceptor-ref，而不是在default-interceptor-ref的基礎(chǔ)上加上自己定義的interceptor。

??????在后面的筆記中我們還會分別詳細(xì)的介紹這三個(gè)WebWork中最重要的組成部分，本來打算把webwork.properties的相關(guān)配置記一下，好像也沒這個(gè)必要，再寫也就是把官方文檔的內(nèi)容貼在這里，還是有問題就去看官方的文檔好。框架學(xué)習(xí)要養(yǎng)成多看文檔和API的好習(xí)慣，在一定的時(shí)候研讀源代碼也會對編程水平有非常大的提高而不僅僅在于使用這個(gè)框架了。

??????《WebWork in Action》這本書已經(jīng)看完很久了，因?yàn)榉N種的原因筆記現(xiàn)在才補(bǔ)上。但在補(bǔ)寫筆記的時(shí)候發(fā)現(xiàn)了好多書中之前沒有注意到關(guān)鍵內(nèi)容和對以前內(nèi)容的一個(gè)重新理解和衍生。我想這就是所謂的“溫故而知新”吧。

??????下一篇筆記將重點(diǎn)講述WW城中的戰(zhàn)士－－action。不管哪一款網(wǎng)游中，戰(zhàn)士永遠(yuǎn)是核心人物，最重要的部分，承擔(dān)著最多最重要的任務(wù)，并且直接面對敵人。告訴大家如何實(shí)現(xiàn)WebWork中的action，以及實(shí)現(xiàn)過程中的相關(guān)問題和技巧。