在Grails 3中使用Sitemesh

Question

我正在将一组grails 2.0.4应用程序迁移到3.x版.所有这些都与许多java应用程序一起部署在同一服务器中.两组java和grails应用程序都使用sitemesh和freemarker模板具有相同的外观.但是使用grails 3.x我无法使commond装饰工作,应用程序坚持使用layouts/main.gsp来渲染我的gsp.

到目前为止(grails 2.0.4)提供一个共同的装饰是相当直的; 每个grails应用程序的文件/WEB-INF/decorators.xml提供对适用的freemarker模板的引用.web.xml包括sitemesh过滤器和freemarker装饰器servlet声明和映射

decorators.xml:

<?xml version="1.0" encoding="UTF-8"?>
<decorators defaultdir="/">
    <excludes>
        <pattern>/ND/*</pattern>
        <pattern>/*/ND/*</pattern>
     </excludes>
     <decorator name="freemarker" page="myftl.ftl">
         <pattern>/*</pattern>
     </decorator>
</decorators>

来自web.xml的Sitemesh过滤器和freemarker servlet:

<filter>
    <filter-name>sitemesh</filter-name>
    <filter-class>org.codehaus.groovy.grails.web.sitemesh.GrailsPageFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>sitemesh</filter-name>
    <url-pattern>/*</url-pattern>
    <dispatcher>REQUEST</dispatcher>
    <dispatcher>ERROR</dispatcher>
</filter-mapping>
<servlet>
    <servlet-name>sitemesh-freemarker</servlet-name>
    <servlet-class>com.opensymphony.module.sitemesh.freemarker.FreemarkerDecoratorServlet</servlet-class>
    <init-param>
      <param-name>TemplatePath</param-name>
      <param-value>class://</param-value>
    </init-param>    
    <init-param>
      <param-name>default_encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>          
    <load-on-startup>2</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>sitemesh-freemarker</servlet-name>
    <url-pattern>*.ftl</url-pattern>
</servlet-mapping>

我尝试过的:

• 我在src/main/webapp/WEB-INF下移动了decorators.xml
• 在grails 3.x中,sitemesh过滤器不再存在,因此,我删除了sitemesh.xml
• 没有使用web.xml,所以现在我在spring/resources.groovy中定义了freemarker servlet:

resources.groovy:

beans = {
    sitemeshFreemarkerServlet(ServletRegistrationBean) {
        servlet = bean(FreemarkerDecoratorServlet)
        urlMappings = ["*.ftl"]
        loadOnStartup = 2
    }
}

但是,grails 3.x应用程序坚持使用layouts/main.gsp来渲染我的gsp页面.似乎没有处理decorators.xml.我错过了什么？

Answer 1

也许是一个丑陋的黑客，但你可以将你的 sitemesh 处理叠加到 grails 上：

• 在 Application 类（或 spring/resources.groovy）中注册自定义 sitemesh 过滤器：

    @Bean
    FilterRegistrationBean sitemeshFilterRegistrationBean() {
        FilterRegistrationBean reg=new FilterRegistrationBean()
        reg.setFilter(new MySitemeshFilter());
        reg.setInitParameters(["configFile":"WEB-INF/my.sitemesh.xml"])
        reg.setUrlPatterns(["/*"])
        reg.setDispatcherTypes(DispatcherType.REQUEST,DispatcherType.ERROR);
        reg.setOrder(0);
        return reg;
    }

• sitemesh 配置不能是默认配置，因为 grails 会继续读取它
• 注册 freemarker servlet 来处理 ftl：

    @Bean
    ServletRegistrationBean freeMarkerServletRegistrationBean(){
        ServletRegistrationBean reg=new ServletRegistrationBean(new 
          FreemarkerDecoratorServlet(),"*.ftl");
        reg.addInitParameter("TemplatePath", "class://");
        reg.addInitParameter("default_encoding", "UTF-8");
        // etc
        return reg;
    }

• 添加自定义 sitemesh 过滤器：

 
import com.opensymphony.module.sitemesh.Config;
import com.opensymphony.module.sitemesh.Factory
import com.opensymphony.module.sitemesh.factory.DefaultFactory;
import com.opensymphony.sitemesh.ContentProcessor;
import com.opensymphony.sitemesh.DecoratorSelector;
import com.opensymphony.sitemesh.compatability.DecoratorMapper2DecoratorSelector;
import com.opensymphony.sitemesh.webapp.SiteMeshWebAppContext;

import grails.util.Holders;
import javax.servlet.FilterConfig

class MySitemeshFilter extends com.opensymphony.sitemesh.webapp.SiteMeshFilter {

    private static final String MY_SITEMESH_FACTORY = "my.sitemesh.factory";
    private FilterConfig filterConfig;
    @Override   
    public void init(FilterConfig filterConfig) {
        super.init(filterConfig);
        filterConfig.getServletContext().setAttribute("grailsApplication", Holders.grailsApplication);
        this.filterConfig=filterConfig;
    }

    protected Factory getFactory(FilterConfig filterConfig) {
        Config config=new Config(filterConfig)
        Factory f=(Factory)config.getServletContext().getAttribute(MY_SITEMESH_FACTORY);
        if (f==null) {
            f=new DefaultFactory(config);
            config.getServletContext().setAttribute(MY_SITEMESH_FACTORY, f);
        }
        return f;
    }

    @Override
    protected DecoratorSelector initDecoratorSelector(SiteMeshWebAppContext webAppContext) {
        Factory factory = getFactory(filterConfig);
        factory.refresh();
        return new DecoratorMapper2DecoratorSelector(factory.getDecoratorMapper());
    }
}

• 在此过滤器中，您必须覆盖新 sitemesh 工厂中的装饰器选择器，因为默认的选择器是单例（原文如此）并且 grails 已将其注册用于其内部 gsp 处理
• 您不必重写内容处理器（initContentProcessor 方法），让 grails 使用默认的 sitemesh 工厂处理 gsp
• 如果您想获得更多功能（例如排除模式），您将需要重写整个 doFilter 方法以在中使用新的 contentProcessorcontentProcessor.handles(webAppContext)
• 在 src/main/webapp/WEB-INF 中添加 my.sitemesh.xml 和decorators.xml
• 我已在过滤器初始化中将 grailsApplication 添加到 servlet 上下文，以便您可以在 ftl 模板中使用它
• 如果要跳过某些布局，请在内部 grails 布局中按环境添加条件