一霉撵、簡介
注解是Java 1.5引入的芹助，可以提供代碼的額外信息，目前正在被廣泛應(yīng)用挟纱。除了Java內(nèi)置注解羞酗，我們也可以自定義注解。
以下就是一個(gè)自定義注解的簡單例子：
@Target(ElementType.TYPE) //注解作用于類型（類紊服，接口整慎，注解，枚舉）@Retention(RetentionPolicy.RUNTIME) //運(yùn)行時(shí)保留围苫，運(yùn)行中可以處理@Inherited// 注解將被用于該類的子類@Documented// 生成javadoc文件public @interfaceJsAnnotation { String DEFAULT_VALUE = "JS"; /** * 創(chuàng)建此value方法裤园，則使用注解時(shí)可直接傳參，如 @JsAnnotation("msg") * * @return */ String value default DEFAULT_VALUE;
}
自定義注解關(guān)鍵點(diǎn)：
@interface關(guān)鍵字定義注解
注解可以被其它注解修飾剂府，最重要的就是元注解
注解和接口類似拧揽，內(nèi)部可以定義常量和方法
注解定義的方法有一些限制：方法不能有參數(shù)；返回值只能是基本類型腺占、字符串淤袜、Class、枚舉衰伯、注解铡羡、及以上類型的數(shù)組；可以包含默認(rèn)值
小編是一個(gè)有著5年工作經(jīng)驗(yàn)的java程序員意鲸，對于java烦周，自己有做資料的整合尽爆，一個(gè)完整學(xué)習(xí)java的路線，學(xué)習(xí)資料和工具读慎，相信這里有很多學(xué)習(xí)java的小伙伴漱贱，我創(chuàng)立了一個(gè)2000人學(xué)習(xí)扣群，479121291夭委。每晚都有java的直播課程幅狮。無論是初級還是進(jìn)階的小伙伴小編我都?xì)g迎！
二株灸、元注解介紹
元注解就是定義注解的注解崇摄。
包含@Target、@Retention慌烧、@Inherited逐抑、@Documented這四種
1、@Target
描述注解的使用目標(biāo)杏死。
其源碼為：
@Documented@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.ANNOTATION_TYPE}) public @interfaceTarget { ElementType[] value;
}
注解方法返回值是ElementType[],ElementType枚舉類型，枚舉值就是@Target注解的可取值捆交。
方法名value淑翼，這樣在使用注解時(shí)，可以不需要指定方法名品追。
可取的值有：
取值含義
ElementType.PACKAGE注解作用于包
ElementType.TYPE注解作用于類型（類玄括，接口，注解肉瓦，枚舉）
ElementType.ANNOTATION_TYPE注解作用于注解
ElementType.CONSTRUCTOR注解作用于構(gòu)造方法
ElementType.METHOD注解作用于方法
ElementType.PARAMETER注解作用于方法參數(shù)
ElementType.FIELD注解作用于屬性
ElementType.LOCAL_VARIABLE注解作用于局部變量
注意：默認(rèn)可以作用于以上任何目標(biāo)遭京。
2、@Retention
描述注解的生命周期泞莉。
其源碼為：
@Documented@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.ANNOTATION_TYPE}) public @interfaceRetention { RetentionPolicy value;
}
注解方法返回值是枚舉類型RetentionPolicy哪雕，枚舉值就是@Retention注解的可取值。
可取的值有：
取值含義
RetentionPolicy.SOURCE源碼中保留鲫趁，編譯期可以處理
RetentionPolicy.CLASSClass文件中保留斯嚎，Class加載時(shí)可以處理
RetentionPolicy.RUNTIME運(yùn)行時(shí)保留，運(yùn)行中可以處理
默認(rèn)RetentionPolicy.CLASS 值挨厚。
3堡僻、@Documented
描述注解可以文檔化，是一個(gè)標(biāo)記注解疫剃。
在生成javadoc的時(shí)候钉疫，是不包含注釋的，但是如果注解被@Documented修飾巢价，則生成的文檔就包含該注解牲阁。
其源碼為：
@Documented@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.ANNOTATION_TYPE}) public @interfaceDocumented { }
4固阁、@Inherited
標(biāo)記注解，使用@Inherited修飾的注解作用于一個(gè)類咨油，則該注解將被用于該類的子類您炉。
其源碼為：
@Documented@Retention(RetentionPolicy.RUNTIME) @Target({ElementType.ANNOTATION_TYPE}) public @interfaceInherited { }
三、自定義注解示例
1役电、定義注解
@Target(ElementType.TYPE) //注解作用于類型（類赚爵，接口，注解法瑟，枚舉）@Retention(RetentionPolicy.RUNTIME) //運(yùn)行時(shí)保留冀膝，運(yùn)行中可以處理@Inherited// 注解將被用于該類的子類@Documented// 生成javadoc文件public @interfaceJsAnnotation { String DEFAULT_VALUE = "JS"; /** * 顏色枚舉 * * @author peida */enum Color {
BULE, RED, GREEN
} /** * 創(chuàng)建此value方法，則使用注解時(shí)可直接傳參霎挟，如 @JsAnnotation("msg") * * @return */ String value default DEFAULT_VALUE; /** * 此方法返回為枚舉類型窝剖，使用注解時(shí)，如 @JsAnnotation(color=Color.BLUE) * * @return */ Color color default Color.BULE; int num default -1;
}
其中：定義了三個(gè)方法酥夭，三個(gè)方法都有默認(rèn)返回值赐纱。定義了Color枚舉（因?yàn)樽⒔獾姆椒梢苑祷孛杜e類型）
這里注意：
- value方法：使用注解時(shí)可直接傳參，如 @JsAnnotation(“msg”)
- 普通方法：使用注解時(shí)熬北，如 @JsAnnotation(color=Color.BLUE)
2疙描、使用注解
@JsAnnotation("jia shuai") publicclass AnnotationTest {
}
或
@JsAnnotation(num = 100) publicclass AnnotationTest {
}
或
@JsAnnotation(color = Color.BLUE) publicclass AnnotationTest {
}
3、獲取注解
public static void main(String[] args) {
AnnotationTest test = new AnnotationTest; Class tClass = test.getClass; JsAnnotation jsAnnotation = (JsAnnotation) tClass.getAnnotation(JsAnnotation.class); System.out.println(jsAnnotation.value); System.out.println(jsAnnotation.color); System.out.println(jsAnnotation.num); }
