Struts2.1.6+Spring2.5.6+Hibernate3.3.1全注解實(shí)例詳解（四）
這一章，大象將詳細(xì)分析 web 層代碼，以及 struts2 的注解插件—— struts2-convention 的用法和其它相關(guān)知識。 第四部分：透析控制層 上一章對 dao 、 entity 、 service 三層進(jìn)行了詳細(xì)的分析，并對代碼進(jìn)行了測試。測試結(jié)果表明這部分功能沒問題，可以正常使用。本章將對最后一個(gè) web 層進(jìn)行詳細(xì)說明，盡可能的講明白這些知識要點(diǎn)。 數(shù)據(jù)庫 本例使用MySQL數(shù)據(jù)庫，只有三張表，一張用于管理表主鍵的 generator_table ，另外兩張是人員表與角色表。 這里我有一點(diǎn)需要說明一下，在學(xué)習(xí)JPA——Hibernate Annotation 使用實(shí)例 一文中，我將 generator_table 設(shè)了一個(gè) id 主鍵字段，其實(shí)這個(gè)字段是不需要的，直接將 g_key 設(shè)為主鍵。這樣設(shè)計(jì)更好些，因?yàn)楸砻豢赡芤粯?，所以這個(gè)存放各個(gè)表主鍵的鍵名也不會(huì)一樣。 user 與 role 這兩張表只設(shè)了一個(gè)主鍵，沒有建立外鍵關(guān)聯(lián)，而且大象也很反對建立表之間的外鍵關(guān)聯(lián)。因?yàn)檫@樣做之后，約束太多，在實(shí)際開發(fā)中，很容易出問題，這是我親身體會(huì)過的。所以我建議只對表設(shè)置一個(gè)流水號主鍵，其它的都可以根據(jù)業(yè)務(wù)關(guān)系來設(shè)計(jì)字段，這樣會(huì)更靈活。 這里對各個(gè)字段都默認(rèn)將它們設(shè)置為 null ，因?yàn)獒槍Σ煌谋恚愣紩?huì)實(shí)現(xiàn)相應(yīng)的功能，你當(dāng)然會(huì)知道哪些字段是不能為空的，哪些是可以為空的。而且在做數(shù)據(jù)庫設(shè)計(jì)的時(shí)候，你也不可能在短時(shí)間內(nèi)，面面俱到的把所有問題都考慮進(jìn)去，根據(jù)需求的變化，在開發(fā)過程中，也是經(jīng)常會(huì)遇到修改數(shù)據(jù)庫的情況。如果之前過于強(qiáng)調(diào)字段的非空設(shè)置，在編寫代碼時(shí)，為了減少出錯(cuò)，腦袋里可能會(huì)不停的想，啊，這個(gè)字段是非空的嗎？哪個(gè)字段不是非空的吧？然后反復(fù)對比數(shù)據(jù)庫進(jìn)行檢查，會(huì)使人束手束腳很不舒服。因?yàn)檫@些全部都可以人為來控制，所以除了主鍵外，將其它字段都設(shè)為 null 有利于開發(fā)人員更好的進(jìn)行工作。 有人會(huì)說了，進(jìn)行非空設(shè)置是一種約束，當(dāng)程序出錯(cuò)時(shí)，很容易發(fā)現(xiàn)問題。當(dāng)然，這話說得沒錯(cuò)。大象只是建議，從沒說過一定要這樣做，我只是說下自己的一點(diǎn)經(jīng)驗(yàn)總結(jié)，僅此而已！想怎么實(shí)現(xiàn)都是你的自由。 struts2-convention 既然說了是全注解開發(fā)，而且我們已經(jīng)實(shí)現(xiàn)了 Hibernate 與 Spring 的注解。同樣的， Struts2 也能夠做到用注解來代替配置文件， struts2-convention 插件可以幫助我們完成這一功能。它是 struts2 提供的一個(gè)插件，目前網(wǎng)上相關(guān)的中文文檔主要是一個(gè)叫石太洋的人根據(jù)官方文檔翻譯的，很多網(wǎng)站與博客都有轉(zhuǎn)載。我看了原文與譯文，感覺講的不夠清楚，例子也很簡單。大象根據(jù)自己在項(xiàng)目中的實(shí)際使用情況，現(xiàn)將個(gè)人對這個(gè)插件的經(jīng)驗(yàn)總結(jié)寫出來與各位分享，希望與大家多交流，共同提高。 官方文檔 https://cwiki.apache.org/WW/convention-plugin.html 請不要把地址中的兩個(gè)大寫 W 換成小寫，否則是打不開頁面滴！這個(gè)插件的使用其實(shí)非常簡單，如果光看文檔可能會(huì)覺得好像很麻煩。那么大象來告訴你怎樣快速學(xué)習(xí)這個(gè)插件。 首先你要搞清楚，這個(gè)插件它會(huì)默認(rèn)掃描所有包名為 struts 、 struts2 、 action 、 actions 下面的類。然后它會(huì)對實(shí)現(xiàn)了 Action 接口以及類名以 Action 結(jié)尾的這些類，作為 Action 來進(jìn)行處理。 你可以重新定義按哪種包名進(jìn)行掃描。比如本例設(shè)定，只掃描 web 包下面的所有類，因?yàn)槲覀儗?/span>Action 類都放在這個(gè)包下面。 那這個(gè)插件是怎么實(shí)現(xiàn)原來的配置信息的呢？它的映射規(guī)則是這樣的，對于以 Action 結(jié)尾的的類，去掉 Action ，取剩下的部分，將所有的字母轉(zhuǎn)換為小寫，如果有駝峰式的寫法，則用 "-" 連接符來連接不同的單詞，這是此插件的默認(rèn)方式。最終轉(zhuǎn)換之后的就是請求地址，還是用例子說明。 com.bolo.examples.web.base.UserAction 按照上面的規(guī)則，請求地址就應(yīng)該是 UserAction 去掉 Action 后綴，將其余部分轉(zhuǎn)換為小寫，所以 user 就是我們的請求地址。不過，這還沒有完，因?yàn)檫@里面還有一個(gè)命名空間的路徑，在通常的配置文件中，一般會(huì)將不同的功能進(jìn)行劃分，在 package 標(biāo)簽里加上 namespace 屬性。使用這個(gè)插件，它會(huì)為你自動(dòng)配上命名空間，默認(rèn)的就是前面說到的以那四種名稱為根目錄的命名空間，它們之后的都將成為命名空間的名稱。 com.bolo.examples.struts.UserAction 映射為 /user.action com.bolo.examples.struts.base.UserAction 映射為 /base/user.action 要是我們不以 struts 或其它幾種默認(rèn)值為包名，又該怎么辦呢？沒關(guān)系，插件為我們提供了一種自定義根包的配置方式 <constant name="struts.convention.package.locators" value="web" /> 上面這段配置是寫在 struts.xml 里面的，它指定 web 為根，作用就相當(dāng)于那四種默認(rèn)值。com.bolo.examples.web.base.UserAction 映射為 /base/user.action com.bolo.examples.web.HelloAction 映射為 /hello.action com.bolo.examples.web.HelloWorldAction 映射為 /hello-world.action 請一定注意駝峰寫法的映射方式，假如這里不是 HelloWorld ，而是 Helloworld ，那就不會(huì)再是 hello-world.action ，而是 helloworld.action 了。 既然已經(jīng)知道了它的映射方式，接下來再看看這個(gè)插件是如何定義結(jié)果頁面的。 convention 默認(rèn)會(huì)到 /WEB-INF/content 文件夾下面查找對應(yīng)的結(jié)果頁面，這個(gè)文件夾的名字可以修改，需要在 struts.xml 中定義 <constant name="struts.convention.result.path" value="/WEB-INF/jsp" /> 文件夾的名字改成了 jsp ，這樣定義后， convention 就會(huì)在這個(gè)文件夾下面查找結(jié)果頁面。它的查找路徑與映射的命名空間有關(guān)。默認(rèn)規(guī)則是，在請求的命名空間下面，根據(jù)請求名稱再結(jié)合方法返回的字符串生成最終的結(jié)果頁面名稱，再配以后綴名。 convention 支持以 jsp 、 ftl 、 vm 、 html 、 htm 等五種后綴格式的文件。這里有個(gè)比較特殊的是如果方法返回 success ，那么可以不用將它與請求名稱拼接起來，直接使用請求名稱作為返回頁面的名稱。還是舉例子說明。 比如上面這段代碼， HelloAction 處于我們定義的根包（ web ）下面，因此，它的 action 請求為 hello.action 。這時(shí)，會(huì)默認(rèn)執(zhí)行 execute() 方法，由于返回的是 success 字符串，所以頁面的名稱可以簡寫為 hello.jsp ，但是當(dāng)執(zhí)行 welcome 方法時(shí)，由于返回的字符串為 welcome ，這時(shí)的頁面名稱則為 hello-welcome.jsp 。 convention 就是遵循這樣的規(guī)則來進(jìn)行命名，當(dāng)然這只是最基本的，我們再來看看稍微復(fù)雜點(diǎn)的東東。 這個(gè) RoleAction 類的外部，加了兩種注解，它們的作用相當(dāng)于配置文件中的 result 標(biāo)簽。 Results 是一個(gè) Result 類型的數(shù)組注解，里面可以包含多個(gè) Result 配置。使用 Result 注解來設(shè)置返回類型與返回頁面，是不準(zhǔn)備采取默認(rèn)的定義方式。比如 HelloAction 就是我們采取的默認(rèn)方式。另外對于有些特殊的返回類型，也需要顯式的進(jìn)行定義。 因?yàn)槲覍?/span>RoleAction 中的 execute() 方法返回結(jié)果進(jìn)行了顯式的定義，所以，它將不再返回默認(rèn)的 role.jsp ，而是 location 指定的 role-list.jsp ， Result 注解中的 name 值要與返回值對應(yīng)。 當(dāng)請求路徑為 role!input.action 時(shí)，會(huì)執(zhí)行 input() 方法，對于這個(gè)方法來說，由于沒有進(jìn)行顯式的定義，所以它會(huì)按照默認(rèn)的命名規(guī)則返回 role-input.jsp 。 而 redirectUser 方法的返回結(jié)果指定了一個(gè) type 為 redirectAction 的值，這表示要對 Action 重定向，在 location 中也說明了是跳轉(zhuǎn)到哪個(gè) Action 。請注意這里指定的是 user.action ，當(dāng)程序跳轉(zhuǎn)到 UserAction 時(shí)，會(huì)默認(rèn)執(zhí)行 execute 方法。假如說，你想執(zhí)行其它方法該怎么辦呢？可以在 location 里面這樣定義， location= "user!input.action" 。請記住，重定向時(shí)，如果是跳轉(zhuǎn)到其它 Action 或本 Action 中的其它方法， type 要寫成 redirectAction 。 更進(jìn)一步，我還想帶些參數(shù)過去，又該如何呢？請?zhí)砑?/span>params 屬性，它是一個(gè)數(shù)組類型?？梢赃@樣定義， params={ "role_id" , "${role_id}" , "role_name" , " 超級管理員 " } 。 convention 文檔中有說明，里面的參數(shù)是一個(gè)鍵值對，總是形如 key,value,key,value 。所以第一個(gè) role_id 與第三個(gè) role_name 都叫參數(shù)名，二和四則是參數(shù)值。另外注意下 "${role_id}" 的含義，這是使用的 OGNL 表達(dá)式取出存在于值棧中的名叫 role_id 的值。這是一種動(dòng)態(tài)獲取并賦值的方式，在采用配置文件的方式中，也可以這樣運(yùn)用，而 role_name 參數(shù)則是一個(gè)固定字符串值。需要特別注意的就是，作為參數(shù)名的 role_id 與 role_name ，一定要在指向的 Action 中有這兩個(gè)同名的屬性，并且還有 set 方法，這是用來給這兩個(gè)屬性賦值。而對于 ${role_id} ，則要在當(dāng)前這個(gè) Action 中，有它的 get 方法。用于取值。 補(bǔ)充說明一下，在 Action 類中定義的全局變量，不是非得給它都加上 set 、 get 方法，這是根據(jù)實(shí)際情況來設(shè)置的。簡單的說 get() 是獲得值， set() 是設(shè)置值。比如，你現(xiàn)在要在頁面上顯示 username ，那么就對這個(gè)屬性設(shè)置 get 方法，如果只是對 username 設(shè)置值，從頁面?zhèn)髦档?/span>Action ，那只需要對它設(shè)置 set 方法就可以了。除此之外，我們也可以不采用 struts2 提供的值棧方式得到參數(shù)值，而是使用非常熟悉的 request. getParameter() 方法來獲取參數(shù)。至于實(shí)際怎么使用，由各位自己決定，不知道我這樣說，大家能不能明白？ 大象根據(jù)實(shí)際使用情況，發(fā)現(xiàn)動(dòng)態(tài)參數(shù)的傳遞在 struts2.1.6 存在 BUG ，如果需要使用這個(gè)功能，請將 struts2 升級到 2.1.8.1 版。 大象根據(jù)實(shí)際應(yīng)用，建議大家統(tǒng)一在類名上面定義 Results 設(shè)置，這樣做有利于開發(fā)與維護(hù)；不建議單獨(dú)對方法使用 @Action 注解來重新定義它的訪問地址與返回結(jié)果，因?yàn)檫@樣做有些破壞統(tǒng)一性，不過可以根據(jù)實(shí)際情況進(jìn)行處理，但不要過多的使用。 struts.xml 整個(gè) struts.xml 的配置文件就這么多，當(dāng)然你自己還可以擴(kuò)展，因?yàn)椴捎昧俗⒔?，所以以前的那些配置就再也看不到了。在這個(gè)文件中， package 是繼承 convention-default ，而沒有繼承 struts-default ，為什么呢？查看 convention 的 struts-plugin.xml 文件，我們可以發(fā)現(xiàn) convention-default 繼承了 struts-default ，所以這樣寫是沒錯(cuò)的。另外的幾個(gè) constant 配置就是對 convention 的常量設(shè)置，請看注釋。 關(guān)于 paramsPrepareParamsStack 攔截器棧，我準(zhǔn)備在第五篇，對基礎(chǔ)框架進(jìn)行擴(kuò)展的時(shí)候再詳細(xì)的說明。大家如果等不急想學(xué)習(xí)下，可以在網(wǎng)上查找這方面的資料先看看。 web 大象是這樣想的，如果一次講的太多太復(fù)雜不利于理解和吸收，所以對于 web 層，大家從前面也看到了，代碼很簡單，因?yàn)楸酒饕侵v convention 插件的知識，然后實(shí)現(xiàn)一部分功能用于演示它的效果。下面貼上 web 和 WebRoot 目錄結(jié)構(gòu)、 UserAction 的代碼，以及 jsp 代碼。 請注意 web 包下面的層次結(jié)構(gòu)，這與你的請求路徑相關(guān)。 content 文件夾是插件默認(rèn)指定的名字，你可以修改為別的名字。同樣請注意在這個(gè)目錄下面的文件與子文件夾的定義方式是和 web 層相同的。如果還沒有理解，請?jiān)倏聪挛覍?/span>convention 插件的說明。 在 web.xml 文件中，設(shè)置了一個(gè) < welcome-file-list > 標(biāo)簽，定義了一個(gè) index.jsp ，這文件里就一句代碼 <% response.sendRedirect( "hello.action" ); %> 它會(huì)去執(zhí)行 HelloAction 的 execute() 方法，這方法里面什么邏輯都沒有，直接返回結(jié)果頁面 hello.jsp ${ctx} 是一個(gè) EL 表達(dá)式，設(shè)置的是當(dāng)前項(xiàng)目名稱。我在文件開頭加了一個(gè)靜態(tài)包含， <%@ include file = "/common/taglibs.jsp" %> 不管是 user.action 還是 role.action ，它們默認(rèn)的執(zhí)行方法都是 execute() ，點(diǎn)擊這兩個(gè)鏈接，返回指定的結(jié)果頁面。 在 user.jsp 里面，用來循環(huán)的 list ，是根據(jù) getList() 方法獲取的， struts2 會(huì)自動(dòng)的分析出屬性名。想一下， list 的 get 方法是不是就是 getList() 呢？我之前說過， get() 是獲得值， set() 是設(shè)置值 。在這里我只是要在列表頁面上得到 list 集合，沒有其它的需求，所以不用像這樣定義 private List list ，再然后給它加上 set() 、 get() 方法，因?yàn)橐玫?/span>list 集合，所以還要在 execute() 方法里面寫上 list = userManager .getUsers() ，這樣做有必要么？我一直都在遵循優(yōu)雅、高效、簡潔的代碼風(fēng)格，并且一直都在朝這方面努力，也提倡大家這樣做。編程是門藝術(shù)，而不是一種工作，不要把它當(dāng)工作看，只想著完成任務(wù)，拼命的堆代碼。這樣做很難有提高。應(yīng)該換一種心態(tài)去對待它，用藝術(shù)的眼光來重新審視你的代碼，你會(huì)發(fā)現(xiàn)這很有樂趣，也會(huì)學(xué)到很多。自己的一點(diǎn)淺薄之見，讓各位見笑了。 這部分的內(nèi)容就說到這里，下一篇將對 paramsPrepareParamsStack 攔截器棧進(jìn)行詳細(xì)說明，另外再對框架進(jìn)行一下擴(kuò)展，封裝 CRUD 功能，只要沒有特殊的業(yè)務(wù)邏輯，在你的實(shí)際 Action 中，再不會(huì)看到增刪改查這些基本功能。
本站僅提供存儲(chǔ)服務(wù)，所有內(nèi)容均由用戶發(fā)布，如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請
點(diǎn)擊舉報(bào) 。
