网上关于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);