我們在開發(fā)的時候,往往對一些數(shù)據(jù)字典形式的數(shù)據(jù),想將它封裝成通用的模塊以便于使用,如果使用JSP做展示層,可以創(chuàng)建自定義標簽來實現(xiàn),現(xiàn)在換成FreeMarker視圖,我們一樣可以達到想要的目的。
實現(xiàn)FreeMarker指令其實很簡單,只要實現(xiàn)TemplateDirectiveModel接口,覆蓋里面的方法即可。
public void execute(Environment env, Map params, TemplateModel[] loopVars, TemplateDirectiveBody body) throws TemplateException, IOException
大象以select下拉框及顯示數(shù)據(jù)字典文本兩個自定義指令為例來進行說明。
在ssm3工程中按下圖創(chuàng)建freemarker package

本例只為了說明如何實現(xiàn),簡便起見,所以用了DictContext這個模擬數(shù)據(jù)字典類。

我模擬了性別和學歷的數(shù)據(jù),實際開發(fā)中,這些都是從數(shù)據(jù)庫取得,原理都差不多,這里主要是為了演示。xb01、xl01這個標識大家可以隨意定義只要保證唯一性就可以了,該類中還有兩個取數(shù)據(jù)的方法,請直接看源碼,這里就不再說明了。
接下來我們就可以來創(chuàng)建DictSelectDirective這個類。

上面這些參數(shù),都是從模板頁的自定義指令中獲取的,根據(jù)我們想創(chuàng)建的這個select FreeMarker指令,可以定義任何我們想要的東西。因為最終生成的就是一段select html代碼。
通過params.get()獲得的參數(shù)有類型要求,不同的值需要對其轉(zhuǎn)型到相應(yīng)類型。所以你不能將select的name類型轉(zhuǎn)為SimpleNumber。另外還有一點要注意,FreeMarker對值的類型很敏感,什么意思呢?比如params.get("value");這是獲得數(shù)據(jù)庫中對應(yīng)的字典值,對于這個值請一定要統(tǒng)一定義數(shù)據(jù)類型,比如都為整型或是字符串型,否則就會轉(zhuǎn)換失敗。所以大象在這里為了演示用到了TemplateModel接口,它是所有模板數(shù)據(jù)類型的超類。雖然這樣做可以避免類型轉(zhuǎn)換的錯誤,但同時會增加類型解析的代碼量,所以完全沒有必要,因為只要前期規(guī)劃設(shè)計好,這類問題完全可以避免。
DictSelectDirective里面其它代碼就是拼裝select,這個請直接看源碼,另外代碼中用到了一個第三方開源工具commons-lang,所以pom中需要加入這個依賴。

注意紅色框部分的代碼,我在之前就說過,如果類型不確定,使用TemplateModel,就需要做類型解析的分析。而DictContext.getInstance().getDict(type.getAsString())是獲得對應(yīng)類型的數(shù)據(jù)字典,for循環(huán)將數(shù)據(jù)拼裝到option中,如果是編輯表單,value有值,則會將對應(yīng)的option選中。
DictDisplayDirective實現(xiàn)更簡單,方法DictSelectDirective一樣,這里就不再贅述。
想讓FreeMarker的指令發(fā)揮作用,我們還有一些工作要做。下面這些源碼中都有,可以直接查看代碼。
1、在servlet-context.xml里面加入紅色方框中的內(nèi)容

2、在數(shù)據(jù)庫的role表中,增加sex和edu兩個字段
3、在Role.java中添加sex與edu屬性及getter,setter方法
4、修改RoleMapper.xml中insert和update語句,增加sex和edu的保存與更新。<sql id="base_column">也要增加sex和edu字段。
5、修改role_edit.html,增加性別與學歷的FreeMarker指令。

6、修改role_list.html,增加性別與學歷顯示。

7、role_view.html也作相應(yīng)修改,略。
整個FreeMarker自定義指令(標簽)的實現(xiàn)就這些,非常簡單,大家還可以自行擴展,比如根據(jù)自身的業(yè)務(wù)需要,創(chuàng)建checkbox、radio等指令,或者是多個value值的文本顯示,這些原理都是一樣的。
源碼下載:ssm3_freemarker
本文為菠蘿大象原創(chuàng),如要轉(zhuǎn)載請注明出處。http://www.aygfsteel.com/bolo