FreeMarker自定义TemplateDirectiveModel

在采用FreeMarker做前台视图模板的情况下，我们可以通过<#include>标签和自定义宏来解决很多重复性工作。

一个简单的FreeMarker宏：

[html]  view plain  copy

1. <#macro sayHello name="">  
2.     hello ${name}  
3. </#macro>  

然后通过如下的形式调用：

[html]  view plain  copy

1. <@sayHello name="shannon" />  

不过这种在模板页中定义的宏能力有限。【1】假设，我们很多页面都要输出一个热门排行框，而排行数据需要从controller层动态获取，我们可以用这种宏来完成所有的展示工作，但前提是相应的controller和接口中层需要预先将这些排行数据放到model中去，因此对于后端来说这也是一个重复性的工作。那么有没有一种方式可以让后端也脱离这种重复工作呢？答案是肯定的，这也是写这篇博客的目的。

在一个偶然的机会发现jeecms项目中用到了这种方式，于是借鉴了一番。

FreeMarker不仅可以在前端的模板页中定义宏，还可以通过扩展其接口在后端实现宏，这有什么好处呢？这种方式就好比让你的模板页具备了从前端再次回到后端的能力。这样我们就能很好的解决【1】处的假设，我们无需在各个controller的各个接口中去重复的向model中添加所需的排行数据，而是当FreeMarker渲染模板页时遇到相应的宏它可以回到后端去调用相应的方法取到所需的数据。例子如下：

[java]  view plain  copy

1. import freemarker.core.Environment;  
2. import freemarker.template.ObjectWrapper;  
3. import freemarker.template.TemplateDirectiveModel;  
4.   
5. /** 
6.  * FreeMarker自定义宏 
7.  * 获取App下载排行列表 
8.  * 参数包括 length（列表长度） mtypeCode(主类型代码) typeCode（小类型代码） rankMode（排行模式1、2、3） 
9.  * @author shannon 
10.  * 
11.  */  
12. public class FMAppRankDirective implements TemplateDirectiveModel {  
13.   
14.     @Resource(name = "appRankService")  
15.     private AppRankService appRankService;  
16.       
17.       
18.     @SuppressWarnings("unchecked")  
19.     @Override  
20.     public void execute(Environment env, Map params, TemplateModel[] loopVars,  
21.             TemplateDirectiveBody body) throws TemplateException, IOException {  
22.         //DirectiveUtils是借用jeecms项目中的工具类，主要是因为它集成了一些异常处理功能，  
23.         //其实完全可以不用它，params是个Map，自己通过key取值就可以了，做一下空值判断  
24.         Integer length = DirectiveUtils.getInt("length", params);  
25.         Integer mtypeCode = DirectiveUtils.getInt("mtypeCode", params);  
26.         Integer typeCode = DirectiveUtils.getInt("typeCode", params);  
27.         Integer rankMode = DirectiveUtils.getInt("rankMode", params);  
28.         ArrayList<App> rankList = appRankService.getRankList(length, mtypeCode, typeCode, rankMode);  
29.           
30.         env.setVariable("appRankList", ObjectWrapper.DEFAULT_WRAPPER.wrap(rankList));  
31.         if (body != null) {  
32.             body.render(env.getOut());  
33.         }  
34.     }  
35. }  

通过实现FreeMarker的TemplateDirectiveModel就在后端实现了一个自定义的宏，这个宏的功能很简单，只是根据给定的参数将排行数据“appRankList”放到model中去，然后模板页中就可以使用这个变量了。

FreeMarker的配置参数中需要将这个宏加入进去。

[html]  view plain  copy

1. <bean id="appRankDirective" class="com.shannon.example.rank.util.FMAppRankDirective" />  
2. <bean id="freemarkerConfigurer" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">  
3.     ……其他配置略……  
4.     <property name="freemarkerVariables">  
5.         <map>  
6.             ……其他配置略……  
7.             <entry key="appRankDirective" value-ref="appRankDirective"/>  
8.         </map>  
9.     </property>  
10. </bean>  

