SpringMVC 异常处理.

一、异常处理

Spring提供了多种方式将异常转换为响应：

特定的Spring异常将会自动映射为指定的HTTP状态码。在默认情况下，Spring会将自身的一些异常自动转换为合适的状态码，从而反馈给客户端。实际上，如果没有出现任何映射的异常，响应都会带有500状态码。映射表如下：

自定义异常上可以添加 @ResponseStatus 注解，从而将其映射为某一个HTTP状态码。尽管这些内置映射是很有用的，但是当我们的业务系统出现 RuntimeException 时，如果 Spring 找不到对应的内置映射，就默认是 500 的状态码，如果我们不想要 500 的状态码呢？怎么将我们自定义的Exception映射成想要的状态码呢？

/**
 * value 要匹配的异常状态码
 * reson 提示的异常原因
 */
@ResponseStatus(value = HttpStatus.NOT_FOUND,reason = "Own Exception")
public class OwnException extends RuntimeException {
}

在方法上可以添加 @ExceptionHandler 注解，使其用来处理异常。有很多时候，我们是不想把丑陋的报错页面直接展示给客户来看的，常见的做法是：搭建一个友好的页面，比如 error.jsp ,当发生异常的时候，返回这个页面给客户端。但是五花八门的处理器方法，如果每个地方都做这样的处理，我们的程序就会略显臃肿......Spring 为我们提供了一种控制器通知（@ControllerAdvice），即：当所有控制器中带有 @RequestMapping 注解的方法上出现异常的时候，就委托给这个类的 @ExceptionHandler 方法处理。

@ControllerAdvice
public class ExceptionHandle {
    /**
     * 当出现异常的时候，就返回error页面，当然可以多写几个ExceptionHandler 方法，细化你的异常处理
     * @return
     */
    @ExceptionHandler(value = Exception.class)
    public String handleException(){
        return "error";
    }
}

二、 @ControllerAdvice 不生效探究

在Spring Boot 中尝试使用 "@ControllerAdvice + @ExceptionHandler" 作为全局的异常处理机制，却一直不生效，无论异常怎么抛出，始终到不了@ControllerAdvice ，在启动日志中，看到了如下信息：

2019-08-15 13:56:10.360  INFO 13540 --- [  restartedMain] .m.m.a.ExceptionHandlerExceptionResolver : Detected @ExceptionHandler methods in exceptionProcessor
2019-08-15 13:56:10.360  INFO 13540 --- [  restartedMain] .m.m.a.ExceptionHandlerExceptionResolver : Detected @ExceptionHandler methods in exceptionAdvice

原来 @ExceptionHandler 已经在 exceptionProcessor 这个 Bean 中使用了，并且他的优先级更高，导致我们自定义的 @ExceptionHandler 一直不生效。怎么办呢？使用 @Order(Ordered.HIGHEST_PRECEDENCE) 提升 Bean 的优先级。

@Slf4j
@ControllerAdvice
@Order(Ordered.HIGHEST_PRECEDENCE)
public class ExceptionAdvice {

    @ExceptionHandler(Exception.class)
    @ResponseBody
    public ResponseData<Void> handleException(Exception ex) {
        log.error("admin route error.", ex);
        return ResponseData.buildErrorResponse(INTERNAL_SERVER_ERROR.value(), "服务器异常，请稍后再试", null);
    }
}

三、跨重定向请求传递数据

在控制器方法返回的 String 视图名称中，如果以 "redirect:" 开头，那么这个 String 不是用来查找视图的，而是用来指导浏览器进行重定向的路径。有些时候，我们希望浏览器进行重定向后，有些数据是可以保留下来的，这听起来不可思议，但 SpringMVC 为我们提供了两种方案：

使用URL 模板以路径变量或查询参数的形式传递数据。这种方式将参数放在路径变量中传递，但是有一个缺点就是不能传递复杂的对象...

    @RequestMapping(value = "/home",method = RequestMethod.GET)
    public String getHome(Model model){
        model.addAttribute("userName","userName");
        model.addAttribute("id",123);
        return "redirect:/home/{userName}";
    }

像这样，如果最后的路径会被解析为 /home/userName?id=123

@RequestMapping(method = RequestMethod.POST)
public ModelAndView report(ModelMap map, HttpServletRequest request, @RequestBody AdminReportParam reportParam) throws JsonProcessingException {
    String redirectUrl = SYS_CONFIG.getReportHost() + StringUtils.remove(request.getRequestURI(), "/admin/v1");
    RedirectView redirectView = new RedirectView(redirectUrl, true, false, false);
    map.put("auth", true);
    map.put("param", JsonUtils.writeJsonStr(reportParam));
    return new ModelAndView(redirectView, map);
}

通过flash属性发送数据。如果要传递一些对象要怎么做呢？有一种方式就是在重定向前存在 session 中，在重定向后再从 session 中取出来，再清理 session 。实际上，这种方式是可行的，也是值得推荐的。而且以下介绍的这种（flash attribute）就是基于这个原理。

/**
     * 重定向前
     * @param model RedirectAttributes ，保证对象在重定向的过程中存活下来
     * @return
     */
    @RequestMapping(value = "/list",method = RequestMethod.GET)
    public String getList(RedirectAttributes model){
        model.addAttribute("show","show");
        List<String> list = new ArrayList<String>();
        list.add("str");
        model.addFlashAttribute("list",list); // flashAttribute
        return "redirect:{show}";
    }

    /**
     * 重定向后
     * @param model
     * @return
     */
    @RequestMapping(value = "/show",method = RequestMethod.GET)
    public String showList(Model model){
        System.out.println(model.containsAttribute("list")); //true
        return "home";
    }

注意这种方式，只适合在同一个 web 应用中使用。