Spring Boot HTTP over JSON 的错误码异常处理

摘要: 原创出处:www.bysocket.com 泥瓦匠BYSocket 希望转载，保留摘要，谢谢！

“年轻人不要怕表现，要敢于出来表现，但还是那句话，要有正确的度，你的表现是分析问题和解决问题的能力。”

– 《你凭什么做好互联网》

本文提纲
一、异常统一处理的使用场景
二、运行 springboot-validation-over-json 工程
三、springboot-validation-over-json 工程代码详解

一、异常统一处理的使用场景

在前后端分离开发中，经常用 HTTP over JSON 作为服务进行前后端联调对接。这里简单介绍下为啥前后端分离开发？我想到如下：

1.低耦合，责权分离，模块化。前后端之间利用轻量级协议对接耦合。
2.便于敏捷开发：后端给出 api 文档 -> 前端根据文档，mock出数据开发 ；同时，后端实现业务逻辑。
3.微服务尤其适用

这时候 HTTP over JSON 形式中很多涉及到返回码，错误码相关的处理。比如xxx参数不完整，权限不足，用户不存在等。

怎么统一处理认为是异常的场景呢？
利用的是 Spring 4.x 提供的 RestControllerAdvice。这里做下说明，也可以根据 ControllerAdvice 去实现。这里案例是 HTTP over JSON 模式，所以直接利用
RestControllerAdvice ，控制层通知器，这里用于统一拦截异常，进行响应处理。工作模式，如图：

二、运行 springboot-validation-over-json 工程

运行环境：JDK 7 或 8，Maven 3.0+
技术栈：SpringBoot 1.5+（内涵 Spring 4.x)

1.git clone 下载工程 springboot-learning-example
项目地址见 GitHub – https://github.com/JeffLi1993/springboot-learning-example：

1	git clone git@github.com:JeffLi1993/springboot-learning-example.git

然后，Maven 编译安装这个工程：

1 2	cd springboot-learning-example mvn clean install

2.运行 springboot-validation-over-json 工程
右键运行 springboot-validation-over-json 工程 Application 应用启动类的 main 函数。默认端口 8080

3.访问案例
a. 参数不完整案例：
访问浏览器打开下面链接，可得到以下 JSON 返回
http://localhost:8080/api/city?cityName=

1 2 3 4 5

{     "code": "000001",     "message": "params no complete",     "result": null }

b. 成功案例：
访问浏览器打开下面链接，可得到以下 JSON 返回
http://localhost:8080/api/city?cityName=%E6%B8%A9%E5%B2%AD%E5%B8%82

1 2 3 4 5 6 7 8 9 10

{     "code": "0",     "message": "success",     "result": {         "id": 1,         "provinceId": 2,         "cityName": "温岭",         "description": "是我的故乡"     } }

三、springboot-validation-over-json 工程代码详解

代码详解提纲：
a.控制层通知器
b.响应码设计

同样，代码共享在我的 GitHub 上：
https://github.com/JeffLi1993/springboot-learning-example/tree/master/springboot-validation-over-json

首先，工程代码目录如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

├── pom.xml └── src     └── main         └── java             └── org                 └── spring                     └── springboot                         ├── Application.java                         ├── constant                         │   └── CityErrorInfoEnum.java                         ├── result                         │   ├── ErrorInfoInterface.java                         │   ├── GlobalErrorInfoEnum.java                         │   ├── GlobalErrorInfoException.java                         │   ├── GlobalErrorInfoHandler.java                         │   └── ResultBody.java                         └── web                             ├── City.java                             └── ErrorJsonController.java

a.控制层通知器
GlobalErrorInfoHandler.java 代码如下：

1 2 3 4 5 6 7 8 9 10 11

@RestControllerAdvice public class GlobalErrorInfoHandler {   @ExceptionHandler(value = GlobalErrorInfoException.class) public ResultBody errorHandlerOverJson(HttpServletRequest request, GlobalErrorInfoException exception) {     ErrorInfoInterface errorInfo = exception.getErrorInfo();     ResultBody result = new ResultBody(errorInfo);     return result; } }

@ExceptionHandler 注解，标记了使用 errorHandlerOverJson() 方法来处理 GlobalErrorInfoException 异常。
@RestControllerAdvice 是 @ControllerAdvice 和 @ResponseBody 的语义结合。是控制器增强，直接返回对象。这里用于统一拦截异常，然后返回错误码对象体。
@ResponseBody 作用： 该注解用于将 Controller 的方法返回的对象，通过适当的 HttpMessageConverter 转换为指定格式后，写入到 Response 对象的 body 数据区。

b.响应码设计
简单讲讲，这里定义了一个错误码接口，全局错误码枚举和各个业务错误码枚举去实现接口，并用枚举值枚举出错误码及错误码消息列表。如图：

四、小结

如果实战中，大家遇到什么，或者建议《Spring boot 那些事》还需要一起交流的。请点击留言。

推荐书《腾讯传》，其中几章写的很不错。

欢迎扫一扫我的公众号关注 — 及时得到博客订阅哦！
— http://www.bysocket.com/ —
— https://github.com/JeffLi1993 —