SiteMesh3原理和SpringMVC + FreeMarker + SiteMesh3问题

先附上一个SiteMesh3+FreeMarker+SpringMVC例子https://files.cnblogs.com/adaikiss/sitemesh3_freemarker_springmvc.zip

下载后解压，本地环境变量要有MAVEN，CMD进入工程目录直接运行mvn jetty:run

昨天花了一天时间来跟踪调试springmvc, freemarker, sitemesh3, 终于弄明白了大概的原理，最后解决了sitemesh中文（UTF-8）乱码，ftl装饰页不被渲染的问题。

sitemesh3是通过一个filter来对response进行拦截处理，在response提交之前，它会把response流里的数据备份起来，清空流，然后用request.getRequestDispatcher(装饰页URI).forward()来取得渲染后的装饰页，然后再把装饰页里的标签替换成之前备份的对应内容。

也就是说sitemesh不关心你的页面是如何生成的，它只是将两者拼接起来，不管你用的是JSP，Volocity, FreeMarker 还是 SpringMVC, Struts, wicket。

这样一来你就可以灵活地控制页面的生成方式。你可以把sitemesh3当成一个中间浏览器，他使用用户浏览器发送过来的request对象发送了两次(或以上)请求，第一次是原来的请求， 第二次是对装饰页面的请求，然后把这两个请求结果拼接起来返回给用户浏览器。

看到这里，装饰页如果是FTL就不被渲染的问题也就有了解决方法了。只要自己写一个过滤器对.ftl的请求用freemarker渲染一遍就可以了。由于我使用的是springmvc + freemarker，因此我直接拿springmvc来渲染FTL文件了，这样可以像被装饰页一样方便地使用spring的宏和其他一些对象。下面是我的filter

public class FreemarkerFilter implements Filter {

    private Locale locale;

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        String localeStr = filterConfig.getInitParameter("locale");
        if(StringUtils.isNotBlank(localeStr)){
            locale = new Locale(localeStr);
        }else {
            locale = Locale.getDefault();
        }
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response,
            FilterChain chain) throws IOException, ServletException {
        try {
            HttpServletRequest req = (HttpServletRequest)request;
            HttpServletResponse res = (HttpServletResponse)response;
            String name = req.getRequestURI();
            name = name.substring(1, name.lastIndexOf(".ftl"));
            FreeMarkerViewResolver viewResolver = SpringContextHolder.getBean(FreeMarkerViewResolver.class);
            View view = viewResolver.resolveViewName(name, locale);
            @SuppressWarnings("unchecked")
            Map<String, Object> model = (Map<String, Object>) request.getAttribute(ViewRendererServlet.MODEL_ATTRIBUTE);
            view.render(null, req, res);
        } catch (Exception e) {
            throw new ServletException(e);
        }
    }

    @Override
    public void destroy() {
        // TODO Auto-generated method stub
        
    }
    
}

在这里，我是把SpringMVC对被装饰页处理时生成的model传到了装饰页。装饰页和原来被include进来的页面差不多，一般装饰页可能不需要使用被装饰页中的model， 可以把SuppressWarnings注解下面那行注释掉，下面传null过去。

在web.xml里加上过滤器配置：

<filter>
      <filter-name>freemarkerFilter</filter-name>
      <filter-class>org.adaikiss.kay.web.FreemarkerFilter</filter-class>
  </filter>
  <filter-mapping>
      <filter-name>freemarkerFilter</filter-name>
      <url-pattern>*.ftl</url-pattern>
      <dispatcher>REQUEST</dispatcher>
    <dispatcher>FORWARD</dispatcher>
  </filter-mapping>

这样一来由sitemesh forward的请求就能被拦截并渲染。当然，你也可以把装饰页的后缀改成.des，url-pattern要同步改。

关于中文乱码的问题，在跟踪代码的时候发现对于没有contentType的view，SpringMVC会使用默认的contentType:AbstractTemplateView.DEFAULT_CONTENT_TYPE,即

"text/html;charset=ISO-8859-1"，view 中可以设置这个属性，不过我的配置里没有定义view，还好ViewResolver里也可以设置，在springmvc配置文件里加上contentType属性即可。

<bean id="viewResolver"
class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
<property name="contentType" value="text/html; charset=UTF-8"/>

...

</bean>