Spring自定義注解的實現(xiàn)與使用方式
一、什么是注解?
注解就是一種標志,單獨使用注解,就相當于在類、方法、參數(shù)和包上加上一個裝飾,什么功能也沒有,僅僅是一個標志,然后這個標志可以加上一些自己定義的參數(shù)。
就像下面這樣,創(chuàng)建一個@interface的注解,然后就可以使用這個注解了,加在我們需要裝飾的方法上,但是什么功能也沒有。
public @interface AuthorityVerify { String value() default ""; }
二、聊聊 JAVA 自帶的注解
1、定義
聊到Java注解,就不得不說@interface這個東西,它跟類(Class)、枚舉(enum)、接口(interface)等一樣,用于設置類型,比如下方的代碼,就是一個注解類:
/** * 自定義權限校驗接口 * * @author 億先生 * @date 2024年1月23日18:57:15 */ @Target({ElementType.METHOD, ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) public @interface AuthorityVerify { String value() default ""; }
備注:
- 修飾符
- 訪問修飾符必須為public,不寫默認為pubic;
- 關鍵字
- 關鍵字為@interface;
- 注解名稱
- 注解名稱為自定義注解的名稱,例如上面的XinLinLog 就是注解名稱
- 注解類型元素
- 注解類型元素是注解中內容,根據(jù)需要標志參數(shù),例如上面的注解的value;
2、元注解
說到注解就不得不說元注解,元注解就是作用在注解身上的,用來描述該注解的使用范圍,接下來我們就來說說@Target、@Retention、@Document ed、@Inherited 這四大元注解的作用。
@Target
用于描述注解的使用范圍,該注解可以使用在什么地方
Target類型 | 描述 |
---|---|
ElementType.TYPE | 應用于類、接口(包括注解類型)、枚舉 |
ElementType.FIELD | 應用于屬性(包括枚舉中的常量) |
ElementType.METHOD | 應用于方法 |
ElementType.PARAMETER | 應用于方法的形參 |
ElementType.CONSTRUCTOR | 應用于構造函數(shù) |
ElementType.LOCAL_VARIABLE | 應用于局部變量 |
ElementType.ANNOTATION_TYPE | 應用于注解類型 |
ElementType.PACKAGE | 應用于包 |
備注: 例如@Target(ElementType.METHOD),標志的注解使用在方法上,但是我們在這個注解標志在類上,就會報錯
@Retention
表明該注解的生命周期
生命周期類型 | 描述 |
---|---|
RetentionPolicy.SOURCE | 編譯時被丟棄,不包含在類文件中 |
RetentionPolicy.CLASS | JVM加載時被丟棄,包含在類文件中,默認值 |
RetentionPolicy.RUNTIME | 由JVM 加載,包含在類文件中,在運行時可以被獲取到 |
@Documented
表明該注解標記的元素可以被Javadoc 或類似的工具文檔化
@Inherited
是一個標記注解,@Inherited闡述了某個被標注的類型是被繼承的。
如果一個使用了@Inherited修飾的annotation類型被用于一個class,則這個annotation將被用于該class的子類。
3、注解能用于哪些場景?
一般我們可以通過注解來實現(xiàn)一些重復的邏輯,就像封裝了的一個方法,可以用在一些權限校驗、字段校驗、字段屬性注入、保存日志、緩存
三、結合Spring AOP切面實現(xiàn)功能
上面總結的注解的定義,但是創(chuàng)建這樣一個注解,僅僅是一個標志,裝飾類、方法、屬性的,并沒有功能,要想實現(xiàn)功能,需要我們通過攔截器、AOP切面這些地方獲取注解標志,然后實現(xiàn)我們的功能。
1、AOP是什么?
全稱Aspect Oriented Programming,翻譯過來就是大名鼎鼎的 “面向切面編程”,它是對面向對象的一種補充和完善。
場景:
數(shù)據(jù)源切換、事務管理、權限控制、日志打印等。
特點:
- ①侵入性小,幾乎可以不改動原來邏輯的情況下把新的邏輯加入業(yè)務。
- ②實現(xiàn)方便,使用幾個注解就可以實現(xiàn),使系統(tǒng)更容易擴展。
- ③更好的復用代碼,比如事務日志打印,簡單邏輯適合所有情況。
2、注解的含義
注解 | 描述 |
---|---|
@Aspect | 切面。表示一個橫切進業(yè)務的一個對象。它里面包含切入點(Pointcut)和Advice(通知)。 |
@Pointcut | 切入點。表示需要切入的位置,比如某些類或者某些方法,也就是先定一個范圍。 |
@Before | Advice(通知)的一種,切入點的方法體執(zhí)行之前執(zhí)行。 |
@Around | Advice(通知)的一種,環(huán)繞切入點執(zhí)行也就是把切入點包裹起來執(zhí)行。 |
@After | Advice(通知)的一種,在切入點正常運行結束后執(zhí)行。 |
@AfterReturning | Advice(通知)的一種,在切入點正常運行結束后執(zhí)行,異常則不執(zhí)行 |
@AfterThrowing | Advice(通知)的一種,在切入點運行異常時執(zhí)行。 |
- 正常的執(zhí)行順序是:@Around ->@Before->主方法體->@Around中pjp.proceed()->@After->@AfterReturning
- 異常執(zhí)行順序為(Around中pjp.proceed()之前):@Around -> @After -> @AfterThrowing
- 異常執(zhí)行順序為(Around中pjp.proceed()之后):@Around ->@Before->主方法體->@Around中pjp.proceed()->@After->@AfterThrowing
擴展:Pointcut切入點的語法
/** * 1、使用within表達式匹配 * 下面示例表示匹配com.leo.controller包下所有的類的方法 */ @Pointcut("within(com.leo.controller..*)") public void pointcutWithin(){ } /** * 2、this匹配目標指定的方法,此處就是HelloController的方法 */ @Pointcut("this(com.leo.controller.HelloController)") public void pointcutThis(){ } /** * 3、target匹配實現(xiàn)UserInfoService接口的目標對象 */ @Pointcut("target(com.leo.service.UserInfoService)") public void pointcutTarge(){ } /** * 4、bean匹配所有以Service結尾的bean里面的方法, * 注意:使用自動注入的時候默認實現(xiàn)類首字母小寫為bean的id */ @Pointcut("bean(*ServiceImpl)") public void pointcutBean(){ } /** * 5、args匹配第一個入?yún)⑹荢tring類型的方法 */ @Pointcut("args(String, ..)") public void pointcutArgs(){ } /** * 6、@annotation匹配是@Controller類型的方法 */ @Pointcut("@annotation(org.springframework.stereotype.Controller)") public void pointcutAnnocation(){ } /** * 7、@within匹配@Controller注解下的方法,要求注解的@Controller級別為@Retention(RetentionPolicy.CLASS) */ @Pointcut("@within(org.springframework.stereotype.Controller)") public void pointcutWithinAnno(){ } /** * 8、@target匹配的是@Controller的類下面的方法,要求注解的@Controller級別為@Retention(RetentionPolicy.RUNTIME) */ @Pointcut("@target(org.springframework.stereotype.Controller)") public void pointcutTargetAnno(){ } /** * 9、@args匹配參數(shù)中標注為@Sevice的注解的方法 */ @Pointcut("@args(org.springframework.stereotype.Service)") public void pointcutArgsAnno(){ } /** * 10、使用excution表達式 * execution( * modifier-pattern? //用于匹配public、private等訪問修飾符 * ret-type-pattern //用于匹配返回值類型,不可省略 * declaring-type-pattern? //用于匹配包類型 * name-pattern(param-pattern) //用于匹配類中的方法,不可省略 * throws-pattern? //用于匹配拋出異常的方法 * ) * * 下面的表達式解釋為:匹配com.leo.controller.HelloController類中以hello開頭的修飾符為public返回類型任意的方法 */ @Pointcut(value = "execution(public * com.leo.controller.HelloController.hello*(..))") public void pointCut() { }
需要注意:上面的匹配的類型中支持或(||)與(&&)非(!)運算。
3、小Demo
①引入依賴包
<!--spring切面aop依賴--> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency>
②創(chuàng)建切面實現(xiàn)功能(這里以權限校驗為例)
Ⅰ創(chuàng)建咱們的一個切面類
/** * 權限校驗 切面實現(xiàn) * * @author: 陌溪 * @create: 2020-03-06-19:05 */ @Aspect @Component @Slf4j public class AuthorityVerifyAspect { }
@Aspect: 切面。表示一個橫切進業(yè)務的一個對象。它里面包含切入點(Pointcut)和Advice(通知)。
Ⅱ在切面類中創(chuàng)建一個用于掃描我們上面所用到的注解
@Pointcut(value = "@annotation(authorityVerify)") public void pointcut(AuthorityVerify authorityVerify) { }
@Pointcut: 切入點。表示需要切入的位置,比如某些類或者某些方法,也就是先定一個范圍。
Ⅲ在創(chuàng)建一個通知方法
@Around(value = "pointcut(authorityVerify)") public Object doAround(ProceedingJoinPoint joinPoint, AuthorityVerify authorityVerify) throws Throwable { ServletRequestAttributes attribute = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes(); HttpServletRequest request = attribute.getRequest(); //獲取請求路徑 String url = request.getRequestURI(); // 解析出請求者的ID和用戶名 String adminUid = request.getAttribute(SysConf.ADMIN_UID).toString(); // 管理員能夠訪問的路徑 String visitUrlStr = redisUtil.get(RedisConf.ADMIN_VISIT_MENU + RedisConf.SEGMENTATION + adminUid); LinkedTreeMap<String, String> visitMap = new LinkedTreeMap<>(); if (StringUtils.isNotEmpty(visitUrlStr)) { // 從Redis中獲取 visitMap = (LinkedTreeMap<String, String>) JsonUtils.jsonToMap(visitUrlStr, String.class); } else { // 查詢數(shù)據(jù)庫獲取 Admin admin = adminService.getById(adminUid); String roleUid = admin.getRoleUid(); Role role = roleService.getById(roleUid); String caetgoryMenuUids = role.getCategoryMenuUids(); String[] uids = caetgoryMenuUids.replace("[", "").replace("]", "").replace("\"", "").split(","); List<String> categoryMenuUids = new ArrayList<>(Arrays.asList(uids)); // 這里只需要查詢訪問的按鈕 QueryWrapper<CategoryMenu> queryWrapper = new QueryWrapper<>(); queryWrapper.in(SQLConf.UID, categoryMenuUids); queryWrapper.eq(SQLConf.MENU_TYPE, EMenuType.BUTTON); queryWrapper.eq(SQLConf.STATUS, EStatus.ENABLE); List<CategoryMenu> buttonList = categoryMenuService.list(queryWrapper); for (CategoryMenu item : buttonList) { if (StringUtils.isNotEmpty(item.getUrl())) { visitMap.put(item.getUrl(), item.getUrl()); } } // 將訪問URL存儲到Redis中 redisUtil.setEx(RedisConf.ADMIN_VISIT_MENU + SysConf.REDIS_SEGMENTATION + adminUid, JsonUtils.objectToJson(visitMap), 1, TimeUnit.HOURS); } // 判斷該角色是否能夠訪問該接口 if (visitMap.get(url) != null) { log.info("用戶擁有操作權限,訪問的路徑: {},擁有的權限接口:{}", url, visitMap.get(url)); //執(zhí)行業(yè)務 return joinPoint.proceed(); } else { log.info("用戶不具有操作權限,訪問的路徑: {}", url); return ResultUtil.result(ECode.NO_OPERATION_AUTHORITY, MessageConf.RESTAPI_NO_PRIVILEGE); } }
@Around: Advice(通知)的一種,環(huán)繞切入點執(zhí)行也就是把切入點包裹起來執(zhí)行。
總結
以上為個人經(jīng)驗,希望能給大家一個參考,也希望大家多多支持腳本之家。
相關文章
springboot如何獲取相對路徑文件夾下靜態(tài)資源的方法
這篇文章主要介紹了springboot如何獲取相對路徑文件夾下靜態(tài)資源的方法,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2019-05-05SpringBoot?LocalDateTime格式轉換方案詳解(前端入?yún)?
這篇文章主要介紹了SpringBoot?LocalDateTime格式轉換(前端入?yún)?,本文用示例介紹SpringBoot全局格式配置,將前端傳過來的時間自動轉化為LocalDateTime,需要的朋友可以參考下2023-04-04SpringBoot解決Required?String?parameter?xxx?is?not?prese
這篇文章主要介紹了SpringBoot解決Required?String?parameter?xxx?is?not?present問題,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-01-01