Spring Boot 统⼀数据返回格式

本文介绍: 我们在开始项目时，要和前端约定好接口的相关结构，其中约定接口返回数据的格式是很重要的，涉及到数据能否正确传输，而我们后端返回统一的数据格式，可以为前后端的交流以及项目的开发省去很多的麻烦响应通知类 –

我们在开始项目时，要和前端约定好接口的相关结构，其中约定接口返回数据的格式是很重要的，涉及到数据能否正确传输，而我们后端返回统一的数据格式，可以为前后端的交流以及项目的开发省去很多的麻烦

统⼀的数据返回格式使⽤ @Con t roll erAd vi ce 和 Resp o n s eBod yAd vi ce 的⽅式实现 @Co n t roll erAd vi ce 表⽰响应通知类添加类 Resp o n s eAd vi ce ,实现 Resp o n s eBodyAd vi ce 接⼝,并在类上添加 @Co n tr ollerAd vi ce 注解

@ControllerAdvice
@Slf4j
public class ResponseAdvice implements ResponseBodyAdvice {
    private ObjectMapper objectMapper=new ObjectMapper();
    // supports 方法开启 beforeBodyWrite 方法
    @Override
    public boolean supports(MethodParameter returnType, Class converterType) {
        return true;
    }

    // beforeBodyWrite ⽅法:就是对响应进⾏具体操作处理
    // body 代表接口原本要返回的数据
    @SneakyThrows
    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) {
        log.info("进行统一数据返回格式body：{}",body);
        //当接口原本要返回的数据类型就是 Result 时，就不继续封装成 Result 对象了
        if(body instanceof Result){
            return body;
        }

        //当接口原本要返回的数据类型是 String 时，要进行特殊处理，要把返回的 Result 对象解析成 json 格式的字符串进行返回
        if(body instanceof String){
            return objectMapper.writeValueAsString(Result.success(body));
        }

        return Result.success(body);
    }
}

加 @Contro llerAdv ice 注解才能将 ResponseAdv ice 的对象交给 Sp ring 的 IoC 容器进行管理，才能对全局的接口起作用，@Contro llerAdv ice 注解不属于五大注解，为什么可以起到相同的作用呢，因为 @Contro llerAdv ice 注解是基于 @Component 注解实现的

重写 ResponseBodyAdvice 接口里的 supports 方法和 beforeBodyWrite 方法

sup ports⽅法:判断是否要执⾏ beforeBodyWrite⽅法. true 为执⾏, false 不执⾏.

beforeBodyWrite 方法:统一接口数据返回格式的具体处理细节

//异常处理器
//统一异常返回格式
@ControllerAdvice
//加上 @ResponseBody 注解 Spring 才知道返回的是数据，要不然就会去寻找对应 URL 的网页
@ResponseBody
public class ErrorAdvice {

    //异常都是继承于 Exception 类的，所以使用 Exception 就可以捕获到 Exception 及其所有子类异常
    //当然也可以更具体的捕获异常，进行处理
    @ExceptionHandler
    public Object hander(Exception e){
        return Result.fail(e.getMessage());
    }

    //专门捕获空指针异常进行处理
    @ExceptionHandler
    public Object hander(NullPointerException e){
        return Result.fail("发⽣NullPointerException:"+e.getMessage());
    }

    //专门捕获运算异常进行处理
    @ExceptionHandler
    public Object hander(ArithmeticException e){
        return Result.fail("发⽣ArithmeticException:"+e.getMessage());
    }


}