Struts2第四天，正如預(yù)期Struts2的內(nèi)容還沒(méi)有講完，還需要再加一天課。按照正常的授課方式，Struts2在四天內(nèi)是可以講完的，但這可能是老張最后一次講Struts2，所以他要講得細(xì)致些。
今天的重點(diǎn)內(nèi)容是Struts2的表單錯(cuò)誤信息排版、Struts2中的FreeMark、和Struts2中的UI標(biāo)簽。老張計(jì)的比較細(xì)致，我做總結(jié)就不做的那么細(xì)致了。
一、Struts2的表單錯(cuò)誤信息排版
Struts2的表單錯(cuò)誤信息排版是一個(gè)比較常見的問(wèn)題，但網(wǎng)給所見到的解決方案似乎并不正統(tǒng)。老張給出了他的解決方法。
通過(guò)之前的學(xué)習(xí)，我們知道Struts2中的大部分?jǐn)?shù)據(jù)交互操作是由ValueStack來(lái)完成的。錯(cuò)誤信息也是如此。我們?cè)诤笈_(tái)使用配置文件校驗(yàn)或硬編碼校驗(yàn)，Struts2將錯(cuò)誤信息存放在類型為Map的fieldErrors對(duì)象中。
我們可以在頁(yè)面表單字段的后邊添加此錯(cuò)誤信息，比如在user.name表單字段后邊添加<s:property value="fieldErrors['user.name'][0]"/>，這樣錯(cuò)誤信息可以顯示在對(duì)應(yīng)的字段后邊。這是針對(duì)我們使用非struts2的ui標(biāo)簽時(shí)(使用提html的ui標(biāo)簽)。但這里有一個(gè)問(wèn)題，如果我的表單字段特別的多，難道我要手動(dòng)為每個(gè)字段添加一個(gè)這樣的錯(cuò)誤信息，這多少有些麻煩，而且以后字段有什么變化還需要行動(dòng)更改...。
Struts2在各方面都做的非常細(xì)致和人性化，Struts2的UI標(biāo)簽等主要是使用FreeMark來(lái)實(shí)現(xiàn)的。Struts2使用FreeMar來(lái)實(shí)現(xiàn)模板和主題，那么我們回顯表單數(shù)據(jù)和錯(cuò)誤信息也可以使用FreeMark來(lái)實(shí)現(xiàn)。此時(shí)我們的表單需要使用struts-tags提供的標(biāo)簽來(lái)定義，然后我們修改它的ftl模板文件。
下面我們看看一下應(yīng)該如何修改ftl模板文件，我們以UI標(biāo)簽<s:textarea>為例。Struts2的模板文件存在哪？在Struts2的核心包中的template.xhtml中，textarea.ftl文件內(nèi)容：
| <#include "/${parameters.templateDir}/${parameters.theme}/controlheader.ftl" /> <#include "/${parameters.templateDir}/simple/textarea.ftl" /> <#include "/${parameters.templateDir}/xhtml/controlfooter.ftl" /> |
我們只需修改 controlheader.ftl和controlfooter.ftl即可，難道我們需要修改Struts2核心包中的內(nèi)容？當(dāng)然不用，這一點(diǎn)Struts2已經(jīng)為我們考慮到了。我們將這兩個(gè)文件解壓縮并放到WebRoot目錄下的”template/xhtml”目錄，必須是xhtml目錄?？?span lang="EN-US">default.properties文件中的這斷配置：
| ### Standard UI theme ### Change this to reflect which path should be used for JSP control tag templates by default struts.ui.theme=xhtml struts.ui.templateDir=template #sets the default template type. Either ftl, vm, or jsp struts.ui.templateSuffix=ftl |
Struts2會(huì)先到我們的WebRoot目錄搜索相關(guān)ftl文件，如果沒(méi)有才到自己的包中找。
我們的目標(biāo)，要使用Struts2的UI標(biāo)簽并將錯(cuò)誤信息顯示在標(biāo)簽的旁邊。所以我們修改這兩個(gè)文件的內(nèi)容為：
controlheader.ftl
| <#-- Only show message if errors are available. This will be done if ActionSupport is used. --> <#assign hasFieldErrors = parameters.name?? && fieldErrors?? && fieldErrors[parameters.name]??/> <#if parameters.labelposition?default("") == 'top'> <td align="left" valign="top" colspan="2"><#rt/> <#else> <td class="tdLabel"><#rt/> </#if> <#if parameters.label??> <label <#t/> <#if parameters.id??> for="${parameters.id?html}" <#t/> </#if> <#if hasFieldErrors> class="errorLabel"<#t/> <#else> class="label"<#t/> </#if> ><#t/> <#if parameters.required?default(false) && parameters.requiredposition?default("right") != 'right'> <span class="required">${stack.findValue("getText('requiredmark')")}</span><#t/> </#if> ${parameters.label?html}<#t/> <#if parameters.required?default(false) && parameters.requiredposition?default("right") == 'right'> <span class="required"><@s.text name="requiredmark"></@s.text></span><#t/> </#if> ${parameters.labelseparator?default(":")?html}<#t/> <#include "/${parameters.templateDir}/xhtml/tooltip.ftl" /> </label><#t/> </#if> </td><#lt/> <#-- add the extra row --> <#if parameters.labelposition?default("") == 'top'> </tr> <tr> </#if> |
controlfooter.ftl
| ${parameters.after?if_exists}<#t/> </td><#lt/> <#assign hasFieldErrors = parameters.name?? && fieldErrors?? && fieldErrors[parameters.name]??/> <#if hasFieldErrors> <td ><#rt/> <#list fieldErrors[parameters.name] as error> <span class="errorMessage">${error?html}</span><#t/> </#list> </td><#lt/> </#if> <#-- if the label position is top, then give the label it's own row in the table --> <tr> </tr> |
至于為什么這么修改，一看便知，我就不多做解釋了。
二、Struts2如何使用Freemarker
Struts2是如何使用Freemarker的？在struts2的核心包中有一個(gè)default.properties配置文件，Struts2的默認(rèn)配置都在這個(gè)文件中。有一些配置是開啟的有一些配置是關(guān)閉的。我們要想打開被關(guān)閉的配置可以在struts.xml中，添加<constant name="配置項(xiàng)名" value="配置項(xiàng)值"></constant>元素。
default.properties中有一個(gè)”struts.freemarker.manager.classname=org.apache.struts2.views.freemarker.FreemarkerManager“配置，Struts2是通過(guò)FreemarkerManager類來(lái)實(shí)現(xiàn)對(duì)Freemarker的操作的。
通過(guò)查看源代碼，我們知道通過(guò)調(diào)用FreemarkerManager類的buildTemplateModel方法生成一個(gè)model對(duì)象，然后將這個(gè)對(duì)象放在ValueStack中提供給Freemarker的引擎使用。model中都包含發(fā)哪些數(shù)據(jù)？Freemark的模板信息自然不用說(shuō)，它還包含Request、Application、Response等這些在WEB應(yīng)用中常用到的對(duì)象。具體我就不詳細(xì)列出了，大家可以查看源代碼。我們?cè)谏线厓蓚€(gè)模板文件中使用到的 parameters.name也是存儲(chǔ)在model中的。
在此特別提出一個(gè)被叫做UIBean的類型，UIBean就是對(duì)應(yīng)Struts2的UI標(biāo)簽的對(duì)象實(shí)體。比如標(biāo)簽有name、theme、id等數(shù)據(jù)，這些都會(huì)被封裝到UIBean中。Freemarker也正是使用這個(gè)東東給我們生成了相應(yīng)該的頁(yè)面文件。
三、Struts2中的UI標(biāo)簽
關(guān)于各UI標(biāo)簽的詳細(xì)使用方式，在此就不做總結(jié)了。
在實(shí)際開發(fā)中有一個(gè)重要的問(wèn)題需要我們解決，比如有一個(gè)選擇個(gè)人喜好的表單。我們需要通過(guò)一個(gè)Action的方法(likesUI)將喜好列表提供給頁(yè)面，可以讓用戶選擇。但在應(yīng)用提交選擇進(jìn)行表單校驗(yàn)時(shí)，用戶提交的數(shù)據(jù)不合法，我們需要重新返回到用戶選擇的界面。此時(shí)，我們需要調(diào)用 likesUI，獲取列表將數(shù)據(jù)提供給用戶選擇的界面。
我們可以在Action中添加”<result name="input" type="chain">likesUI</result>”，使其發(fā)生錯(cuò)誤時(shí)直接跳轉(zhuǎn)到likesUI，我們也需要在likesUI中添加一個(gè) 名稱為input的result標(biāo)簽，但這個(gè)標(biāo)簽的值不能為likesUI，否則會(huì)遞歸調(diào)用，直到緩存溢出。我們應(yīng)將它的值指定為likesUI.jsp頁(yè)面。但即使指定了這個(gè)頁(yè)面，Struts2的內(nèi)部實(shí)現(xiàn)方式也不會(huì)調(diào)用likesUI方法從，不會(huì)將數(shù)據(jù)傳遞給likesUI.jsp頁(yè)面，而它直接跳轉(zhuǎn)到likesUI.jsp頁(yè)面。
看來(lái)我們不能這么做，通過(guò)張老師對(duì)源代碼的詳細(xì)解析，我們只需要將likesUIAction中的likesUI的方法命名為input()，并只在likeUIAction中添加”<result name="input">/WEB-INF/pages/user/likesUI.jsp</result>“即可。為什么呢？
在表單校驗(yàn)發(fā)生錯(cuò)誤并使用 chain進(jìn)行跳轉(zhuǎn)時(shí)，會(huì)被chain攔截器給攔截了(ActionChainResult)。然后又會(huì)被攔截器validation給攔截了，它再進(jìn)行表單校驗(yàn)進(jìn)還是以前的數(shù)據(jù)，還是會(huì)出錯(cuò)然后它就直接跳轉(zhuǎn)到我們指定的頁(yè)面了。注意配置文件中的validation：
| <interceptor-ref name="validation"> <param name="excludeMethods">input,back,cancel,browse</param> </interceptor-ref> |
它忽略請(qǐng)求為 input,back,cancel,browse請(qǐng)求路徑。所以我們需要將我們的方法名定義為 input()。
我只是泛泛而結(jié)，如果想了解Struts2的更多細(xì)節(jié)請(qǐng)下載老張的視頻看吧！
最后送給大家一個(gè)Struts2開發(fā)用例參考模式圖：
1.用戶申請(qǐng)注冊(cè)，打開注冊(cè)頁(yè)面。
2.用戶提交注冊(cè)申請(qǐng)，表單校驗(yàn)錯(cuò)誤。
3.表單校驗(yàn)錯(cuò)誤不要跳轉(zhuǎn)到regUser.jsp頁(yè)面，而是應(yīng)該跳轉(zhuǎn)到RegUserUI這個(gè)Action方法。
4.用戶提交注冊(cè)申請(qǐng)，表單校驗(yàn)通過(guò)。
5.表單校驗(yàn)通過(guò)，調(diào)用RegUser這個(gè)Action方法進(jìn)行注冊(cè)。
6.注冊(cè)成功后，不要跳轉(zhuǎn)到list.jsp頁(yè)面。而是應(yīng)該調(diào)用ListAction這個(gè)Action方法。
7.ListAction獲取所有用戶信息后，跳轉(zhuǎn)到list.jsp。
一定要記得老張還有一天的Struts2的課程，下一次課程的重點(diǎn)內(nèi)容應(yīng)該是Struts2的文件上傳與下載，Struts2的防止表單重復(fù)提交，Struts2與Spring、AJAX整合，Struts2的插件。
接下來(lái)的課程內(nèi)容讓我等的好久啊——Android！雖然聽學(xué)習(xí)過(guò)的同學(xué)們說(shuō)十分簡(jiǎn)單，但我還是迫不及待的想Android的一睹真容。我想很多人都是這樣吧！那就關(guān)注我接下來(lái)6天課程的總結(jié)日志吧！