抑制 Freemarker 模板错误

Question

我正在使用 struts-2.3.16，我必须在我们的应用程序中全局抑制来自 Freemarker 模板的异常。这意味着，我必须转发到显示通用消息的全局 jsp，而不是带有来自 Freemarker 的堆栈跟踪的黄色屏幕，从而防止向用户显示堆栈跟踪。对于 struts 中的一般异常，我们在 struts.xml 中映射了一个全局结果，但它不适用于 Freemarker 异常。

到目前为止，我已经实现了 What are different ways to handle error in FreeMarker template? 的解决方案。所以我创建了一个 CustomFreemarkerManager 和一个 CustomTemplateExceptionHandler。

我的 CustomFreemarkerManager 如下所示：

@Override
public void init(ServletContext servletContext) throws TemplateException {
    super.config = super.createConfiguration(servletContext);
    super.config.setTemplateExceptionHandler(new CustomTemplateExceptionHandler(servletContext));
    super.contentType = "text/html";
    super.wrapper = super.createObjectWrapper(servletContext);
    if (LOG.isDebugEnabled()) {
        LOG.debug("Using object wrapper of class " + super.wrapper.getClass().getName(), new String[0]);
    }

    super.config.setObjectWrapper(super.wrapper);
    super.templatePath = servletContext.getInitParameter("TemplatePath");
    if (super.templatePath == null) {
        super.templatePath = servletContext.getInitParameter("templatePath");
    }

    super.configureTemplateLoader(super.createTemplateLoader(servletContext, super.templatePath));
    super.loadSettings(servletContext);
}

@Override
protected Configuration createConfiguration(ServletContext servletContext) throws TemplateException {
    Configuration configuration = new Configuration();
    configuration.setTemplateExceptionHandler(new CustomTemplateExceptionHandler(servletContext));
    if (super.mruMaxStrongSize > 0) {
        configuration.setSetting("cache_storage", "strong:" + super.mruMaxStrongSize);
    }

    if (super.templateUpdateDelay != null) {
        configuration.setSetting("template_update_delay", super.templateUpdateDelay);
    }

    if (super.encoding != null) {
        configuration.setDefaultEncoding(super.encoding);
    }

    configuration.setLocalizedLookup(false);
    configuration.setWhitespaceStripping(true);
    return configuration;
}

从这里我将 ServletContext 发送到我的 CustomTemplateExceptionHandler，这样我就可以创建一个 RequestDispatcher 以转发到我的 exception.jsp。问题是在异常处理程序中我没有请求和响应，我无法转发到我的 jsp.

class CustomTemplateExceptionHandler 目前看起来是这样的：

private ServletContext servletContext;

public CustomTemplateExceptionHandler(ServletContext servletContext) {
    this.servletContext = servletContext;
}

public void handleTemplateException(TemplateException te, Environment env, Writer out) throws TemplateException {
    if (servletContext != null) {
        RequestDispatcher requestDispatcher = servletContext.getRequestDispatcher("/resources/exception.jsp");

        //HERE I have to forward to my jsp
    }
}

有人知道我该怎么做吗？我希望堆栈跟踪仅记录在服务器上，并在 UI 中用通用消息替换堆栈跟踪。

Answer 1

好的，所以我对这个问题的解决方案是在我的 CustomTemplateExceptionHandler 中的 PrintWriter 上打印一个类似于 Freemarker 提供的标准 HTML_DEBUG_HANDLER 的响应。看看这个 link:

https://github.com/apache/incubator-freemarker/blob/2.3-gae/src/main/java/freemarker/template/TemplateExceptionHandler.java#L98

在这里您可以看到 HTML_DEBUG_HANDLER 是如何管理的。我用一般消息替换了打印堆栈跟踪。 Freemarker 文档建议您使用 RETHROW_HANDLER 并稍后在调用 Template.process() 之后在您的应用程序中捕获异常。看这里：

http://freemarker.org/docs/app_faq.html#misc.faq.niceErrorPage

但是因为Struts2是在后台使用Freemarker，而且Freemarker的方法是在action执行完之后才执行的，所以我一直想不通如何以及在哪里捕获异常。我已经设法在方法 handleTemplateException() 中获得 HttpServlet 响应和请求（参见问题），但我无法转发到我的 exception.jsp，因为响应已经提交，所以它给了我一个例外。

