SpringBoot中controller深層詳細(xì)講解
在基于spring框架的項(xiàng)目開(kāi)發(fā)中,必然會(huì)遇到controller層,它可以很方便的對(duì)外提供數(shù)據(jù)接口服務(wù),也是非常關(guān)鍵的出口,所以非常有必要進(jìn)行規(guī)范統(tǒng)一,使其既簡(jiǎn)潔又優(yōu)雅。
controller層的職責(zé)為負(fù)責(zé)接收和響應(yīng)請(qǐng)求,一般不負(fù)責(zé)具體的邏輯業(yè)務(wù)的實(shí)現(xiàn)。controller主要工作如下:
- 接收請(qǐng)求并解析參數(shù);
- 調(diào)用service層執(zhí)行具體的業(yè)務(wù)邏輯(可能包含參數(shù)校驗(yàn));
- 捕獲業(yè)務(wù)異常做出反饋;
- 業(yè)務(wù)邏輯執(zhí)行成功做出響應(yīng);
目前controller層代碼會(huì)存在的問(wèn)題:
- 參數(shù)校驗(yàn)過(guò)多地耦合了業(yè)務(wù)代碼,違背了單一職責(zé)原則;
- 可能在多個(gè)業(yè)務(wù)邏輯中拋出同一個(gè)異常,導(dǎo)致代碼重復(fù);
- 各種異常反饋和成功響應(yīng)格式不統(tǒng)一,接口對(duì)接不友好;
優(yōu)雅寫法一:統(tǒng)一返回結(jié)構(gòu)
統(tǒng)一返回值類型,無(wú)論項(xiàng)目前后端是否分離都是非常必要的,方便對(duì)接接口的前端開(kāi)發(fā)人員更加清晰地知道這個(gè)接口的調(diào)用是否成功,不能僅僅簡(jiǎn)單地看返回值是否為 null 就判斷成功與否,因?yàn)橛行┙涌诘脑O(shè)計(jì)就是如此。
統(tǒng)一返回結(jié)構(gòu),通過(guò)狀態(tài)碼就能清楚的知道接口的調(diào)用情況:
@Data public class ResponseData<T> { private Boolean status = true; private int code = 200; private String message; private T data; public static ResponseData ok(Object data) { return new ResponseData(data); } public static ResponseData ok(Object data,String message) { return new ResponseData(data,message); } public static ResponseData fail(String message,int code) { ResponseData responseData= new ResponseData(); responseData.setCode(code); responseData.setMessage(message); responseData.setStatus(false); responseData.setData(null); return responseData; } public ResponseData() { super(); } public ResponseData(T data) { super(); this.data = data; } public ResponseData(T data,String message) { super(); this.data = data; this.message=message; } }
@AllArgsConstructor @Data public enum ResponseCode { SYS_FAIL(1, "操作失敗"), SYS_SUCESS(200, "操作成功"), SYSTEM_ERROR_CODE_403(403, "權(quán)限不足"), SYSTEM_ERROR_CODE_404(404, "未找到請(qǐng)求資源"), ; private int code; private String msg; }
統(tǒng)一返回結(jié)構(gòu)后,就可以在controller中使用了,但是每個(gè)controller都這么寫,都是很重復(fù)的工作,所以還可以繼續(xù)想辦法處理統(tǒng)一返回結(jié)構(gòu)。
優(yōu)雅寫法二:統(tǒng)一包裝處理
Spring 中提供了一個(gè)類 ResponseBodyAdvice ,能幫助我們實(shí)現(xiàn)上述需求:
ResponseBodyAdvice 是對(duì) Controller 返回的內(nèi)容在 HttpMessageConverter 進(jìn)行類型轉(zhuǎn)換之前攔截,進(jìn)行相應(yīng)的處理操作后,再將結(jié)果返回給客戶端。這樣就可以把統(tǒng)一包裝處理的工作放到這個(gè)類里面,其中supports判斷是否要交給beforeBodyWrite 方法執(zhí)行,true為需要,false為不需要,beforeBodyWrite 是對(duì)response的具體處理。
@RestControllerAdvice(basePackages = "com.example.demo") public class ResponseAdvice implements ResponseBodyAdvice<Object> { @Override public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) { // 如果不需要進(jìn)行封裝的,可以添加一些校驗(yàn)手段,比如添加標(biāo)記排除的注解 return true; } @Override public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class<? extends HttpMessageConverter<?>> selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) { // 提供一定的靈活度,如果body已經(jīng)被包裝了,就不進(jìn)行包裝 if (body instanceof Result) { return body; } return Result.success(body); } }
這樣即能實(shí)現(xiàn)對(duì)controller返回的數(shù)據(jù)進(jìn)行統(tǒng)一,又不需要對(duì)原有代碼進(jìn)行大量的改動(dòng)了。
優(yōu)雅寫法三:參數(shù)校驗(yàn)
Java API 的規(guī)范 JSR303 定義了校驗(yàn)的標(biāo)準(zhǔn) validation-api ,其中一個(gè)比較出名的實(shí)現(xiàn)是 hibernate validation。
@PathVariable 和 @RequestParam 參數(shù)校驗(yàn):get請(qǐng)求的參數(shù)接收一般依賴這兩個(gè)注解,但是處于 url 有長(zhǎng)度限制和代碼的可維護(hù)性,超過(guò) 5 個(gè)參數(shù)盡量用實(shí)體來(lái)傳參;
對(duì) @PathVariable 和 @RequestParam 參數(shù)進(jìn)行校驗(yàn)需要在入?yún)⑻幝暶骷s束的注解,如果校驗(yàn)失敗,會(huì)拋出 MethodArgumentNotValidException 異常。
@RestController @RequestMapping("/test") public class TestController { private TestService testService; @Autowired public void setTestService(TestService prettyTestService) { this.testService = prettyTestService; } @GetMapping("/{num}") public Integer num(@PathVariable("num") @Min(1) @Max(20) Integer num) { return num * num; } @GetMapping("/email") public String email(@RequestParam @NotBlank @Email String email) { return email; } }
@RequestBody 參數(shù)校驗(yàn):post和put 請(qǐng)求的參數(shù)推薦使用 @RequestBody 請(qǐng)求體參數(shù);
對(duì) @RequestBody 參數(shù)進(jìn)行校驗(yàn)需要在 DTO 對(duì)象中加入校驗(yàn)條件后,再搭配 @Validated 即可完成自動(dòng)校驗(yàn)。如果校驗(yàn)失敗,會(huì)拋出 ConstraintViolationException 異常。
@Data public class TestDTO { @NotBlank private String userName; @NotBlank @Length(min = 6, max = 20) private String password; @NotNull @Email private String email; } @RestController @RequestMapping("/test") public class TestController { private TestService testService; @Autowired public void setTestService(TestService testService) { this.testService = testService; } @PostMapping("/testValidation") public void testValidation(@RequestBody @Validated TestDTO testDTO) { this.testService.save(testDTO); } }
自定義校驗(yàn)規(guī)則:有些時(shí)候 JSR303 標(biāo)準(zhǔn)中提供的校驗(yàn)規(guī)則不滿足復(fù)雜的業(yè)務(wù)需求,也可以自定義校驗(yàn)規(guī)則;
優(yōu)雅寫法四:自定義異常與統(tǒng)一攔截異常
原來(lái)拋出的異常會(huì)有如下問(wèn)題:
- 拋出的異常不夠具體,只是簡(jiǎn)單地把錯(cuò)誤信息放到了 Exception 中;
- 拋出異常后,Controller 不能具體地根據(jù)異常做出反饋;
- 雖然做了參數(shù)自動(dòng)校驗(yàn),但是異常返回結(jié)構(gòu)和正常返回結(jié)構(gòu)不一致;
自定義異常是為了后面統(tǒng)一攔截異常時(shí),對(duì)業(yè)務(wù)中的異常有更加細(xì)顆粒度的區(qū)分,攔截時(shí)針對(duì)不同的異常作出不同的響應(yīng)。
統(tǒng)一攔截異常的是為了可以與前面定義下來(lái)的統(tǒng)一包裝返回結(jié)構(gòu)能對(duì)應(yīng)上,還有就是希望無(wú)論系統(tǒng)發(fā)生什么異常,Http 的狀態(tài)碼都要是 200 ,盡可能由業(yè)務(wù)來(lái)區(qū)分系統(tǒng)的異常。
//自定義異常 public class ForbiddenException extends RuntimeException { public ForbiddenException(String message) { super(message); } } //自定義異常 public class BusinessException extends RuntimeException { public BusinessException(String message) { super(message); } } //統(tǒng)一攔截異常 @RestControllerAdvice(basePackages = "com.example.demo") public class ExceptionAdvice { /** * 捕獲 {@code BusinessException} 異常 */ @ExceptionHandler({BusinessException.class}) public Result<?> handleBusinessException(BusinessException ex) { return Result.failed(ex.getMessage()); } /** * 捕獲 {@code ForbiddenException} 異常 */ @ExceptionHandler({ForbiddenException.class}) public Result<?> handleForbiddenException(ForbiddenException ex) { return Result.failed(ResultEnum.FORBIDDEN); } /** * {@code @RequestBody} 參數(shù)校驗(yàn)不通過(guò)時(shí)拋出的異常處理 */ @ExceptionHandler({MethodArgumentNotValidException.class}) public Result<?> handleMethodArgumentNotValidException(MethodArgumentNotValidException ex) { BindingResult bindingResult = ex.getBindingResult(); StringBuilder sb = new StringBuilder("校驗(yàn)失敗:"); for (FieldError fieldError : bindingResult.getFieldErrors()) { sb.append(fieldError.getField()).append(":").append(fieldError.getDefaultMessage()).append(", "); } String msg = sb.toString(); if (StringUtils.hasText(msg)) { return Result.failed(ResultEnum.VALIDATE_FAILED.getCode(), msg); } return Result.failed(ResultEnum.VALIDATE_FAILED); } /** * {@code @PathVariable} 和 {@code @RequestParam} 參數(shù)校驗(yàn)不通過(guò)時(shí)拋出的異常處理 */ @ExceptionHandler({ConstraintViolationException.class}) public Result<?> handleConstraintViolationException(ConstraintViolationException ex) { if (StringUtils.hasText(ex.getMessage())) { return Result.failed(ResultEnum.VALIDATE_FAILED.getCode(), ex.getMessage()); } return Result.failed(ResultEnum.VALIDATE_FAILED); } /** * 頂級(jí)異常捕獲并統(tǒng)一處理,當(dāng)其他異常無(wú)法處理時(shí)候選擇使用 */ @ExceptionHandler({Exception.class}) public Result<?> handle(Exception ex) { return Result.failed(ex.getMessage()); } }
通過(guò)上述寫法,可以發(fā)現(xiàn) Controller 的代碼變得非常簡(jiǎn)潔優(yōu)雅,可以清楚知道每個(gè)參數(shù)、每個(gè)DTO的校驗(yàn)規(guī)則,可以明確返回的結(jié)構(gòu),包括異常情況。
到此這篇關(guān)于SpringBoot中controller深層詳細(xì)講解的文章就介紹到這了,更多相關(guān)SpringBoot controller內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- SpringBoot中Controller的傳參方式詳細(xì)講解
- SpringBoot在Controller層接收參數(shù)的n種姿勢(shì)(超詳細(xì))
- 關(guān)于SpringBoot中controller參數(shù)校驗(yàn)的使用
- SpringBoot Controller中的常用注解
- springboot中的controller注意事項(xiàng)說(shuō)明
- SpringBoot開(kāi)發(fā)詳解之Controller接收參數(shù)及參數(shù)校驗(yàn)
- SpringBoot如何配置Controller實(shí)現(xiàn)Web請(qǐng)求處理
相關(guān)文章
ShardingSphere結(jié)合MySQL實(shí)現(xiàn)分庫(kù)分表的項(xiàng)目實(shí)踐
在實(shí)際開(kāi)發(fā)中,如果表的數(shù)據(jù)過(guò)大我們需要把一張表拆分成多張表,本文主要介紹了使用ShardingSphere實(shí)現(xiàn)MySQL分庫(kù)分表,具有一定的參考價(jià)值,感興趣的可以了解一下2024-03-03在controller中如何設(shè)置接收參數(shù)的默認(rèn)值
這篇文章主要介紹了在controller中如何設(shè)置接收參數(shù)的默認(rèn)值,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2022-03-03SpringBoot深入探究四種靜態(tài)資源訪問(wèn)的方式
這一節(jié)詳細(xì)的學(xué)習(xí)一下SpringBoot的靜態(tài)資源訪問(wèn)相關(guān)的知識(shí)點(diǎn)。像這樣的知識(shí)點(diǎn)還挺多,比如SpringBoot2的Junit單元測(cè)試等等。本章我們來(lái)了解靜態(tài)資源訪問(wèn)的四種方式2022-05-05Java中綴表達(dá)式轉(zhuǎn)后綴表達(dá)式實(shí)現(xiàn)方法詳解
這篇文章主要介紹了Java中綴表達(dá)式轉(zhuǎn)后綴表達(dá)式實(shí)現(xiàn)方法,結(jié)合實(shí)例形式分析了Java中綴表達(dá)式轉(zhuǎn)換成后綴表達(dá)式的相關(guān)算法原理與具體實(shí)現(xiàn)技巧,需要的朋友可以參考下2019-03-03Spring?Security中自定義cors配置及原理解析
在Spring框架中,通過(guò)自定義CORS配置可根據(jù)實(shí)際情況調(diào)整URL的協(xié)議、主機(jī)、端口等,以適應(yīng)"同源安全策略",配置原理涉及CorsConfigurer和CorsFilter,自定義配置需要注意@Configuration注解、方法名以及可能的@Autowired注解2024-10-10Jmeter后置處理器實(shí)現(xiàn)過(guò)程及方法應(yīng)用
這篇文章主要介紹了Jmeter后置處理器實(shí)現(xiàn)過(guò)程及方法應(yīng)用,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2020-09-09Java編程常見(jiàn)內(nèi)存溢出異常與代碼示例
這篇文章主要介紹了Java編程常見(jiàn)內(nèi)存溢出異常與代碼示例,具有一定參考價(jià)值,需要的朋友可以了解下。2017-11-11