注解,也稱為元數(shù)據(jù),為我們再代碼中添加信息提供了一種形式化的方法,使我們可以在稍后某個時刻非常方便地使用這些數(shù)據(jù)。
注解使得我們能夠以將由編譯器來測試和驗證的格式,存儲有關(guān)程序的額外信息。
java內(nèi)置的三種注解:
@Override,表示當(dāng)前的方法定義將覆蓋超類中的方法。如果你不小心拼寫錯誤,或者方法簽名對不上被覆蓋的方法,編譯器就會發(fā)出錯誤提示。
@Deprecated,如果程序員使用了注解為它的元素,那么編譯器會發(fā)出警告信息。
@SuppressWarnings,關(guān)閉不當(dāng)?shù)木幾g器警告信息
每當(dāng)創(chuàng)建描述符性質(zhì)的類或接口時,一旦其中包含了重復(fù)性的工作,那就可以考慮使用注解來簡化與自動化該過程。
20.1 基本語法
與java接口一樣,注解也將會編譯成class文件
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface Test {}
定義注解時,會需要一些元注解,如@Target和@Retention,@Target用來定義注解應(yīng)用在什么地方,例如是一個方法或者一個域。@Retention用來定義該注解在哪一個級別可用,在源代碼中,類文件中還是運行時。
注解的元素看起來就像接口的方法,唯一的區(qū)別是你可以為其制定默認值。沒有元素的注解稱為標記注解。
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface UseCase {
public int id();
public String description() default "no description";
}
20.2 編寫注解處理器
在使用注解的過程中,很重要的一個部分就是創(chuàng)建與使用注解處理器。
public class UseCaseTracker {
public static void trackUseCases(List<Integer> useCases, Class<?> cl) {
for (Method m : cl.getDeclaredMethods()) {
UseCase uc = m.getAnnotation(UseCase.class);
if (uc != null) {
System.out.println("Found Use Case:" + uc.id() + " " + uc.description());
useCases.remove(new Integer(uc.id()));
}
}
for (int i : useCases) {
System.out.println("Warning: Missing use case-" + i);
}
}
public static void main(String[] args) {
List<Integer> useCases = new ArrayList<Integer>();
Collections.addAll(useCases, 47, 48, 49, 50);
trackUseCases(useCases, PasswordUtils.class);
}
}
利用反射獲取使用注解對象的方法,然后調(diào)用id()和description()方法返回注解中定義的元素值。
注解元素可用的類型:
所以基本類型、String、Class、enum、Annotation、以上類型的數(shù)組。
元素不能有不確定的值,要么具有默認值,要么在使用注解時提供元素的值。對于非基本類型的元素,無論是在源代碼中聲明時,或是在注解接口中定義默認值是,都不能以null作為其值。為了繞開這個約束,只能定義一些特殊的值,例如空字符串或負數(shù),以此表示某個元素不存在
假設(shè)希望提供一些基本的對象/關(guān)系映射功能,能夠自動生成數(shù)據(jù)庫表,用以存儲javabean對象,使用注解的話,可以將所有信息都保存在javabean源文件中。
注解不支持繼承。