网上关于FreeMarker的三宗罪之争~~~
FreeMarker是QuakeWang推荐我使用的。刚学FreeMarker的时候，发现freemarker真的很棒！简单易用，功能强大。但是用它做了几个项目以后开始不爽了。
一宗罪：freemarker的变量必须有值，没有被赋值的变量就会抛出异常，那个黄黄的freemarker出错页面，真是让人看了太难过了。
freemarker的FAQ上面冠冕堂皇的说，未赋值的变量强制抛错可以杜绝很多潜在的错误，如缺失潜在的变量命名，或者其他变量错误。但是实际的效果是：带来的是非常大的编程麻烦，程序里面几乎所有可能出现空值的变量统统需要加上${xxx?if_exists}，有些循环条件还需要写if判断，这样不但没有杜绝应该杜绝的错误，反而极大增加了编程的麻烦。
二宗罪：freemarker的map限定key必须是string，其他数据类型竟然无法操作！这一点就不讲了，JavaEye上面已经有人抱怨过了。连Webwork的开发人员PatLightboy都在抱怨这一点。
三宗罪：freemarker为了编程方便把不可序列化的东西往session里面放！
freemarker支持在页面里面直接操作Session，request等，例如${Session[...]}，方便确实很方便，但是一旦需要做群集，就会报错。
今天是b051问起我这个问题，他在做Tomcat群集的时候发现freemarker报错，HttpSessionHashModel不可序列化。他修改该类源代码，让他实现序列化接口，仍然报错。我一看，HttpSessionHashModel包含的属性：
Java代码
1.privateHttpSessionsession;
2.privatefinalObjectWrapperwrapper;
3.
4.//Thesearerequiredforlazyinitializingsession
5.privatefinalFreemarkerServletservlet;
6.privatefinalHttpServletRequestrequest;
7.privatefinalHttpServletResponseresponse;
privateHttpSessionsession;
privatefinalObjectWrapperwrapper;
//Thesearerequiredforlazyinitializingsession
privatefinalFreemarkerServletservlet;
privatefinalHttpServletRequestrequest;
privatefinalHttpServletResponseresponse;
登时晕倒，这样的东西还往Session里面放？badsmell！
严重警告应用需要往群集上面发布应用的同学们，千万别用freemarker！
不过瑕不掩瑜，freemarker也是有优点的：
1、易学易用
我是看了一天文档就用得挺熟练了，freemarker文档写得太好了，例子丰富，照做一遍全都会了。
2、功能强大
比Velocity强大多了，还支持JSPTag。不过最有意义的是macro功能，可以自定义常用的macro，实现页面常规操作的可复用性。
3、报错信息友好
很多应用服务器的JSP报错信息是无法定位到源代码行的。不过freemarker报错定位很准确，丝毫不差，而且信息丰富，一看就知道怎么回事(虽然那个黄黄的页面看起来让人难受)
三宗罪：freemarker为了编程方便把不可序列化的东西往session里面放！
freemarker支持在页面里面直接操作Session，request等，例如${Session[...]}，方便确实很方便，但是一旦需要做群集，就会报错。
今天是b051问起我这个问题，他在做Tomcat群集的时候发现freemarker报错，HttpSessionHashModel不可序列化。他修改该类源代码，让他实现序列化接口，仍然报错。我一看，HttpSessionHashModel包含的属性：
Java代码
1.privateHttpSessionsession;
2.privatefinalObjectWrapperwrapper;
3.
4.//Thesearerequiredforlazyinitializingsession
5.privatefinalFreemarkerServletservlet;
6.privatefinalHttpServletRequestrequest;
7.privatefinalHttpServletResponseresponse;
privateHttpSessionsession;
privatefinalObjectWrapperwrapper;
//Thesearerequiredforlazyinitializingsession
privatefinalFreemarkerServletservlet;
privatefinalHttpServletRequestrequest;
privatefinalHttpServletResponseresponse;
登时晕倒，这样的东西还往Session里面放？badsmell！
严重警告应用需要往群集上面发布应用的同学们，千万别用freemarker！
前面两个问题我有同感,但是还能接受...
对于第三个问题,不同意Robbin具有强烈煽动性的:千万别用freemarker！
关键在怎么用~~
只有在使用FreemarkerServlet的时候,HttpSessionHashModel才会被创建和使用..具体可参见FreemarkerServlet.java的createModel()方法...
我从来不用这个FreemarkerServlet,也就不会出现Robbin所说的第三个问题了..
我们在开发中用的是Springmvc,FreeMarker只在springmvc要rendview的时候被调用(我们重写了FreeMarkerView),而不是通过FreemarkerServlet:
Java代码
1.Environmentenv=template.createProcessingEnvironment(model,writer);;
2.freemarkerConfigurer.includeTemplatesToEnv(env);;
3.env.process();;
Environmentenv=template.createProcessingEnvironment(model,writer);;
freemarkerConfigurer.includeTemplatesToEnv(env);;
env.process();;
其中的model,writer完全在我们自己的控制之中,不可序列化的东西完全可以剔除.
并且,Springmvc在exposeSessiontoview的时候,是这样实现的:
Java代码
1.if(this.exposeSessionAttributes);{
2.HttpSessionsession=request.getSession(false);;
3.if(session!=null);{
4.for(Enumerationen=session.getAttributeNames();;en.hasMoreElements();;);{
5.Stringattribute=(String);en.nextElement();;
6.if(model.containsKey(attribute);&&!this.allowSessionOverride);{
7.thrownewServletException("Cannotexposesessionattribute'"+attribute+
8."'becauseofanexistingmodelobjectofthesamename");;
9.}
10.ObjectattributeValue=session.getAttribute(attribute);;
11.if(logger.isDebugEnabled(););{
12.logger.debug("Exposingsessionattribute'"+attribute+
13."'withvalue["+attributeValue+"]tomodel");;
14.}
15.model.put(attribute,attributeValue);;
16.}
17.}
18.}
if(this.exposeSessionAttributes);{
HttpSessionsession=request.getSession(false);;
if(session!=null);{
for(Enumerationen=session.getAttributeNames();;en.hasMoreElements();;);{
Stringattribute=(String);en.nextElement();;
if(model.containsKey(attribute);&&!this.allowSessionOverride);{
thrownewServletException("Cannotexposesessionattribute'"+attribute+
"'becauseofanexistingmodelobjectofthesamename");;
}
ObjectattributeValue=session.getAttribute(attribute);;
if(logger.isDebugEnabled(););{
logger.debug("Exposingsessionattribute'"+attribute+
"'withvalue["+attributeValue+"]tomodel");;
}
model.put(attribute,attributeValue);;
}
}
}
干净利索！
在FreeMarkerrendview的时候,它的Model中没有一点request,response,session的影子了..
在FreeMarker模版中,要拿到session中的值,只需要${key}就可以了,不必使用${Session[...]}.
一宗罪：freemarker的变量必须有值，没有被赋值的变量就会抛出异常，那个黄黄的freemarker出错页面，真是让人看了太难过了。
freemarker的FAQ上面冠冕堂皇的说，未赋值的变量强制抛错可以杜绝很多潜在的错误，如缺失潜在的变量命名，或者其他变量错误。但是实际的效果是：带来的是非常大的编程麻烦，程序里面几乎所有可能出现空值的变量统统需要加上${xxx?if_exists}，有些循环条件还需要写if判断，这样不但没有杜绝应该杜绝的错误，反而极大增加了编程的麻烦。
偶倒认为这个是极好的特性，而且很赞同它对于null的处理，原因在FreeMarker的FAQ上已经解释得很清楚了。
在偶们的项目里，是应用不同的ErrorHandler在开发环境/测试环境/生产环境来解决的。
具体的可以参考：
http://freemarker.sourceforge.net/docs/pgui_config_errorhandling.html
在生产环境下，可以用它自带的TemplateExceptionHandler.IGNORE_HANDLER
再加上好用的if_exists,default这些existsbuilt-in，处理各种null的情况真的是很方便：
${(bar.foo.value)?default("N/A")}
当然，对所有可能为空的值加上built-in确实是一件麻烦的事情，但是偶们所有的页面都是用formmacro做的，所以就没有你的烦恼了，:)
robbin写道
二宗罪：freemarker的map限定key必须是string，其他数据类型竟然无法操作！这一点就不讲了，JavaEye上面已经有人抱怨过了。连Webwork的开发人员PatLightboy都在抱怨这一点。
这个绝对是很烦恼的一件事情，其实这个问题是TemplateModel造成的，偶最不能理解的是为啥它需要弄一个TemplateModel来wrap所有的Object，直接用原始对象不就好了么，还要弄个wrap/unwrap。据说它这样的做法是提高性能，但是偶无法理解......，有人可以解释一下么？
robbin写道
三宗罪：freemarker为了编程方便把不可序列化的东西往session里面放！
不知道你在说啥，freemarker只是templatelanguage，和HTTPsession有啥关系啊？
freemarker/velocity这些模本语言和JSPTag比较起来，最大的优点是性能可以做得很好
而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对FreeMarkerResult的封装还是非常不错的。
FreeMarker自身的优点的确非常突出，易学，我只用叻3个小时看叻遍文档就基本掌握叻，就可以扔掉velocity叻，哈哈。而且FreeMarker自己的builtin也的确有趣，虽然大部分我都不用，还是要在action层自己封装个方法调用，不过常用的比如?html，?date这样的还是狠方便的。
我想说说FreeMarker跟JSPTag的比较，前面看到Robbin说要回归JSPTag，我真是痛心疾首啊！要拿FreeMarker去攻击JSPTag，我都不需要列举JSPTag/JSTL的缺点，只要把FreeMarker的Macro拿出来往那一亮就OK叻。用老罗的话说，“那简直是太方便叻！太方便叻！！”
我刚才就在重构一个项目的common.ftl，将公共的部分提取出来，细力度的重构。在Code级别我们可以重构，可以代码onlyonce。现在在FreeMarker的帮助下，页面级也可以这样叻！JSPTag、Velocity不是不能这样，而是都太麻烦，而且功能不强，用叻不仅不省工作量，反而还更烦。而只有FreeMarker，才能让页面达到这样的重构高度。
我们这边的策划总是有新点子，页面也总是改，我写代码是基于敏捷原则，现在页面也是敏捷的，可以说是真正做到的拥抱变化，感觉非常爽。关于第三宗罪，我今天仔细看了一下代码，确有其事。
在Freemarker自带的FreemarkerServlet的createModel方法中有这样一段代码：
Java代码
1.//Createhashmodelwrapperforsession
2.HttpSessionHashModelsessionModel;
3.HttpSessionsession=request.getSession(false);
4.if(session!=null){
5.sessionModel=(HttpSessionHashModel)session.getAttribute(ATTR_SESSION_MODEL);
6.if(sessionModel==null){
7.sessionModel=newHttpSessionHashModel(session,wrapper);
8.session.setAttribute(ATTR_SESSION_MODEL,sessionModel);
9.initializeSession(request,response);
10.}
11.}
12.else{
13.sessionModel=newHttpSessionHashModel(this,request,response,wrapper);
14.}
15.params.putUnlistedModel(KEY_SESSION,sessionModel);
//Createhashmodelwrapperforsession
HttpSessionHashModelsessionModel;
HttpSessionsession=request.getSession(false);
if(session!=null){
sessionModel=(HttpSessionHashModel)session.getAttribute(ATTR_SESSION_MODEL);
if(sessionModel==null){
sessionModel=newHttpSessionHashModel(session,wrapper);
session.setAttribute(ATTR_SESSION_MODEL,sessionModel);
initializeSession(request,response);
}
}
else{
sessionModel=newHttpSessionHashModel(this,request,response,wrapper);
}
params.putUnlistedModel(KEY_SESSION,sessionModel);
会每次把sessionModel放进HttpSession，不知道究竟什么用意。这里有一个问题是：当我们使用FreeMarker作为sitemesh的decorator的时候，必须使用FreeMarkerServlet，看sitemesh的扩展类：
Java代码
1.publicclassFreemarkerDecoratorServletextendsFreemarkerServlet
publicclassFreemarkerDecoratorServletextendsFreemarkerServlet
然后再看看webwork使用FreeMarker作为view的时候,
FreemarkerResult在createModel里面引用了FreemarkerManager.getInstance().buildTemplateModel，而FreemarkerManager的buildScopesHashModel里面：
TemplateHashModelsessionModel;
Java代码
1.HttpSessionsession=request.getSession(false);
2.if(session!=null){
3.model.put(KEY_SESSION_MODEL,newHttpSessionHashModel(session,wrapper));
4.}else{
5.//nosessionmeansnoattributes???
6.//model.put(KEY_SESSION_MODEL,newSimpleHash());
7.}
HttpSessionsession=request.getSession(false);
if(session!=null){
model.put(KEY_SESSION_MODEL,newHttpSessionHashModel(session,wrapper));
}else{
//nosessionmeansnoattributes???
//model.put(KEY_SESSION_MODEL,newSimpleHash());
}
这里每次需要sessionModel，就是直接new一个了事，并没有每次放进HttpSession下次再从HttpSession中取得。
因此使用freemarker作为webwork的view，是没有问题的。但是如果使用freemakrer作为sitemesh的decorator的时候，还是有这个群集复制的问题。我想修改FreeMarkerServlet，改成这样：
Java代码
1.HttpSessionHashModelsessionModel;
2.HttpSessionsession=request.getSession(false);
3.if(session!=null){
4.sessionModel=newHttpSessionHashModel(session,request,response,wrapper);
5.}else{
6.sessionModel=newHttpSessionHashModel(this,request,response,wrapper);
7.}
8.params.putUnlistedModel(KEY_SESSION,sessionModel);