在模板页中使用：

[html]  view plain  copy

1. <#-- 应用下载排行框，title为该框的标题，length为排行列表长度，mtypeCode为主类型代码，typeCode为小类型代码，rankMode为排行方式   
2. 1为总下载量，2为月下载量，3为昨日增长下载量  
3. -->  
4. <#macro appRankBox title="" length=10 mtypeCode=1 typeCode=-1 rankMode=1>  
5.       <@appRankDirective length=length mtypeCode=mtypeCode typeCode=typeCode rankMode=rankMode />  
6.         <h3 class="box-title">${title}</h3>  
7.     <div class="box">  
8.       <ul class="row-list">  
9.         <#list appRankList as item>  
10.         ……详细输出内容略……  
11.         </#list>  
12.         </ul>  
13.     </div>  
14. </#macro>  

这里我在模板页中又定义了一个宏，负责内容及样式的输出，因为模板页中的宏比较直观，让后端的宏只负责拿数据。其他页面直接使用“appRankBox”就可以了，然后由它来调用后端的“appRankDirective”宏来拿数据。

这样，controller就从重复工作中脱身了。

在列举个比较简单的例子

1  自定义标签需要实现TemplateDirectiveModel这个接口中的execute方法  实例代码如下

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

public class UserListDirective implements TemplateDirectiveModel{            @Autowired      private UserDAO  userDao;      @Override      public void execute(Environment env, Map params, TemplateModel[] loopVars,              TemplateDirectiveBody body)                        throws TemplateException, IOException {          String name = params.get( "name" ).toString();          List<User> userlist = userDao.findByProperty( "name" , name);            env.setVariable( "userList" , getBeansWrapper().wrap(userlist));          body.render(env.getOut());      }            public static BeansWrapper getBeansWrapper(){          BeansWrapper beansWrapper =                           new BeansWrapperBuilder(Configuration.VERSION_2_3_21).build();          return beansWrapper;      } }

2 配置 UserListDirective 到spring  bean xml中

?

1	< bean id = "userListDirective" class = "com.action.directive.UserListDirective" ></ bean >

3 将spring bean 设置到freemarkerConfig全局变量中去。 

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23

< bean id = "freemarkerConfig2"          class = "org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer" >          < property name = "templateLoaderPath" value = "/" />          < property name = "freemarkerVariables" >              < map >                  < entry key="<span></ span >userListDirective< span ></ span >" value="userListTag" />              </ map >          </ property >          < property name = "freemarkerSettings" >              < props >                  < prop key = "template_update_delay" >0</ prop >                  < prop key = "defaultEncoding" >UTF-8</ prop >                  < prop key = "url_escaping_charset" >UTF-8</ prop >                  < prop key = "locale" >zh_CN</ prop >                  < prop key = "boolean_format" >true,false</ prop >                  < prop key = "datetime_format" >yyyy-MM-dd HH:mm:ss</ prop >                  < prop key = "date_format" >yyyy-MM-dd</ prop >                  < prop key = "time_format" >HH:mm:ss</ prop >                  < prop key = "number_format" >0.######</ prop >                  < prop key = "whitespace_stripping" >true</ prop >              </ props >          </ property >      </ bean >

4 ftl文件中的访问方式

?

1 2 3 4 5 6 7

<@userListTag name="zhangsan">      <#if userList?? && userList?size gt 0>          <#list userList as user>              < a href = "" >${user.name}</ a >          </#list>      </#if> </@userListTag>

5 freemarker 遍历 map

第一种方式（2.3.21版本之前好像可以用）

?

1 2 3 4 5

<#list testMap?keys as testKey>       < option value= "${testKey}" >           ${testMap.get(testKey)}       </option>  </#list>

第二种方式

?

1 2 3 4 5

<#list testMap.keySet() as testKey>       < option value= "${testKey}" >           ${testMap.get(testKey)}       </option>  </#list>