為什么80%的碼農(nóng)都做不了架構(gòu)師？>>> ??

原文內(nèi)容比較多，這里就簡(jiǎn)單地說一下。java 5以后增加了3個(gè)annotation，
@Override
@Deprecated
@SuppressWarnings
????? 以上annotation用途就不說了。java中自定義annotation需要@interface關(guān)鍵字和用到幾個(gè)內(nèi)置annotation。原文提到“sun有點(diǎn)吝嗇，偏偏搞得與interface這么像”，其實(shí)也可以理解為，正好說明接口和注解還有一些類似的。用到的元注解有@Target ,@Retention,@Documented,@Inherited ，用途如下：
??? @Target 表示該注解用于什么地方，可能的 ElemenetType 參數(shù)包括：?
??????? ElemenetType.CONSTRUCTOR 構(gòu)造器聲明?
??????? ElemenetType.FIELD 域聲明（包括 enum 實(shí)例）?
??????? ElemenetType.LOCAL_VARIABLE 局部變量聲明?
??????? ElemenetType.METHOD 方法聲明?
??????? ElemenetType.PACKAGE 包聲明?
??????? ElemenetType.PARAMETER 參數(shù)聲明?
??????? ElemenetType.TYPE 類，接口（包括注解類型）或enum聲明?
?????????
??? @Retention 表示在什么級(jí)別保存該注解信息。可選的 RetentionPolicy 參數(shù)包括：?
??????? RetentionPolicy.SOURCE 注解將被編譯器丟棄?
??????? RetentionPolicy.CLASS 注解在class文件中可用，但會(huì)被VM丟棄?
??????? RetentionPolicy.RUNTIME VM將在運(yùn)行期也保留注釋，因此可以通過反射機(jī)制讀取注解的信息。?
?????????
??? @Documented 將此注解包含在 javadoc 中?
?????
??? @Inherited 允許子類繼承父類中的注解

????? 先來了解下各自的意義
?? 1、源文件Target.java?

?? @Documented??
?? @Retention(RetentionPolicy.RUNTIME)??
?? @Target(ElementType.ANNOTATION_TYPE)??
?? public @interface Target {??
????? ElementType[] value();??
?? }??
?? 其中的@interface是一個(gè)關(guān)鍵字，在設(shè)計(jì)annotations的時(shí)候必須把一個(gè)類型定義為@interface.?
???
?? 2、源文件Retention.java?

?? @Documented??
?? @Retention(RetentionPolicy.RUNTIME)??
?? @Target(ElementType.ANNOTATION_TYPE)??
?? public @interface Retention {??
????? RetentionPolicy value();??
?? }??
?? 在上面的文件都用到了RetentionPolicy，ElementType這兩個(gè)字段,這兩個(gè)文件的源代碼如下：?
???
?? 3、源文件RetentionPolicy.java?

?? public enum RetentionPolicy {??
??? SOURCE,??
??? CLASS,??
??? RUNTIME??
?? }??

?? 這是一個(gè)enum類型,共有三個(gè)值，分別是SOURCE,CLASS 和 RUNTIME.?
?? SOURCE代表的是這個(gè)Annotation類型的信息只會(huì)保留在程序源碼里，源碼如果經(jīng)過了編譯之后，Annotation的數(shù)據(jù)就會(huì)消失,并不會(huì)保留在編譯好的.class文件里面。?
?? ClASS的意思是這個(gè)Annotation類型的信息保留在程序源碼里,同時(shí)也會(huì)保留在編譯好的.class文件里面,在執(zhí)行的時(shí)候，并不會(huì)把這一些信息加載到虛擬機(jī)(JVM)中去.注意一下，當(dāng)你沒有設(shè)定一個(gè)Annotation類型的Retention值時(shí)，系統(tǒng)默認(rèn)值是CLASS.?
?? 第三個(gè),是RUNTIME,表示在源碼、編譯好的.class文件中保留信息，在執(zhí)行的時(shí)候會(huì)把這一些信息加載到JVM中去的．?
　 舉一個(gè)例子，如@Override里面的Retention設(shè)為SOURCE,編譯成功了就不要這一些檢查的信息;相反,@Deprecated里面的 Retention設(shè)為RUNTIME,表示除了在編譯時(shí)會(huì)警告我們使用了哪個(gè)被Deprecated的方法,在執(zhí)行的時(shí)候也可以查出該方法是否被 Deprecated.?

