先附上一个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>