JAVA注解
Java 自帶注解(系統(tǒng)注解)
- @Override
表示重寫注解
- @Deprecated
表示過時的方法
- @Suppvisewarnings
忽略某些警告
注解的分類
按照運行機制分類:
-
源碼注解
注解只是在源碼時存在趴拧,編譯成class時就不存在了。
-
運行時注解
在運行時注解仍然存在并且可能會影響程序邏輯昼激。
-
編譯時注解
在源碼和class文件中都存在煞檩。
元注解:
元注解的作用就是負責(zé)注解其他注解。Java5.0定義了4個標準的meta-annotation類型呐萌,它們被用來提供對其它 annotation類型作說明聊替。Java5.0定義的元注解:
1.@Target
2.@Retention
3.@Documented
4.@Inherited
這些類型和它們所支持的類在java.lang.annotation包中可以找到悦析。
- @Target:
? @Target說明了Annotation所修飾的對象范圍:Annotation可被用于 packages、types(類司光、接口琅坡、枚舉、Annotation類型)残家、類型成員(方法榆俺、構(gòu)造方法、成員變量、枚舉值)茴晋、方法參數(shù)和本地變量(如循環(huán)變量陪捷、catch參數(shù))。在Annotation類型的聲明中使用了target可更加明晰其修飾的目標诺擅。
? 作用:用于描述注解的使用范圍(即:被描述的注解可以用在什么地方)
取值(ElementType)有:
1.CONSTRUCTOR:用于描述構(gòu)造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部變量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述參數(shù)
7.TYPE:用于描述類市袖、接口(包括注解類型) 或enum聲明
- @Retention:
@Retention定義了該Annotation被保留的時間長短:某些Annotation僅出現(xiàn)在源代碼中,而被編譯器丟棄烁涌;而另一些卻被編譯在class文件中苍碟;編譯在class文件中的Annotation可能會被虛擬機忽略,而另一些在class被裝載時將被讀却橹础(請注意并不影響class的執(zhí)行微峰,因為Annotation與class在使用上是被分離的)。使用這個meta-Annotation可以對 Annotation的“生命周期”限制抒钱。
作用:表示需要在什么級別保存該注釋信息蜓肆,用于描述注解的生命周期(即:被描述的注解在什么范圍內(nèi)有效)
取值(RetentionPoicy)有:
1.SOURCE:在源文件中有效(即源文件保留)
2.CLASS:在class文件中有效(即class保留)
3.RUNTIME:在運行時有效(即運行時保留)
- @Documented:
? @Documented用于描述其它類型的annotation應(yīng)該被作為被標注的程序成員的公共API,因此可以被例如javadoc此類的工具文檔化继效。Documented是一個標記注解症杏,沒有成員。
- @Inherited:
? @Inherited 元注解是一個標記注解瑞信,@Inherited
闡述了某個被標注的類型是被繼承的。如果一個使用了@Inherited修飾的annotation類型被用于一個class穴豫,則這個annotation將被用于該class的子類凡简。
注意:@Inherited annotation
類型是被標注過的class的子類所繼承。類并不從它所實現(xiàn)的接口繼承annotation精肃,方法并不從它所重載的方法繼承annotation秤涩。
當(dāng)@Inherited annotation
類型標注的annotation的Retention是RetentionPolicy.RUNTIME
,則反射API增強了這種繼承性司抱。如果我們使用java.lang.reflect
去查詢一個@Inherited annotation
類型的annotation時筐眷,反射代碼檢查將展開工作:檢查class和其父類,直到發(fā)現(xiàn)指定的annotation類型被發(fā)現(xiàn)习柠,或者到達類繼承結(jié)構(gòu)的頂層匀谣。
順便舉個栗子
如何從任意一個對象中獲取想要的值?
有這樣一個注解聲明
package com.company;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* Created by zh on 16/6/5.
*/
@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Banner {
String value();
}
有這樣一個業(yè)務(wù)類
package com.company;
/**
* Created by zh on 16/6/5.
*/
public class Item {
@Banner("url")
public String url;
@Banner("title")
public String title;
public String other;
}
獲取Item對象指定值
package com.company;
import java.lang.reflect.Field;
public class Main {
public static void main(String[] args) {
// write your code here
Item item = new Item();
item.url = "http://www.mostring.com";
item.title = "Hallo";
printBanner(item);
Bn b = new Bn("test","http://ola.so");
printBanner(b);
}
public static void printBanner(Object object) {
Class cls = object.getClass();
Field[] fields = cls.getDeclaredFields();
for (Field f : fields) {
boolean isBannerAt = f.isAnnotationPresent(Banner.class);
if (!isBannerAt) {
continue;
}
Banner b = f.getAnnotation(Banner.class);
f.setAccessible(true);
try {
Object vla = f.get(object);
System.out.println(b.value() + "---" + vla);
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
}
}