?? 4、源文件ElementType.java?

?? public enum ElementType {??
??? TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR,??
??? LOCAL_VARIABLE, ANNOTATION_TYPE,PACKAGE??
?? }??

?? ＠Target里面的ElementType是用來指定Annotation類型可以用在哪一些元素上的.說明一下：TYPE(類型), FIELD(屬性), METHOD(方法), PARAMETER(參數(shù)), CONSTRUCTOR(構(gòu)造函數(shù)),LOCAL_VARIABLE(局部變量), ANNOTATION_TYPE,PACKAGE(包),其中的TYPE(類型)是指可以用在Class,Interface,Enum和 Annotation類型上.?
?? 另外,從1的源代碼可以看出,@Target自己也用了自己來聲明自己,只能用在ANNOTATION_TYPE之上.?
?? 如果一個(gè)Annotation類型沒有指明@Target使用在哪些元素上,那么它可以使用在任何元素之上,這里的元素指的是上面的八種類型.?
?? 面一下1和2的源文件，它們都使用了@Documented,@Documented的目的就是讓這一個(gè)Annotation類型的信息能夠顯示在javaAPI說明文檔上;沒有添加的話，使用javadoc生成API文檔的時(shí)候就會(huì)找不到這一個(gè)類型生成的信息.?
?? 另外一點(diǎn)，如果需要把Annotation的數(shù)據(jù)繼承給子類，那么就會(huì)用到@Inherited這一個(gè)。

????? 下面自定義兩個(gè)簡(jiǎn)單的annatation。
package?com.zhangshengqiang.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Description {
??? String value() default "no description";
}

//

package com.zhangshengqiang.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Name {
??? String originate();
??? String community();
}

//
package?com.zhangshengqiang.annotation;

@Description("javaeye, to be best")
public class JavaEyer {
??? @Name(originate = "創(chuàng)始人:張升強(qiáng)", community = "javaeye")
??? public String getEyeName() {
??? ??? return null;
??? }
??? @Name(originate = "創(chuàng)始人:張升強(qiáng)", community = "springside")
??? public String getSideName() {
??? ??? return "excuse me";
??? }
}

測(cè)試類///
package com.zhangshengqiang.annotation;

import java.lang.reflect.Method;
import java.util.HashSet;
import java.util.Set;

public class AnnotationTest {
??? @SuppressWarnings("unchecked")
??? public static void main(String[] args) throws ClassNotFoundException {
??? ??? final String CLASS_NAME = "annotation.JavaEyer";
??? ??? Class test = Class.forName(CLASS_NAME);
??? ??? Method[] methods = test.getMethods();
??? ??? boolean flag = test.isAnnotationPresent(Description.class);
??? ??? if (flag) {
??? ??? ??? Description des = (Description) test.getAnnotation(Description.class);
??? ??? ??? System.out.println("描述:" + des.value());
??? ??? ??? System.out.println("-----------------");
??? ??? }
??? ??? Set<Method> set = new HashSet<Method>();
??? ??? for (int i = 0; i < methods.length; i++) {
??? ??? ??? boolean otherflag = methods[i].isAnnotationPresent(Name.class);
??? ??? ??? if (otherflag) {
??? ??? ??? ??? set.add(methods[i]);
??? ??? ??? }
??? ??? }
??? ??? for (Method method : set) {
??? ??? ??? Name name = method.getAnnotation(Name.class);
??? ??? ??? System.out.println(name.originate());
??? ??? ??? System.out.println("創(chuàng)建的社區(qū):" + name.community());
??? ??? }
??? }
}

//

測(cè)試結(jié)果：
描述:javaeye, to be best

轉(zhuǎn)載于:https://my.oschina.net/004/blog/176473

總結(jié)

以上是生活随笔為你收集整理的java简单自定义Annotation的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。