`

网上关于FreeMarker的三宗罪之争~~~

阅读更多
FreeMarker是Quake Wang推荐我使用的。刚学FreeMarker的时候,发现freemarker真的很棒!简单易用,功能强大。但是用它做了几个项目以后开始不爽了。

一宗罪:freemarker的变量必须有值,没有被赋值的变量就会抛出异常,那个黄黄的freemarker出错页面,真是让人看了太难过了。
freemarker的FAQ上面冠冕堂皇的说,未赋值的变量强制抛错可以杜绝很多潜在的错误,如缺失潜在的变量命名,或者其他变量错误。但是实际的效果是:带来的是非常大的编程麻烦,程序里面几乎所有可能出现空值的变量统统需要加上${xxx?if_exists},有些循环条件还需要写if判断,这样不但没有杜绝应该杜绝的错误,反而极大增加了编程的麻烦。

二宗罪:freemarker的map限定key必须是string,其他数据类型竟然无法操作!这一点就不讲了,JavaEye上面已经有人抱怨过了。连Webwork的开发人员Pat Lightboy都在抱怨这一点。


三宗罪:freemarker为了编程方便把不可序列化的东西往session里面放!
freemarker支持在页面里面直接操作Session,request等,例如${Session[...]},方便确实很方便,但是一旦需要做群集,就会报错。
今天是b051问起我这个问题,他在做Tomcat群集的时候发现freemarker报错,HttpSessionHashModel不可序列化。他修改该类源代码,让他实现序列化接口,仍然报错。我一看,HttpSessionHashModel包含的属性:
Java代码

   1. private HttpSession session;  
   2. private final ObjectWrapper wrapper;  
   3.  
   4. // These are required for lazy initializing session  
   5. private final FreemarkerServlet servlet;  
   6. private final HttpServletRequest request;  
   7. private final HttpServletResponse response; 

    private HttpSession session;
    private final ObjectWrapper wrapper;

    // These are required for lazy initializing session
    private final FreemarkerServlet servlet;
    private final HttpServletRequest request;
    private final HttpServletResponse response;



登时晕倒,这样的东西还往Session里面放?bad smell!
严重警告应用需要往群集上面发布应用的同学们,千万别用freemarker!

不过瑕不掩瑜,freemarker也是有优点的:

1、易学易用
我是看了一天文档就用得挺熟练了,freemarker文档写得太好了,例子丰富,照做一遍全都会了。

2、功能强大
比Velocity强大多了,还支持JSP Tag。不过最有意义的是macro功能,可以自定义常用的macro,实现页面常规操作的可复用性。

3、报错信息友好
很多应用服务器的JSP报错信息是无法定位到源代码行的。不过freemarker报错定位很准确,丝毫不差,而且信息丰富,一看就知道怎么回事(虽然那个黄黄的页面看起来让人难受)

三宗罪:freemarker为了编程方便把不可序列化的东西往session里面放!
freemarker支持在页面里面直接操作Session,request等,例如${Session[...]},方便确实很方便,但是一旦需要做群集,就会报错。
今天是b051问起我这个问题,他在做Tomcat群集的时候发现freemarker报错,HttpSessionHashModel不可序列化。他修改该类源代码,让他实现序列化接口,仍然报错。我一看,HttpSessionHashModel包含的属性:

Java代码

   1. private HttpSession session;  
   2. private final ObjectWrapper wrapper;  
   3.  
   4. // These are required for lazy initializing session  
   5. private final FreemarkerServlet servlet;  
   6. private final HttpServletRequest request;  
   7. private final HttpServletResponse response; 

    private HttpSession session;
    private final ObjectWrapper wrapper;

    // These are required for lazy initializing session
    private final FreemarkerServlet servlet;
    private final HttpServletRequest request;
    private final HttpServletResponse response;



登时晕倒,这样的东西还往Session里面放?bad smell!
严重警告应用需要往群集上面发布应用的同学们,千万别用freemarker!



前面两个问题我有同感,但是还能接受...
对于第三个问题,不同意Robbin具有强烈煽动性的:千万别用freemarker!
关键在怎么用~~

只有在使用FreemarkerServlet的时候, HttpSessionHashModel才会被创建和使用..具体可参见 FreemarkerServlet.java 的 createModel() 方法...


我从来不用这个FreemarkerServlet,也就不会出现Robbin所说的第三个问题了..

我们在开发中用的是Springmvc, FreeMarker只在 springmvc 要 rend view的时候被调用(我们重写了FreeMarkerView), 而不是通过FreemarkerServlet:
Java代码

   1. Environment env = template.createProcessingEnvironment(model, writer);;  
   2. freemarkerConfigurer.includeTemplatesToEnv(env);;  
   3. env.process();; 

Environment env = template.createProcessingEnvironment(model, writer);;
freemarkerConfigurer.includeTemplatesToEnv(env);;
env.process();;


其中的model,writer完全在我们自己的控制之中,不可序列化的东西完全可以剔除.

并且, Springmvc 在 expose Session to view 的时候,是这样实现的:
Java代码

   1. if (this.exposeSessionAttributes); {  
   2.             HttpSession session = request.getSession(false);;  
   3.             if (session != null); {  
   4.                 for (Enumeration en = session.getAttributeNames();; en.hasMoreElements();;); {  
   5.                     String attribute = (String); en.nextElement();;  
   6.                     if (model.containsKey(attribute); && !this.allowSessionOverride); {  
   7.                         throw new ServletException("Cannot expose session attribute '" + attribute +  
   8.                             "' because of an existing model object of the same name");;  
   9.                     }  
  10.                     Object attributeValue = session.getAttribute(attribute);;  
  11.                     if (logger.isDebugEnabled();); {  
  12.                         logger.debug("Exposing session attribute '" + attribute +  
  13.                                 "' with value [" + attributeValue + "] to model");;  
  14.                     }  
  15.                     model.put(attribute, attributeValue);;  
  16.                 }  
  17.             }  
  18.         } 

if (this.exposeSessionAttributes); {
                        HttpSession session = request.getSession(false);;
                        if (session != null); {
                                for (Enumeration en = session.getAttributeNames();; en.hasMoreElements();;); {
                                        String attribute = (String); en.nextElement();;
                                        if (model.containsKey(attribute); && !this.allowSessionOverride); {
                                                throw new ServletException("Cannot expose session attribute '" + attribute +
                                                        "' because of an existing model object of the same name");;
                                        }
                                        Object attributeValue = session.getAttribute(attribute);;
                                        if (logger.isDebugEnabled();); {
                                                logger.debug("Exposing session attribute '" + attribute +
                                                                "' with value [" + attributeValue + "] to model");;
                                        }
                                        model.put(attribute, attributeValue);;
                                }
                        }
                }


干净利索!
在FreeMarker rend view 的时候, 它的 Model 中没有一点request,response,session的影子了..
在FreeMarker模版中,要拿到session中的值,只需要${key}就可以了,不必使用${Session[...]}.
一宗罪:freemarker的变量必须有值,没有被赋值的变量就会抛出异常,那个黄黄的freemarker出错页面,真是让人看了太难过了。
freemarker的FAQ上面冠冕堂皇的说,未赋值的变量强制抛错可以杜绝很多潜在的错误,如缺失潜在的变量命名,或者其他变量错误。但是实际的效果是:带来的是非常大的编程麻烦,程序里面几乎所有可能出现空值的变量统统需要加上${xxx?if_exists},有些循环条件还需要写if判断,这样不但没有杜绝应该杜绝的错误,反而极大增加了编程的麻烦。


偶倒认为这个是极好的特性,而且很赞同它对于null的处理,原因在FreeMarker的FAQ上已经解释得很清楚了。
在偶们的项目里,是应用不同的Error Handler在开发环境/测试环境/生产环境来解决的。
具体的可以参考:
http://freemarker.sourceforge.net/docs/pgui_config_errorhandling.html
在生产环境下,可以用它自带的TemplateExceptionHandler.IGNORE_HANDLER

再加上好用的if_exists, default这些exists built-in,处理各种null的情况真的是很方便:
${(bar.foo.value)?default("N/A")}

当然,对所有可能为空的值加上built-in确实是一件麻烦的事情,但是偶们所有的页面都是用form macro做的,所以就没有你的烦恼了,:)
robbin 写道

二宗罪:freemarker的map限定key必须是string,其他数据类型竟然无法操作!这一点就不讲了,JavaEye上面已经有人抱怨过了。连Webwork的开发人员Pat Lightboy都在抱怨这一点。


这个绝对是很烦恼的一件事情,其实这个问题是TemplateModel造成的,偶最不能理解的是为啥它需要弄一个TemplateModel来wrap 所有的Object,直接用原始对象不就好了么,还要弄个wrap/unwrap。据说它这样的做法是提高性能,但是偶无法理解......,有人可以解释一下么?
robbin 写道

三宗罪:freemarker为了编程方便把不可序列化的东西往session里面放!


不知道你在说啥,freemarker只是template language,和HTTP session有啥关系啊?


freemarker/velocity这些模本语言和JSP Tag比较起来,最大的优点是性能可以做得很好
而freemarker和velocity比较起来,最大的优点是它在活跃开发,可以不断地进步,webwork选择freemarker作为默认的template,很大原因在于此。 一宗罪,null值处理:

这个也的确让我烦叻一阵子,不过后来不仅习惯叻,而且还真的喜欢上这一点叻。我们的页面上有null值,大概有这样两种情况:

1、这个值本来就是可有可无的。比如表单域的value=""值。这种情况,可以用${foo?default("")}来写,并不十分复杂,而且可以让你狠方便地定义默认值,比如N/A什么的。

2、Action层处理有错,导致null值。这种情况下,FreeMarker就给程序调试提供的有力的保障,也是FreeMarker对 null值如此敏感的初衷。从我学FreeMarker开始,我就强烈地感受到FreeMarker在试图把自己做成模板语言中的强类型语言。

总之,这个null其实不是什么大问题啦,并没有什么不方便。


二宗罪:Map的key必须是String

这个我还真的没遇到过。我写叻段小程序简单地试验叻下,用list遍历map.keySet(),然后用map.get(key)这样的方法查询,是可以的。直接用map[]这样的操作的确是不行。我实际使用中在前台用到Map的情况不多,以前用velocity的时候也没觉得map有多好用,大部分情况我是用n个相同长度的list或数组解决的,感觉比map方便。


三宗罪:freemarker为了编程方便把不可序列化的东西往session里面放!

这个就不说啦,跟freemarker无关。抛开这个不谈,客观地说,WebWork对FreeMarker Result的封装还是非常不错的。


FreeMarker自身的优点的确非常突出,易学,我只用叻3个小时看叻遍文档就基本掌握叻,就可以扔掉 velocity叻,哈哈。而且FreeMarker自己的builtin也的确有趣,虽然大部分我都不用,还是要在 action层自己封装个方法调用,不过常用的比如?html,?date这样的还是狠方便的。

我想说说FreeMarker跟JSP Tag的比较,前面看到Robbin说要回归JSP Tag,我真是痛心疾首啊!要拿FreeMarker去攻击JSP Tag,我都不需要列举JSP Tag/JSTL的缺点,只要把FreeMarker的Macro拿出来往那一亮就OK叻。用老罗的话说,“那简直是太方便叻!太方便叻!!”

我刚才就在重构一个项目的common.ftl,将公共的部分提取出来,细力度的重构。在Code级别我们可以重构,可以代码only once。现在在FreeMarker的帮助下,页面级也可以这样叻!JSP Tag、Velocity不是不能这样,而是都太麻烦,而且功能不强,用叻不仅不省工作量,反而还更烦。而只有FreeMarker,才能让页面达到这样的重构高度。

我们这边的策划总是有新点子,页面也总是改,我写代码是基于敏捷原则,现在页面也是敏捷的,可以说是真正做到的拥抱变化,感觉非常爽。 关于第三宗罪,我今天仔细看了一下代码,确有其事。

在Freemarker自带的FreemarkerServlet的createModel方法中有这样一段代码:
Java代码

   1. // Create hash model wrapper for session  
   2. HttpSessionHashModel sessionModel;  
   3. HttpSession session = request.getSession(false);  
   4. if(session != null) {  
   5.     sessionModel = (HttpSessionHashModel) session.getAttribute(ATTR_SESSION_MODEL);  
   6.     if (sessionModel == null) {  
   7.         sessionModel = new HttpSessionHashModel(session, wrapper);  
   8.         session.setAttribute(ATTR_SESSION_MODEL, sessionModel);  
   9.         initializeSession(request, response);  
  10.     }  
  11. }  
  12. else {  
  13.     sessionModel = new HttpSessionHashModel(this, request, response, wrapper);  
  14. }  
  15. params.putUnlistedModel(KEY_SESSION, sessionModel); 

// Create hash model wrapper for session
HttpSessionHashModel sessionModel;
HttpSession session = request.getSession(false);
if(session != null) {
    sessionModel = (HttpSessionHashModel) session.getAttribute(ATTR_SESSION_MODEL);
    if (sessionModel == null) {
        sessionModel = new HttpSessionHashModel(session, wrapper);
        session.setAttribute(ATTR_SESSION_MODEL, sessionModel);
        initializeSession(request, response);
    }
}
else {
    sessionModel = new HttpSessionHashModel(this, request, response, wrapper);
}
params.putUnlistedModel(KEY_SESSION, sessionModel);


会每次把sessionModel放进HttpSession,不知道究竟什么用意。这里有一个问题是:当我们使用FreeMarker作为sitemesh的decorator的时候,必须使用FreeMarkerServlet,看sitemesh的扩展类:
Java代码

   1. public class FreemarkerDecoratorServlet extends FreemarkerServlet 

public class FreemarkerDecoratorServlet extends FreemarkerServlet



然后再看看webwork使用FreeMarker作为view的时候,

FreemarkerResult在createModel里面引用了 FreemarkerManager.getInstance().buildTemplateModel,而FreemarkerManager的 buildScopesHashModel里面:
TemplateHashModel sessionModel;
Java代码

   1. HttpSession session = request.getSession(false);  
   2. if (session != null) {  
   3.     model.put(KEY_SESSION_MODEL, new HttpSessionHashModel(session, wrapper));  
   4. } else {  
   5.     // no session means no attributes ???  
   6.     //            model.put(KEY_SESSION_MODEL, new SimpleHash());  
   7. } 

HttpSession session = request.getSession(false);
if (session != null) {
    model.put(KEY_SESSION_MODEL, new HttpSessionHashModel(session, wrapper));
} else {
    // no session means no attributes ???
    //            model.put(KEY_SESSION_MODEL, new SimpleHash());
}


这里每次需要sessionModel,就是直接new一个了事,并没有每次放进HttpSession下次再从HttpSession中取得。

因此使用freemarker作为webwork的view,是没有问题的。但是如果使用freemakrer作为 sitemesh的decorator的时候,还是有这个群集复制的问题。我想修改FreeMarkerServlet,改成这样:
Java代码

   1. HttpSessionHashModel sessionModel;  
   2. HttpSession session = request.getSession(false);  
   3. if(session != null) {  
   4.     sessionModel = new HttpSessionHashModel(session, request, response, wrapper);  
   5. }else {  
   6.     sessionModel = new HttpSessionHashModel(this, request, response, wrapper);  
   7. }  
   8. params.putUnlistedModel(KEY_SESSION, sessionModel);
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics