談?wù)凧ava中自定義注解及使用場景
Java自定義注解一般使用場景為：自定義注解+攔截器或者AOP，使用自定義注解來自己設(shè)計框架，使得代碼看起來非常優(yōu)雅。本文將先從自定義注解的基礎(chǔ)概念說起，然后開始實(shí)戰(zhàn)，寫小段代碼實(shí)現(xiàn)自定義注解+攔截器，自定義注解+AOP。
一. 什么是注解(Annotation)
Java注解是什么，以下是引用自維基百科的內(nèi)容
Java注解又稱Java標(biāo)注，是JDK5.0版本開始支持加入源代碼的特殊語法元數(shù)據(jù)。
Java語言中的類、方法、變量、參數(shù)和包等都可以被標(biāo)注。和Javadoc不同，Java標(biāo)注可以通過反射獲取標(biāo)注內(nèi)容。在編譯器生成類文件時，標(biāo)注可以被嵌入到字節(jié)碼中。Java虛擬機(jī)可以保留標(biāo)注內(nèi)容，在運(yùn)行時可以獲取到標(biāo)注內(nèi)容。當(dāng)然它也支持自定義Java標(biāo)注。
二. 注解體系圖
元注解：java.lang.annotation中提供了元注解，可以使用這些注解來定義自己的注解。主要使用的是Target和Retention注解
注解處理類：既然上面定義了注解，那得有辦法拿到我們定義的注解啊。java.lang.reflect.AnnotationElement接口則提供了該功能。注解的處理是通過java反射來處理的。
如下，反射相關(guān)的類Class, Method, Field都實(shí)現(xiàn)了AnnotationElement接口。
因此，只要我們通過反射拿到Class, Method, Field類，就能夠通過getAnnotation(Class<T>)拿到我們想要的注解并取值。
三. 常用元注解
Target：描述了注解修飾的對象范圍，取值在java.lang.annotation.ElementType定義，常用的包括：
- METHOD：用于描述方法
- PACKAGE：用于描述包
- PARAMETER：用于描述方法變量
- TYPE：用于描述類、接口或enum類型
Retention: 表示注解保留時間長短。取值在java.lang.annotation.RetentionPolicy中，取值為：
- SOURCE：在源文件中有效，編譯過程中會被忽略
- CLASS：隨源文件一起編譯在class文件中，運(yùn)行時忽略
- RUNTIME：在運(yùn)行時有效
只有定義為RetentionPolicy.RUNTIME時，我們才能通過注解反射獲取到注解。
所以，假設(shè)我們要自定義一個注解，它用在字段上，并且可以通過反射獲取到，功能是用來描述字段的長度和作用。
@Target(ElementType.FIELD) // 注解用于字段上
@Retention(RetentionPolicy.RUNTIME) // 保留到運(yùn)行時，可通過注解獲取
public @interface MyField {
String description();
int length();
}
四. 示例-反射獲取注解
先定義一個注解：
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyField {
String description();
int length();
}
通過反射獲取注解
public class MyFieldTest {
//使用我們的自定義注解
@MyField(description = "用戶名", length = 12)
private String username;
@Test
public void testMyField() {
// 獲取類模板
Class c = MyFieldTest.class;
// 獲取所有字段
for (Field f : c.getDeclaredFields()) {
// 判斷這個字段是否有MyField注解
if (f.isAnnotationPresent(MyField.class)) {
MyField annotation = f.getAnnotation(MyField.class);
System.out.println("字段:[" + f.getName() + "], 描述:[" + annotation.description() + "], 長度:[" + annotation.length() + "]");
}
}
}
}
運(yùn)行結(jié)果
應(yīng)用場景一：自定義注解+攔截器 實(shí)現(xiàn)登錄校驗(yàn)
接下來，我們使用springboot攔截器實(shí)現(xiàn)這樣一個功能，如果方法上加了@LoginRequired，則提示用戶該接口需要登錄才能訪問，否則不需要登錄。
首先定義一個LoginRequired注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LoginRequired {
}
然后寫兩個簡單的接口，訪問sourceA，sourceB資源
@RestController
public class IndexController {
@GetMapping("/sourceA")
public String sourceA() {
return "你正在訪問sourceA資源";
}
@GetMapping("/sourceB")
public String sourceB() {
return "你正在訪問sourceB資源";
}
}
沒添加攔截器之前成功訪問
實(shí)現(xiàn)spring的HandlerInterceptor 類先實(shí)現(xiàn)攔截器，但不攔截，只是簡單打印日志，如下：
public class SourceAccessInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("進(jìn)入攔截器了");
return true;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
}
}
實(shí)現(xiàn)spring類WebMvcConfigurer，創(chuàng)建配置類把攔截器添加到攔截器鏈中
@Configuration
public class InterceptorTrainConfigurer implements WebMvcConfigurer {
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(new SourceAccessInterceptor()).addPathPatterns("/**");
}
}
攔截成功如下
在sourceB方法上添加我們的登錄注解@LoginRequired
@RestController
public class IndexController {
@GetMapping("/sourceA")
public String sourceA() {
return "你正在訪問sourceA資源";
}
@LoginRequired
@GetMapping("/sourceB")
public String sourceB() {
return "你正在訪問sourceB資源";
}
}
簡單實(shí)現(xiàn)登錄攔截邏輯
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("進(jìn)入攔截器了");
// 反射獲取方法上的LoginRequred注解
HandlerMethod handlerMethod = (HandlerMethod) handler;
LoginRequired loginRequired = handlerMethod.getMethod().getAnnotation(LoginRequired.class);
if (loginRequired == null) {
return true;
}
// 有LoginRequired注解說明需要登錄，提示用戶登錄
response.setContentType("application/json; charset=utf-8");
response.getWriter().print("你訪問的資源需要登錄");
return false;
}
運(yùn)行成功，訪問sourceB時需要登錄了，訪問sourceA則不用登錄
應(yīng)用場景二：自定義注解+AOP 實(shí)現(xiàn)日志打印
先導(dǎo)入切面需要的依賴包
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency>
定義一個注解@MyLog
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyLog {
}
定義一個切面類，見如下代碼注釋理解：
@Aspect // 1.表明這是一個切面類
@Component
public class MyLogAspect {
// 2. PointCut表示這是一個切點(diǎn)，@annotation表示這個切點(diǎn)切到一個注解上，后面帶該注解的全類名
// 切面最主要的就是切點(diǎn)，所有的故事都圍繞切點(diǎn)發(fā)生
// logPointCut()代表切點(diǎn)名稱
@Pointcut("@annotation(me.zebin.demo.annotationdemo.aoplog.MyLog)")
public void logPointCut() {};
// 3. 環(huán)繞通知
@Around("logPointCut()")
public void logAround(ProceedingJoinPoint joinPoint) {
// 獲取方法名稱
String methodName = joinPoint.getSignature().getName();
// 獲取入?yún)?
Object[] param = joinPoint.getArgs();
StringBuilder sb = new StringBuilder();
for (Object o : param) {
sb.append(o + "; ");
}
System.out.println("進(jìn)入[" + methodName + "]方法,參數(shù)為:" + sb.toString());
// 繼續(xù)執(zhí)行方法
try {
joinPoint.proceed();
} catch (Throwable throwable) {
throwable.printStackTrace();
}
System.out.println(methodName + "方法執(zhí)行結(jié)束");
}
}
在步驟二中的IndexController寫一個sourceC進(jìn)行測試，加上我們的自定義注解：
@MyLog
@GetMapping("/sourceC/{source_name}")
public String sourceC(@PathVariable("source_name") String sourceName){
return "你正在訪問sourceC資源";
}
啟動springboot web項(xiàng)目，輸入訪問地址
到此這篇關(guān)于談?wù)凧ava中自定義注解及使用場景的文章就介紹到這了,更多相關(guān)Java 自定義注解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
本文主要介紹Java 面試題和答案,這里整理了Java面試中出現(xiàn)的各種題型，和相應(yīng)知識點(diǎn)，有需要的小伙伴可以好好參考下，幫助大家面試成功2016-09-09
SpringBoot中的ImportSelector類動態(tài)加載bean詳解
這篇文章主要介紹了SpringBoot中的ImportSelector類動態(tài)加載bean詳解,ImportSelector接口是spring中導(dǎo)入外部配置的核心接口,根據(jù)給定的條件(通常是一個或多個注釋屬性)判定要導(dǎo)入那個配置類,在spring自動化配置和@EnableXXX中都有它的存在,需要的朋友可以參考下2024-01-01
這篇文章主要為大家詳細(xì)介紹了Java版學(xué)生管理系統(tǒng)，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-06-06
mybatis-plus開啟sql打印的三種方式總結(jié)
這篇文章主要給大家介紹了mybatisplus開啟sql打印的三種方式,文章通過代碼示例介紹的非常詳細(xì),對大家的學(xué)習(xí)或工作有一定的參考價值,需要的朋友可以參考下2023-11-11
SpringBoot讀寫xml上傳到AWS存儲服務(wù)S3的示例
這篇文章主要介紹了SpringBoot讀寫xml上傳到S3的示例，幫助大家更好的理解和使用springboot框架，感興趣的朋友可以了解下2020-10-10
使用Spring的注解方式實(shí)現(xiàn)AOP實(shí)例
本篇文章主要介紹了使用Spring的注解方式實(shí)現(xiàn)AOP實(shí)例，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-06-06
使用SpringBoot打jar包并部署到Tomcat詳細(xì)步驟
今天帶大家來學(xué)習(xí)怎么使用SpringBoot打jar包并部署到Tomcat,文中有非常詳細(xì)的步驟及代碼示例,對正在學(xué)習(xí)java的小伙伴們很有幫助,需要的朋友可以參考下2021-05-05
Spring Data JPA調(diào)用存儲過程實(shí)例代碼
本篇文章主要介紹了Spring Data JPA調(diào)用存儲過程實(shí)例代碼，具有一定的參考價值，感興趣的小伙伴們可以參考一下。2017-04-04
詳解Java編寫并運(yùn)行spark應(yīng)用程序的方法
這篇文章主要介紹了詳解Java編寫并運(yùn)行spark應(yīng)用程序的方法，內(nèi)容詳細(xì)，結(jié)合了作者實(shí)際工作中的問題進(jìn)行具體分析，具有一定參考價值。2017-09-09
Java數(shù)據(jù)結(jié)構(gòu)之LinkedList從鏈表到實(shí)現(xiàn)
LinkedList是Java中常用的數(shù)據(jù)結(jié)構(gòu)之一，實(shí)現(xiàn)了鏈表的特性，支持快速添加、刪除元素，可以用于實(shí)現(xiàn)隊(duì)列、棧、雙向隊(duì)列等數(shù)據(jù)結(jié)構(gòu)。LinkedList的內(nèi)部實(shí)現(xiàn)采用了雙向鏈表，其中每個節(jié)點(diǎn)都包含前驅(qū)節(jié)點(diǎn)和后繼節(jié)點(diǎn)的引用，可以直接訪問鏈表的頭尾元素2023-04-04