SpringBoot中@ControllerAdvice注解的使用方法
@ControllerAdvice注解的使用
這是一個增強(qiáng)的 Controller,對controller層做異常處理、數(shù)據(jù)預(yù)處理、全局?jǐn)?shù)據(jù)綁定, springboot 會自動掃描到,不需要調(diào)用。
這個注解是spring MVC提供的,在springboot中也可以使用
全局異常處理
使用 @ControllerAdvice 注解,相當(dāng)于開啟了全局異常捕獲,具體實(shí)現(xiàn)只需兩步:
第一步:定義類,添加 @ControllerAdvice 注解,開啟全局異常捕獲;
第二步:在方法上,使用 @ExceptionHandler,定義捕獲異常的類型即可。
@ControllerAdvice public class ControllerExceptionHandler { /** * 校驗(yàn)的統(tǒng)一異常處理 * @param e * @return ComResponse * * BindException 有針對性的,是校驗(yàn)不通過時,報(bào)的錯誤異常類做處理 * Exception 對所有的報(bào)錯異常做處理 */ @ExceptionHandler(value = {BindException.class}) @ResponseBody public ComResponse validExceptionHandler(BindException e) { // 獲取我們定義的校驗(yàn)失敗的異常信息 String msg = e.getBindingResult().getAllErrors().get(0).getDefaultMessage(); ComResponse comResponse = new ComResponse<>(); comResponse.setMsg(msg); comResponse.setSuccess(false); return comResponse; } }
在該類中,你可以定義多個方法,不同方法吹不同的異常,只需要指定:@ExceptionHandler(value = {xxxException.class}),例如專門做空指針的處理方法,專門做數(shù)組越界的處理方法。 @ExceptionHandler 注解來指明異常的處理類型,上邊例子中,指定BindException類型,那么除了參數(shù)校驗(yàn)拋出的異常,其他異常不會進(jìn)這個方法中來。
關(guān)于@ControllerAdvice和@RestControllerAdvice區(qū)別:
在具體使用上,
1)注解有@ControllerAdvice的類, 需要在具體方法上同時添加@ExceptionHandler和@ResponseBody注解;
2)注解有@RestControllerAdvice的類,只需要在具體方法上添加@ExceptionHandler注解。
全局?jǐn)?shù)據(jù)綁定
全局?jǐn)?shù)據(jù)綁定功能可以用來做一些初始化數(shù)據(jù)的操作,我們可以將一些公共的數(shù)據(jù)定義在添加了 @ControllerAdvice 注解的類中,這樣,在每一個 Controller 的接口中,就都能夠訪問導(dǎo)致這些數(shù)據(jù)。
使用 @ModelAttribute 注解標(biāo)記該方法的返回?cái)?shù)據(jù)是一個全局?jǐn)?shù)據(jù),默認(rèn)情況下,這個全局?jǐn)?shù)據(jù)的 key 就是返回的變量名,value 就是方法返回值,當(dāng)然開發(fā)者可以通過 @ModelAttribute 注解的 name 屬性去重新指定 key。
定義完成后,在任何一個Controller 的接口中,都可以獲取到這里定義的數(shù)據(jù):
定義:
@ControllerAdvice public class Test { @ModelAttribute(name = "globalData") public Map<String, Object> setGlobalData() { Map<String, Object> map = new HashMap<>(){ { put("username", "呂星辰"); put("uid", 123); } }; return map; } }
獲取全局?jǐn)?shù)據(jù)
@RestController public class UserController { @RequestMapping(value = "/test") public String userTest(Model model) { // 獲取全局?jǐn)?shù)據(jù) Map<String, Object> map = model.asMap(); String json = JSON.toJSONString(map, SerializerFeature.PrettyFormat); System.out.println(json); return json; } }
輸出:
到此這篇關(guān)于SpringBoot中@ControllerAdvice注解的使用方法的文章就介紹到這了,更多相關(guān)@ControllerAdvice注解的使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Java設(shè)計(jì)模式之java責(zé)任鏈模式詳解
這篇文章主要介紹了JAVA 責(zé)任鏈模式的的相關(guān)資料,文中講解非常細(xì)致,代碼幫助大家更好的理解和學(xué)習(xí),感興趣的朋友可以了解下2021-09-09MyBatis-Plus中公共字段的統(tǒng)一處理的實(shí)現(xiàn)
在開發(fā)中經(jīng)常遇到多個實(shí)體類有共同的屬性字段,這些字段屬于公共字段,本文主要介紹了MyBatis-Plus中公共字段的統(tǒng)一處理的實(shí)現(xiàn),具有一定的參考價值,感興趣的可以了解一下2023-08-08SpringBoot?整合Mybatis-Plus并輸出SQL日志示例詳解
這篇文章主要介紹了SpringBoot整合Mybatis-Plus并輸出SQL日志,本文通過實(shí)例代碼給大家介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2023-06-06springboot3.X版本集成mybatis遇到的問題及解決
在將SpringBoot3.X版本與MyBatis集成時,直接參考基于SpringBoot2.X的配置方法會導(dǎo)致各種報(bào)錯,尤其是無法注入mapper的bean問題,這主要是因?yàn)镾pringBoot3.X版本需要搭配MyBatis3.0.3及以上版本才能正常工作,通過更新maven配置至MyBatis3.0.3版本,可以解決這一問題2024-09-09通過Spring AOP實(shí)現(xiàn)異常捕捉機(jī)制
在開發(fā)過程中,異常處理是一個不可忽視的重要環(huán)節(jié),合理、優(yōu)雅地處理異常不僅能提高代碼的魯棒性,還能提升系統(tǒng)的用戶體驗(yàn),本文將介紹如何通過Spring AOP實(shí)現(xiàn)一個高效的異常捕捉機(jī)制,使得異常處理變得更加優(yōu)雅和統(tǒng)一,需要的朋友可以參考下2024-08-08Springboot啟動報(bào)錯時實(shí)現(xiàn)異常定位
這篇文章主要介紹了Springboot啟動報(bào)錯時實(shí)現(xiàn)異常定位,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-06-06