SpringBoot返回统一的JSON标准格式实现步骤
期望返回的JSON格式如下
{
"code": 200,
"msg": "操作成功",
"data": "hello jenkins"
}实现步骤如下
1.自定义状态码枚举类。
@AllArgsConstructor
@Getter
public enum StatusCodeEnum {
SC200(200, "操作成功"),
SC999(999, "操作失败"),
SC401(401, "匿名用户访问权限资源时的异常"),
SC403(403, "无访问权限，请联系管理员授予权限"),
SC404(404, "请求的资源不存在"),
SC500(500, "系统异常，请稍后重试"),
// ...略
private final Integer code;
private final String msg;
}2.封装返回结果
@Data
public class ApiResult<T> implements Serializable {
private Integer code;
private String msg;
private T data;
public static <T> ApiResult<T> success(T data) {
return ApiResult.success(StatusCodeEnum.SC200.getMsg(), data);
}
public static <T> ApiResult<T> success(String msg, T data) {
ApiResult<T> apiResult = new ApiResult<>();
apiResult.setCode(StatusCodeEnum.SC200.getCode());
apiResult.setMsg(msg);
apiResult.setData(data);
return apiResult;
}
public static <T> ApiResult<T> fail(Integer code, String msg) {
ApiResult<T> apiResult = new ApiResult<>();
apiResult.setCode(code);
apiResult.setMsg(msg);
return apiResult;
}
}3.全局异常捕获处理，使用@RestControllerAdvice注解。
@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
@ExceptionHandler(Exception.class)
public ApiResult<String> handle(Exception e) {
log.error("全局异常信息：{}", e.getMessage());
return ApiResult.fail(StatusCodeEnum.SC500.getCode(), StatusCodeEnum.SC500.getMsg());
}
}| 注解 | 功能 |
|---|---|
| @RestControllerAdvice | RestController的增强类，可用于实现全局异常处理器 |
| @ExceptionHandler | 统一处理某一类异常，从而减少代码重复率和复杂度，比如要获取自定义异常可以@ExceptionHandler(BusinessException.class) |
| @ResponseStatus | 指定客户端收到的http状态码 |
注：请求进来 会按照 filter -> interceptor -> controllerAdvice -> aspect -> controller的顺序调用，
404异常（NoHandlerFoundException）是无法通过这种方式捕获的，因为在Filter层发生的异常都会到Spring默认的异常处理。如果你在配置文件配置了server.error.path的话，就会使用你配置的异常处理地址，如果没有就会使用你配置的error.path路径地址，如果还是没有，默认使用/error来作为发生异常的处理地址。如果想要替换默认的非Controller异常处理直接实现Spring提供的ErrorController接口就行了。
4.拦截Controller方法的返回值，统一处理返回值/响应体，因为我们后面每写一个接口都需要调用ApiResult.success()这行代码对结果进行包装，重复劳动，浪费体力，我们只需要实现SpringBoot提供的ResponseBodyAdvice接口即可。
@RestControllerAdvice
public class ApiResultWrapper implements ResponseBodyAdvice<Object> {
@Override
public boolean supports(MethodParameter methodParameter, Class<? extends HttpMessageConverter<?>> aClass) {
return true;
}
@Override
public Object beforeBodyWrite(Object o, MethodParameter methodParameter, MediaType mediaType, Class<? extends HttpMessageConverter<?>> aClass, ServerHttpRequest serverHttpRequest, ServerHttpResponse serverHttpResponse) {
if (o instanceof String) {
return JSON.toJSONString(ApiResult.success(o));
}
// 这个判断的作用：防止全局异常处理后返回的结果（类型为ApiResult）再次被包装
if (o instanceof ApiResult) {
return o;
}
return ApiResult.success(o);
}
}5.创建Controller，定义两个方法，让第二个方法抛异常
@RestController
public class TestController {
@GetMapping("/test1")
public String test1() {
return "当前时间：" + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
}
@GetMapping("/test2")
public Integer test2() {
System.out.println(1 / 0);
return Integer.MAX_VALUE;
}
}6.分别请求http://localhost:8080/test1、http://localhost:8080/test2，结果如下
在全局异常处理类中写了一行代码
log.error("全局异常信息：{}", e.getMessage());所以调用test2方法时控制台打印异常信息如下
到此这篇关于SpringBoot返回统一的JSON标准格式的文章就介绍到这了,更多相关SpringBoot返回JSON格式内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！
免责声明：
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的，并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据，供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
