一. 最常見的annotation
•@Override:用在方法之上，用來告訴別人這一個方法是改寫父類別的
•@Deprecated:建議別人不要使用舊的API的時候用的,編譯的時候會用產生警告訊息,可以設定在程式裡的所有的元素上.
•@SuppressWarnings:暫時把一些警告訊息訊息關閉
•@Entity:表示該類別是可持久化的類
二. 設計一個自己的Annotation
先看程式碼再講話
1. 只有一個參數的Annotation實現
複製代碼代碼如下:
package chb.test.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 MyAnnotation1 {
String value();
}
2. 有兩個參數的Annotation實現
複製代碼代碼如下:
package chb.test.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 MyAnnotation2 {
String description();
boolean isAnnotation();
}
3. Annotation實驗類
複製代碼代碼如下:
package chb.test.annotation;
@MyAnnotation1("this is annotation1")
public class AnnotationDemo {
@MyAnnotation2(description="this is annotation2",isAnnotation=true)
public void sayHello(){
System.out.println("hello world!");
}
}
4.Annotation測試說明類
複製代碼代碼如下:
package chb.test.annotation;
import java.lang.reflect.Method;
import org.junit.Test;
public class TestAnnotation {
@Test
public void test() throws ClassNotFoundException, SecurityException, NoSuchMethodException{
Class<?> cls = Class.forName("chb.test.annotation.AnnotationDemo");
boolean flag = cls.isAnnotationPresent(MyAnnotation1.class);
if(flag){
System.out.println("判斷類別是annotation");
MyAnnotation1 annotation1 = cls.getAnnotation(MyAnnotation1.class);
System.out.println(annotation1.value());
}
Method method = cls.getMethod("sayHello");
flag = method.isAnnotationPresent(MyAnnotation2.class) ;
if(flag){
System.out.println("判斷方法也是annotation");
MyAnnotation2 annotation2 = method.getAnnotation(MyAnnotation2.class);
System.out.println(annotation2.description()+"/t"+annotation2.isAnnotation());
}
}
}
實驗結果，控制台打出以下資訊：
判斷類是annotation
this is annotation1
判斷法也是annotation
this is annotation2 true
三.簡介及說明
1. MyAnnotation1中的@Target(ElementType.TYPE)
＠Target裡面的ElementType是用來指定Annotation類型可以用在哪些元素上的.例如：
TYPE(類型)、FIELD(屬性)、METHOD(方法)、PARAMETER(參數)、CONSTRUCTOR(建構子)、LOCAL_VARIABLE(局部變數),、PACKAGE(套件),其中的TYPE(類型)是指可以用在Class ,Interface,Enum和Annotation類型上。
2. MyAnnotation1中的@Retention(RetentionPolicy.RUNTIME)
RetentionPolicy 共有三種策略，分別為：
•SOURCE:這個Annotation類型的資訊只會保留在程式原始碼裡，原始碼如果經過了編譯之後，Annotation的資料就會消失,並不會保留在編譯好的.class檔案裡面
•CLASS:這個Annotation類型的資訊保留在程式原始碼裡,同時也會保留在編譯好的.class檔案裡面,在執行的時候，並不會把這些資訊載入到JVM中。註：預設策略為CLASS類型
•RUNTIME:表示在原始碼、編譯好的.class檔案中保留訊息，在執行的時候會把這一些訊息載入到JVM中去的
3. MyAnnotation1中的@Documented
目的就是將這一Annotation的資訊顯示在JAVA API文件上，如果沒有增加@Documented的話，JAVA API文件上不會顯示相關annotation信息
4. MyAnnotation1中的@interface
關鍵字，表示該類別為Annotation定義
5. MyAnnotation1中的String value();
表示有一個成員參數，名字為value，存取權為預設(default)修飾符，注意以下兩點：
•存取權只能用public和預設（default）修飾
•參數成員只能用基本型別byte,short,char,int,long,float,double,boolean八種基本資料型別和String,Enum,Class,annotations等資料型別,以及這一些型別的陣列
6.AnnotationDemo中的@MyAnnotation1("this is annotation1")
因為MyAnnotation1只有一個參數，因此可以直接在括號中寫上value值。注意：如果Annotation只有一個參數，則建議最好將該參數名稱定義為value
7.TestAnnotation中的cls.isAnnotationPresent(MyAnnotation1.class)
判斷該類別是否使用了MyAnnotation1的註釋
8. TestAnnotation中的MyAnnotation1 annotation1 = cls.getAnnotation(MyAnnotation1.class)
傳回該類別針對MyAnnotation1的註釋
9. TestAnnotation中的method.isAnnotationPresent(MyAnnotation2.class)
判斷方法是否使用了MyAnnotation2的註釋