JFinal自定义FreeMarker标签

为什么采用freemarker?

1、模板技术，不依附于语言和框架，前端和后端解耦，便于分工协作，更好的协同。

2、页面相应速度快

3、前端非常的灵活，采用自定义标签可以在不更改后端的基础上很容易的构造前端逻辑，可适应多变的网站。

为什么要自定义标签？

答案在第一个问题的第三点，我们需要一个前端灵活的架构，在不更改后端逻辑的基础上，很容易的改造前端逻辑。

在SSH的架构中，自定义标签已经可以方便的实现（struts2的标签也是基于freemarker的自定义标签），但是用起来还是不够爽，需要大量的配置，繁琐的依赖注入等。用了jfinal以后，发现自定义freemarker标签在该框架中用起来极爽，寥寥几个类，几行代码就能将自定义标签应用起来。废话不多说了，上代码吧。

第一步：实现标签类

 /**
  * 分类标签<br>
  * 参数：{parent_id:上级主键}
  * 返回值：{list:分类列表}
  *
  * @author yongtree
  */
 public class CategoryListDirective implements TemplateDirectiveModel {

     public void execute(Environment env, Map params, TemplateModel[] loopVars,
             TemplateDirectiveBody body) throws TemplateException, IOException {

         List<Category> list = new ArrayList<Category>();
         if (params.containsKey("parent_id") && params.get("parent_id") != null) {
             list = Category.getCategoryList(params.get("parent_id").toString(),
                     Category.STATUS_ENABLED);
         } else {
             list = Category.getFirstCategoryList(Category.STATUS_ENABLED);
         }

         env.setVariable("list", DEFAULT_WRAPPER.wrap(list));
         body.render(env.getOut());
     }

 }

第二步：action中引入

 setAttr("_category_list", new CategoryListDirective());

第三步：页面是使用

 <@_category_list parent_id="2">
     <#list list as c>
         <a href="/category/${c.id}">${c.name}</a>
     </#list>
 </@_category_list>

我们使用自定义标签的目的是灵活，就是要将action中要做到事情，能直接通过标签在页面上使用。而上面的第二步，需要在action中set，使其action的逻辑不灵活。自定义标签应该能脱离开具体的action，能在更多的模块中用到，不受action的限制。所以第二步需要稍加改造，这是我们可以采用jfinal的全局拦截器，将这些标签初始化内存中，在所有的action中都很容易的注入，当然你可以根据拦截器的相关配置和逻辑，将自定义标签指定到相应的action中。上代码吧

 /**
  * 自定义标签拦截器
  * @author yongtree
  */
 public class DirectiveInterceptor implements Interceptor {

     public static CategoryListDirective cld = new CategoryListDirective();

     public void intercept(ActionInvocation ai) {
         Controller c = ai.getController();
         c.setAttr(LABEL_CATEGORY_LIST, cld);
                 ai.invoke();
 }

     public static final String LABEL_CATEGORY_LIST = "_category_list";

 }

配置到Config中

 /**
      * 配置全局拦截器
      */
     public void configInterceptor(Interceptors me) {
         me.add(new AuthInterceptor());
         me.add(new DirectiveInterceptor());
     }

超爽吧，简单几步，就搞定了自定义标签，这样你就可以把主要的查询和业务封装到标签里。在不改变业务逻辑和结构的基础上，前端逻辑和展示需要调整，以后就只是前端开发人员或者网站美工的工作了，再辅以freemarker的macro宏定义，再前段封装出更加方便使用的界面，那就更加的灵活和高校。所以在以内容为主的网站上，极力推荐采用这种方式来设计你的前端。