二、spring boot 1.5.4 异常控制

spring boot 已经做了统一的异常处理,下面看看如何自定义处理异常

 

1.错误码页面映射

1.1静态页面

必须配置在 resources/static/error文件夹下,以错误码命名

 

下面是404错误页面内容,当访问一个不存在的链接的时候,定位到此页

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Not Found</title>
</head>
<body>
<h1>Sorry, Not Found</h1>
<p>
    status code is 404
</p>

</body>
</html>

 显示效果

 

1.2动态模板页面(页面存放位置亦不能更改,且只有4xx和5xx这两个名称)

 

 

示例(5xx.ftl)

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Error</title>
</head>
<body>
<h1>server error</h1>
<p>
<div style="color:red;font-size:large">error code: ${status}-${error}</div>
<div style="color:red;font-size:medium">error msg: ${exception!},${message!}</div>

<div>
    <div id="trace" style="color:grey;font-size:small;display: none;border: 1px solid black;padding: 10px;">${trace!}</div>
</div>
</p>
</body>
</html>

 

故意访问一个抛异常的请求(/test2/throwex)

@Controller
@RequestMapping("/test2")
public class Test2 {

    @RequestMapping("")
    public String index(){
        return "test";
    }

    @RequestMapping("/throwex")
    @ResponseBody
    public String throwex(){
        int a = 3;
        int b=0;
        return String.valueOf(a/b);
    }
}

 页面效果

如果使用ajax访问这个错误请求,则返回json表示的错误信息

演示页面(/test2 -> test.ftl)

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8" />
    <title>test</title>
    <script type="text/javascript" src="/js/jquery-2.0.3.min.js"></script>
</head>
<body>
<h1>test page</h1>
<div>
    <button onclick="doAjax();">请求异常测试</button>

    <div id="msg"></div>
    <textarea id="errorMsg" style="color:red;width: 80%;height:300px"></textarea>
</div>


<script type="text/javascript">
    var doAjax = function () {
        $.ajax({
            url:'/test2/throwex',
            async:true,
            type:'GET',
            data:{},
            dataType:'json',
            success:function (data) {
                $('#msg').text(data);
            },
            error: function(xhr, textStatus, errorThrown) {
//                alert(XMLHttpRequest.status);
//                alert(XMLHttpRequest.readyState);
//                alert(textStatus);
                $('#errorMsg').text(xhr.responseText);
            }
        }); 
    };
</script>
</body>
</html>

访问test页面,点击按钮,查看效果如下:

这里分别用网页浏览器和ajax访问出错的接口得到不同的结果,一个输出错误页面,一个输出错误Json,这个是由请求的接收类型决定的。

Accept:text/html -> 返回错误页面
Accept:application/json, text/javascript -> 返回错误json
具体实现可查看BasicErrorController类

 

2.自定义错误码到页面的映射

2.1 静态页面映射配置(定制嵌入容器的时候控制错误码映射关系)

@Component
public class CustomizationBean implements EmbeddedServletContainerCustomizer{

    /**
     * 定制方法一:实现EmbeddedServletContainerCustomizer
     * @param container
     */
    @Override
    public void customize(ConfigurableEmbeddedServletContainer container) {
        //container.setPort(9000);
    }

    /**
     * 定制方法二:注入EmbeddedServletContainerFactory
     * @return
     */
    @Bean
    public EmbeddedServletContainerFactory servletContainer() {
        TomcatEmbeddedServletContainerFactory factory = new TomcatEmbeddedServletContainerFactory();
        factory.setPort(9001);
        factory.setSessionTimeout(10, TimeUnit.MINUTES);
        //优先级高于配置在/static/error文件夹里面的404.html页面
        factory.addErrorPages(new ErrorPage(HttpStatus.NOT_FOUND, "/error/403.html"));
        return factory;
    }
}

 

 

2.2 动态页面映射配置

@Component
public class MyErrorViewResolver  implements ErrorViewResolver {

    @Override
    public ModelAndView resolveErrorView(HttpServletRequest request, HttpStatus status, Map<String, Object> model) {
          return new ModelAndView("/error/error",model);
    }

}

 

这个自定义ViewResolver将替代默认的页面处理器DefaultErrorViewResolver,上述配置将所有错误(不区分错误码)都映射到了错误页面error.ftl,进行统一管理。

新建error.ftl页面渲染错误内容

和5xx.ftl类似的配置

 

3.一些异常配置

#BasicErrorController的请求路径(你可以遇到错误后跳转的路径,该路径是一个BasicErrorController的请求路径,映射到它errorHtml或者error方法,由请求接受类型决定,一个返回错误页面,一个返回错误json)
#server.error.path=/error
#always include stacktrace(是否包含异常的堆栈信息,默认NEVER,页面无法获取到${trace!}的值,可取值NEVER,ALWAYS,ON_TRACE_PARAM; on_trace_param意思是请求带上参数 ?trace=true)
server.error.include-stacktrace=always


4.springboot异常处理流程

controller->出错跳转->BasicErrorController->调用errorHtml方法->getErrorAttributes(获取错误属性返回model)->丢给页面处理器ErrorViewResolver

所以你可以定制controller/定制ErrorAttributes/定制ErrorViewResolver等,实现更加复杂的异常处理

 

posted @ 2017-06-17 17:56  追极  阅读(2207)  评论(0编辑  收藏  举报