作者：小塵
連結：https://juejin.cn/post/7357172505961578511

# 前言

見過幾千行程式碼的 controller嗎？我見過。

見過全是 try catch 的 controller 嗎，我見過。

見過全是欄位校驗的 controller 嗎，我見過。

見過全是業務程式碼的 controller 嗎？不好意思，我們公司很多業務寫在 controller 的。

看見這些我真的血壓高。

# 正文

不優雅的 controller

@RestController@RequestMapping("/user/test")public classUserController{private static Logger logger = LoggerFactory.getLogger(UserController. class);@Autowiredprivate UserService userService;@Autowiredprivate AuthService authService;@PostMappingpublic CommonResult userRegistration(@RequestBody UserVo userVo) {if (StringUtils.isBlank(userVo.getUsername())){return CommonResult.error("使用者名稱不能為空"); }if (StringUtils.isBlank(userVo.getPassword())){return CommonResult.error("密碼不能為空"); } logger.info("註冊使用者：{}" , userVo.getUsername());try { userService.registerUser(userVo.getUsername());return CommonResult.ok(); }catch (Exception e){ logger.error("註冊使用者失敗：{}", userVo.getUsername(), e);return CommonResult.error("註冊失敗"); } }@PostMapping("/login")@PermitAll@ApiOperation("使用帳號密碼登入")public CommonResult<AuthLoginRespVO> login(@RequestBody AuthLoginReqVO reqVO) {if (StringUtils.isBlank(reqVO.getUsername())){return CommonResult.error("使用者名稱不能為空"); }if (StringUtils.isBlank(reqVO.getPassword())){return CommonResult.error("密碼不能為空"); }try {return success(authService.login(reqVO)); }catch (Exception e){ logger.error("註冊使用者失敗：{}", reqVO.getUsername(), e);return CommonResult.error("註冊失敗"); } }}

優雅的controller

@RestController@RequestMapping("/user/test")public classUserController1{private static Logger logger = LoggerFactory.getLogger(UserController1. class);@Autowiredprivate UserService userService;@Autowiredprivate AuthService authService;@PostMapping("/userRegistration")public CommonResult userRegistration(@RequestBody@Valid UserVo userVo) { userService.registerUser(userVo.getUsername());return CommonResult.ok(); }@PostMapping("/login")@PermitAll@ApiOperation("使用帳號密碼登入")public CommonResult<AuthLoginRespVO> login(@RequestBody@Valid AuthLoginReqVO reqVO) {return success(authService.login(reqVO)); }}

程式碼量直接減一半呀，這還不算上有些直接把業務邏輯寫在 controller 的，看到這些我真的直接吐血

改造流程

校驗方式

這個 if 校驗看得我哪哪都不爽。好歹給我寫一個斷言吧。Assert.notNull(userVo.getUsername(), "使用者名稱不能為空");

這不香嗎？確實不香。

使用 spring 提供的@Valid

@ApiModel(value = "管理後台 - 帳號密碼登入 Request VO")@Data@NoArgsConstructor@AllArgsConstructor@Builderpublic classAuthLoginReqVO{@ApiModelProperty(value = "帳號", required = true, example = "user")@NotEmpty(message = "登入帳號不能為空")@Length(min = 4, max = 16, message = "帳號長度為 4-16 位")@Pattern(regexp = "^[A-Za-z0-9]+$", message = "帳號格式為數位以及字母")private String username;@ApiModelProperty(value = "密碼", required = true, example = "password")@NotEmpty(message = "密碼不能為空")@Length(min = 4, max = 16, message = "密碼長度為 4-16 位")private String password;}

@Valid

在SpringBoot中，@Valid是一個非常有用的註解，主要用於數據校驗。以下是關於@Valid的一些詳細資訊：

為什麽使用 @Valid 來驗證參數：在編寫介面時，我們經常需要驗證請求參數。通常，我們可能會寫大量的 if 和 if else 程式碼來進行判斷。但這樣的程式碼不僅不優雅，而且如果存在大量的驗證邏輯，這會使程式碼看起來混亂，大大降低程式碼可讀性。為了簡化這個過程，我們可以使用 @Valid 註解來幫助我們簡化驗證邏輯。

@Valid 註解的作用：@Valid 的主要作用是用於數據效驗，可以在定義的實體中的內容上，添加不同的註解來完成不同的校驗規則，而在介面類中的接收數據參數中添加 @valid 註解，這時你的實體將會開啟一個校驗的功能。

@Valid 的相關註解：在實體類中不同的內容上添加不同的註解，就能實作不同數據的效驗功能。

使用 @Valid 進行參數效驗步驟：整個過程如下，使用者存取介面，然後進行參數效驗，因為 @Valid 不支持平面的參數效驗（直接寫在參數中欄位的效驗）所以基於 GET 請求的參數還是按照原先方式進行效驗，而 POST 則可以以實體物件為參數，可以使用 @Valid 方式進行效驗。如果效驗透過，則進入業務邏輯，否則丟擲異常，交由全域例外處理器進行處理。

@Validated與@Valid的區別：@Validated 是 @Valid 的變體。透過聲明實體中內容的 groups ，再搭配使用 @Validated ，就能決定哪些內容需要校驗，哪些不需要校驗。

# 全域例外處理

這個全域例外處理，可以根據自己的異常，自訂例外處理，並設定一個兜底的例外處理

@ResponseBody@RestControllerAdvicepublic class ExceptionHandlerAdvice {protected Logger logger = LoggerFactory.getLogger(get class());@ExceptionHandler(MethodArgumentNotValidException. class)public CommonResult<Object> handleValidationExceptions(MethodArgumentNotValidException ex) { logger.error("[handleValidationExceptions]", ex); StringBuilder sb = new StringBuilder(); ex.getBindingResult().getAllErrors().forEach(error -> {String fieldName = ((org.springframework.validation.FieldError) error).getField();String errorMessage = error.getDefaultMessage(); sb.append(fieldName).append(":").append(errorMessage).append(";"); });return CommonResult.error(sb.toString()); }/** * 處理系統異常，兜底處理所有的一切 */@ExceptionHandler(value = Exception. class)public CommonResult<?> defaultExceptionHandler(Throwable ex) { logger.error("[defaultExceptionHandler]", ex);// 返回 ERROR CommonResultreturn CommonResult.error(INTERNAL_SERVER_ERROR.getCode(), INTERNAL_SERVER_ERROR.getMsg()); }}

就這麽多，搞定，這樣就擁有了漂流優雅的 controller 了

在日常開發中，還有那些血壓飆升瞬間

# 總結

熱門推薦