SiteMesh3原理和SpringMVC + FreeMarker + SiteMesh3问题

先附上一个SiteMesh3+FreeMarker+SpringMVC例子http://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>