最终代码如下所示：

Class CustomFreemarkerManager:

@Override
public void init(ServletContext servletContext) throws TemplateException {
    super.config = super.createConfiguration(servletContext);
    super.config.setTemplateExceptionHandler(new CustomTemplateExceptionHandler());
    super.contentType = "text/html";
    super.wrapper = super.createObjectWrapper(servletContext);
    if (LOG.isDebugEnabled()) {
        LOG.debug("Using object wrapper of class " + super.wrapper.getClass().getName(), new String[0]);
    }

    super.config.setObjectWrapper(super.wrapper);
    super.templatePath = servletContext.getInitParameter("TemplatePath");
    if (super.templatePath == null) {
        super.templatePath = servletContext.getInitParameter("templatePath");
    }

    super.configureTemplateLoader(super.createTemplateLoader(servletContext, super.templatePath));
    super.loadSettings(servletContext);
}

@Override
protected Configuration createConfiguration(ServletContext servletContext) throws TemplateException {
    Configuration configuration = new Configuration();
    configuration.setTemplateExceptionHandler(new CustomTemplateExceptionHandler());
    if (super.mruMaxStrongSize > 0) {
        configuration.setSetting("cache_storage", "strong:" + super.mruMaxStrongSize);
    }

    if (super.templateUpdateDelay != null) {
        configuration.setSetting("template_update_delay", super.templateUpdateDelay);
    }

    if (super.encoding != null) {
        configuration.setDefaultEncoding(super.encoding);
    }

    configuration.setLocalizedLookup(false);
    configuration.setWhitespaceStripping(true);
    return configuration;
}

Class 自定义模板异常处理程序：

public void handleTemplateException(TemplateException te, Environment env, Writer out) throws TemplateException {

    boolean externalPw = out instanceof PrintWriter;
    PrintWriter pw = externalPw ? (PrintWriter) out : new PrintWriter(out);
    try {
        pw.print("<!-- ERROR MESSAGE STARTS HERE -->"
                + "<!-- ]]> -->"
                + "</table></table></table>"
                + "<div align='left' style='"
                + "background-color:#FFFF7C; "
                + "display:block; "
                + "border-top:double; "
                + "padding:10px; "
                + "'>");
        pw.print("<b style='"
                + "color: red; "
                + "font-size:14px; "
                + "font-style:normal; "
                + "font-weight:bold; "
                + "'>"
                + "Oops! We have encountered a problem. Please try again!"
                + "</b>");
        pw.println("</div></html>");
        pw.flush();  // To commit the HTTP response
    } finally {
        if (!externalPw) pw.close();
    }

    throw te;
}

如果有人对此有更好的回应，请post你的回答！

Answer 2

应该更容易。如果你不想要黄色的调试模板错误，你必须将 TemplateExceptionHandler 从 HTML_DEBUG_HANDLER 切换到 RETHROW_HANDLER （正如顶部的 freemarker 消息所建议的：FreeMarker 模板错误 DEBUG 模式；在生产中使用 RETHROW！)

现在，我更喜欢以编程方式进行（就像您所做的那样），因为我想根据环境选择 TemplateExceptionHandler（PRO、TEST、DEVEL), 我的解决方案是把环境信息放在上下文中。

public class CustomFreemarkerManager extends FreemarkerManager {    


    public CustomFreemarkerManager(){
        super();
    }

    @Override
    public void init(ServletContext servletContext) throws TemplateException {

        //important!
        super.init(servletContext);

        //other stuff maybe you want to tune...

        //Getting environmentInfo object from the context, it's a personal solution 
        EnvironmentInfo environmentInfo = (EnvironmentInfo)servletContext.getAttribute(EnvironmentInfo.CONTEXT_NAME);

        if (environment.isPro()) {
            config.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
        }else{
            config.setTemplateExceptionHandler(TemplateExceptionHandler.HTML_DEBUG_HANDLER);    
        }

    }
}

并告诉 struts 在 struts.properties

中使用你的经理

struts.freemarker.manager.classname=com.jobisjob.northpole.web.core.CustomFreemarkerManager

希望对您有所帮助。

抑制 Freemarker 模板错误

Suppress Freemarker template error

java

freemarker

struts2