《Thanking in Java》20. 注解

注解,也稱為元數(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源文件中。

注解不支持繼承。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 什么是注解(Annotation):Annotation(注解)就是Java提供了一種元程序中的元素關(guān)聯(lián)任何信息和...
    九尾喵的薛定諤閱讀 3,405評論 0 2
  • 本文章涉及代碼已放到github上annotation-study 1.Annotation為何而來 What:A...
    zlcook閱讀 29,747評論 15 116
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,545評論 19 139
  • 整體Retrofit內(nèi)容如下: 1、Retrofit解析1之前哨站——理解RESTful 2、Retrofit解析...
    隔壁老李頭閱讀 8,784評論 4 31
  • 今晚看了一本很有意思的書——《萬物既聰慧又奇妙》,一時沒剎住,沒來得及好好畫畫。 但畢竟這是一件承諾了每天都做的事...
    哆啦有只大兔子閱讀 442評論 5 2

友情鏈接更多精彩內(nèi)容