ControllerAdvice用法

ControllerAdvice用法

@ControllerAdvice是一个组件注解，它允许你在一个地方处理整个应用程序控制器的异常、绑定数据和预处理请求。这意味着你不需要在每个控制器中重复相同的异常处理代码，从而使得代码更加简洁、易于管理。

主要特性

• 全局异常处理：通过@ExceptionHandler注解捕获全局异常，减少重复的错误处理代码。
• 数据绑定：使用@InitBinder注解自定义请求参数的格式化和转换。
• 全局数据预处理：通过@ModelAttribute注解添加全局模型属性，这些属性对所有的@RequestMapping方法都是可见的。

全局异常处理

在开发过程中，统一异常处理是非常重要的一环。使用@ControllerAdvice，你可以定义一个或多个方法来处理整个应用中的异常。这样，当应用抛出异常时，Spring会自动寻找带有@ExceptionHandler的方法来处理它。

返回 ResponseEntity

使用@ControllerAdvice进行全局异常处理的示例代码：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception ex) {
        // 可以记录日志
        return new ResponseEntity<>("发生异常: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

在这个例子中，我们定义了一个GlobalExceptionHandler类，并使用@ControllerAdvice注解标记。其中，@ExceptionHandler(Exception.class)注解表示这个方法可以处理所有类型的异常。当应用中发生异常时，这个方法会被调用，并返回一个包含错误信息的ResponseEntity对象。

直接使用HttpServletResponse返回json

在@ControllerAdvice使用中，除了返回ResponseEntity对象外，还可以通过HttpServletResponse直接写入响应来返回JSON格式的错误信息。这种方式在需要更灵活控制响应内容和格式时非常有用，特别是在构建RESTful API时。

以下是一个示例，展示了如何在拦截到异常后通过HttpServletResponse返回JSON格式的错误信息：

@ControllerAdvice
public class GlobalExceptionHandlerWithResponse {

    @ExceptionHandler(Exception.class)
    public void handleException(Exception ex, HttpServletResponse response) throws IOException {
        response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR.value());
        response.setContentType("application/json");
        // 使用Jackson或其他JSON处理库将错误信息转换为JSON格式
        String jsonResponse = "{\"error\": \"" + ex.getMessage() + "\"}";
        response.getWriter().write(jsonResponse);
    }
}

在这个例子中，handleException方法除了接收异常对象Exception作为参数外，还接收了HttpServletResponse对象。这允许我们直接向响应输出流写入内容。首先，我们通过setStatus方法设置了HTTP状态码，然后通过setContentType方法指定了响应的内容类型为application/json。最后，我们构造了一个包含错误信息的JSON字符串，并通过response.getWriter().write(jsonResponse)将其写入响应体中。

返回自定义通用返回类

handleException方法可以直接返回一个自定义的通用返回对象，Spring框架会自动将该对象序列化为JSON格式返回给客户端。这是通过Spring MVC的消息转换器（如MappingJackson2HttpMessageConverter）自动完成的，前提是你已经在项目中加入了JSON处理库（如Jackson）。

以下是一个示例，展示如何返回一个自定义的通用返回对象，并让Spring自动将其序列化为JSON格式：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    @ResponseBody // 确保返回的对象被序列化为JSON
    public ErrorResponse handleException(Exception ex) {
        return new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), ex.getMessage());
    }

    // 自定义的通用返回对象类
    public static class ErrorResponse {
        private int status;
        private String message;

        public ErrorResponse(int status, String message) {
            this.status = status;
            this.message = message;
        }

        // getter和setter省略
    }
}

在这个例子中，handleException方法返回了一个ErrorResponse对象，该对象包含了错误状态码和错误消息。我们通过@ResponseBody注解告知Spring，这个方法的返回值应该被视为响应体，并且需要被转换为JSON格式。

Spring MVC在内部使用配置的HTTP消息转换器来将返回对象序列化为JSON。如果你的项目依赖于Jackson库，Spring会使用MappingJackson2HttpMessageConverter自动将ErrorResponse对象转换为JSON格式，然后发送给客户端。

这种方式简化了异常处理的代码，同时也提供了返回结构化错误信息的灵活性，非常适合构建RESTful API和微服务架构。

自定义参数绑定

当你需要对进入控制器的请求参数进行自定义处理时，比如日期格式的转换，@ControllerAdvice配合@InitBinder可以全局定义转换规则，避免在每个控制器中重复定义。

使用@InitBinder自定义日期格式绑定的示例：

@ControllerAdvice
public class GlobalBindingInitializer {

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
        binder.registerCustomEditor(Date.class, new CustomDateEditor(dateFormat, true));
    }
}

在这个例子中，我们通过@InitBinder注解标记的方法initBinder中，注册了一个自定义的编辑器CustomDateEditor，用于将字符串转换为Date类型。这意味着，当Spring MVC接收到日期格式的字符串参数时，会自动使用这个编辑器进行转换。

添加全局数据模型

有时候，你可能希望某些数据对所有的控制器都是可用的，比如用户登录信息、全局配置信息等。@ControllerAdvice允许你通过@ModelAttribute注解轻松实现这一点。

使用@ModelAttribute添加全局数据模型的例子：

@ControllerAdvice
public class GlobalModelAttributes {

    @ModelAttribute("globalMessage")
    public String globalMessage() {
        return "这是一个全局消息";
    }
}

在这个例子中，我们使用@ModelAttribute注解定义了一个方法globalMessage，该方法返回一个字符串。这个字符串会被添加到所有控制器方法的模型中，可以在视图中使用${globalMessage}来访问它。

参考链接

• Spring官方文档：链接地址
• @ControllerAdvice详细用法：链接地址