Struts2、Spring MVC4 框架下的ajax統一異常處理

本文算是struts2 異常處理3板斧、spring mvc4：異常處理 后續篇章，普通頁面出錯后可以跳到統一的錯誤處理頁面，但是ajax就不行了，ajax的本意就是不讓當前頁面發生跳轉，僅局部刷新，從而改善用戶體驗，基本思路是：把異常轉換成json數據返回，這樣ajax的回調函數，就能解析出錯誤原因。

 

一、如何區分ajax請求與普通請求

打開firefox的調試工具觀察一下：

普通的頁面請求

jquery發起的ajax請求

對比一下，可以發現jquery發生的ajax請求，Request Headers里多出了x-requested-with，用它就可以判斷是否ajax請求。

 

二、struts2框架

a) 先定義一個ajax通用異常

package com.cnblogs.yjmyzz.exception;

public class AjaxException extends Exception {    

    private static final long serialVersionUID = -8503861588580421151L;

    public AjaxException(String message) {
        super(message);
    }

}

b) 然后修改異常攔截器

package com.cnblogs.yjmyzz.interceptor;
import javax.servlet.http.HttpServletRequest;

import org.apache.logging.log4j.*;
import org.apache.struts2.ServletActionContext;
import org.springframework.util.StringUtils;
import com.cnblogs.yjmyzz.exception.AjaxException;
import com.opensymphony.xwork2.*;
import com.opensymphony.xwork2.interceptor.*;

public class ExceptionInterceptor extends AbstractInterceptor {

    private static final long serialVersionUID = -6358803554282730952L;
    Logger logger = LogManager.getLogger();

    @Override
    public String intercept(ActionInvocation ai) throws Exception {
        String result = null;
        try {
            result = ai.invoke();
        } catch (Exception e) {
            logger.error(ai.toString(), e);
            ai.getStack().push(new ExceptionHolder(e));
            result = "error";

            HttpServletRequest request = ServletActionContext.getRequest();
            String xRequestedWith = request.getHeader("X-Requested-With");
            if (!StringUtils.isEmpty(xRequestedWith)) {
                // ajax請求
                // 轉換成ajax異常，並放入stack中
                ai.getStack().push(
                        new ExceptionHolder(new AjaxException(e.getMessage())));
                result = "ajax-error";
            }
        }
        return result;
    }

}

c) 修改struts.xml文件

    <package name="base-default" extends="struts-default">
        <global-results>
            <result name="ajax-error">/WEB-INF/common/ajax-error.jsp</result>
            <result name="error">/WEB-INF/common/error.jsp</result>
        </global-results>
        <global-exception-mappings>
            <exception-mapping exception="com.cnblogs.yjmyzz.exception.AjaxException"
                result="ajax-error" />
            <exception-mapping exception="java.lang.Exception"
                result="error" />
        </global-exception-mappings>
    </package>

即：返回ajax-error，異常類型為AjaxException，則交給/WEB-INF/common/ajax-error.jsp處理

d) ajax-error.jsp頁面

<%@ page contentType="application/json;charset=UTF-8" language="java"%><%@ taglib prefix="s" uri="/struts-tags"%>{"error":"<s:property value="exception" />"}

即：如果出錯，最終返回的是json串，類似：{"error":"com.cnblogs.yjmyzz.exception.AjaxException: / by zero"}

e) 然后調用ajax的地方

            $.ajax({
                type:"GET",
                url:"${pageContext.request.contextPath}/rest/orders/x",               
                success: function(data, textStatus, jqXHR){
                    if (data.error!=undefined){
                        alert("錯誤：" + data.error);
                        return false;
                    }
                    //正常處理
                    alert("ajax請求成功!");
                },
                error: function(jqXHR, textStatus, errorThrown){
                    alert('error: ' + textStatus);
                }
            });

如果服務端出異常，則ajax調用完成后，會彈出異常信息，否則按正常流程處理

 

三、Spring MVC4

a) 先修改Controller基類里的異常處理方法

    @ExceptionHandler
    public String exp(HttpServletRequest request, Exception ex) {
        String resultViewName = "errors/error";

        // 記錄日志
        logger.error(ex.getMessage(), ex);

        // 根據不同錯誤轉向不同頁面
        if (ex instanceof BusinessException) {
            resultViewName = "errors/biz-error";
        } else {
            // 異常轉換
            ex = new Exception("系統太累了，需要休息!");
        }
        request.setAttribute("ex", ex);

        String xRequestedWith = request.getHeader("X-Requested-With");
        if (!StringUtils.isEmpty(xRequestedWith)) {
            // ajax請求
            resultViewName = "errors/ajax-error";

        }

        return resultViewName;
    }

大致意思是，如果發現是ajax請求，則有異常，則交給"errors/ajax-error"視圖處理

b) ajax-error.jsp頁面

<%@ page contentType="application/json;charset=UTF-8" language="java"%><%Exception e = (Exception) request.getAttribute("ex");%>{"error":"<%=e.getClass().getSimpleName()%>","detail":"<%=e.getMessage()%>"}

c) 調用ajax的頁面

            $.ajax({
                type:"GET",
                url:"${pageContext.request.contextPath}/common-exception",               
                success: function(d, textStatus, jqXHR){
                    if (d.error!=undefined){
                        alert("錯誤：" + d.detail);
                        return false;
                    }
                    //其它正常處理
                    alert("ajax請求成功！");
                },
                error: function(jqXHR, textStatus, errorThrown){
                    alert('error: ' + textStatus);
                }
            });

如果服務端返回異常，ajax得到的反饋內容大概是：{"error":"Exception","detail":"系統太累了，需要休息!"}