通常情况下，在一个系统中，抽象出公用的部分的过程是一个DRY的一个过程。这是所有计算机工程中的一个准则。防止重复是各种轮子的开始。
springboot 异常处理
springboot常用的异常处理是利用@ControllerAdvice或者@RestControllerAdvice编写的，这两个注解的作用均是在Runtime时期。这个类会捕获在Controller中抛出的异常，这样就可以极大的简化controller中出现的杂乱的异常代码，遇到异常只需要抛出，在共有的异常处理类中就会处理。
代码如下：
@RestControllerAdvice
public class GlobalExceptionHandler {
}
常见异常分类
在常见的HTTP Restful请求中，所有抛出的异常都要有对应的http code来对应。常见的HTTP状态码有：
- 200 成功 通常的成功响应都返回这个HTTP状态码
- 201 创建 通常在创建应用成功之后会返回这个HTTP状态码
- 404 找不到，通常在查询对象无法找到的时候返回这个HTTP状态码，这个是最常用的异常响应
- 500 内部错误 通常在服务器内部出现错误的时候，比如逻辑异常的时候返回500错误
- 401 请求未授权 通常在没有通过服务器鉴权的时候会抛出这个状态码
- 403 禁止 通常在没有认证的时候返回这个状态码
- 409 冲突 通常在新增对象的时候，如果已经存在这个对应的对象就会返回这个状态码，比如新增对象ID冲突
401和403的区别在于403是认证，比如用户密码错误这属于认证失败，返回403。而如果在登录之后，访问某些资源，但是没有权限，这属于鉴权失败，返回401。
对应的异常处理代码如下：
404异常：
/**
* 响应码 404 找不到
*
* @param e
* @return
*/
@ExceptionHandler({NoSuchStudentException.class})
@ResponseStatus(HttpStatus.NOT_FOUND)
@ResponseBody
public VndErrors onNotFoundException(Exception e) {
String logRef = logWarnLevelExceptionMessage(e);
if (log.isTraceEnabled()) {
logTraceLevelStrackTrace(e);
}
String msg = getExceptionMessage(e);
return new VndErrors(logRef, msg);
}
409 冲突错误异常，经常用在新增或修改的时候
/**
* 响应码 409 对象已经存在，冲突错误
*
* @param e
* @return
*/
@ExceptionHandler(AllReadyExistsStudentException.class)
@ResponseStatus(HttpStatus.CONFLICT)
@ResponseBody
public VndErrors onAllReadyExistsException(Exception e) {
String logRef = logWarnLevelExceptionMessage(e);
if (log.isTraceEnabled()) {
logTraceLevelStrackTrace(e);
}
String msg = getExceptionMessage(e);
return new VndErrors(logRef, msg);
}
500内部错误异常
/**
* 响应码 500 内部错误
*
* @param e
* @return
*/
@ExceptionHandler(Exception.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
@ResponseBody
public VndErrors onException(Exception e) {
log.error("Caught exception while handling a request", e);
String logRef = e.getClass().getSimpleName();
String msg = getExceptionMessage(e);
return new VndErrors(logRef, msg);
}
这些都是一些异常的案例，可以参考编写自己的异常处理，异常处理在遇到对应的@ExceptionHandler时候，如果已经在对应的ExceptionHandler中存在，就会按照这个注解下的方法进行异常处理，如果没有，就会继续往上抛出，在上述代码案例中，可以看到500内部错误异常的代码@ExceptionHandler(Exception.class)使用的是Exception类，这样的话，所以没有被其他@ExceptionHandler处理或者尚未编写的异常处理，都会按照HTTP状态码500这个代码来处理。
所以，在真实的业务场景下，尽可能将自己的业务异常补充到对应HTTP状态码的异常处理方法中，这样就会在Restful的API中，让状态码发挥自己的应有的意义。而不是仅仅抛出一个错误.
VndErrors 和HATEOAS
查看上述代码的时候发现在异常处理的时候，返回了一个VndErrors对象，这个属于Springboot hateoas，具体可以参考springboot HATEOAS实践这篇文章，总而言之，这是一个异常处理的返回对象，并且是一个最佳实践的异常处理返回对象。
springboot统一返回对象
定义好异常之后，在对应的controller中就需要编写自己的代码逻辑，无非是常见的几个HTTP请求方法的注解
@GetMapping
@PostMapping
@PutMapping
@DeleteMapping
还有一个不常用的@PatchMapping在大多数时候使用@PutMapping替代。
代码如下：
-
Get请求 查询
/** * 根据Id查询学生 * * @param id 忽略大小写 * @return 学生信息 */ @GetMapping("/{id}") public ResponseEntity<Student> getStudentByName(@PathVariable int id) { return studentService.getStudentById(id).map(ResponseEntity::ok).orElseThrow(() -> new NoSuchStudentException(String.valueOf(id))); }
-
Post请求 新增
/** * 新增学生 * * @param studentFromRequest 学生对象 * @return 新增的学生的信息 */ @PostMapping public ResponseEntity<Student> addStudent(@RequestBody Student studentFromRequest) { if (studentService.getStudentById(studentFromRequest.getId()).isPresent()) { throw new AllReadyExistsStudentException(studentFromRequest.getId()); } return new ResponseEntity<>(studentService.addStudent(studentFromRequest), HttpStatus.CREATED); }
-
Put请求 修改
/** * 修改学生信息 * * @param studentFromRequest 学生对象 * @return 修改的学生的信息 */ @PutMapping public ResponseEntity<Student> modifyStudent(@RequestBody Student studentFromRequest) { if (studentService.getStudentById(studentFromRequest.getId()).isPresent()) { throw new AllReadyExistsStudentException(studentFromRequest.getId()); } val student = studentService.addStudent(studentFromRequest); return new ResponseEntity<>(student, HttpStatus.CREATED); }
-
Delete请求 删除
/** * 根据Id删除学生 * * @param id 学生姓名 忽略大小写 * @return */ @DeleteMapping("/{id}") public ResponseEntity<?> deleteStudentById(@PathVariable int id) { return studentService.getStudentById(id).map(p -> { studentService.deleteStudentById(id); return ResponseEntity.noContent().build(); }).orElseThrow(() -> new NoSuchStudentException(String.valueOf(id))); }
上述代码采用了Java8的一些特性，可以参考 Java8,Java9,Java10新语法特性来了解更多
全部代码
全部代码已经上传到Github上，可以参考springboot-restful
