<!-- Annotations --> # 第二十三章 注解 注解（也被稱為元數據）為我們在代碼中添加信息提供了一種形式化的方式，使我們可以在稍后的某個時刻更容易的使用這些數據。 注解在一定程度上是把元數據和源代碼文件結合在一起的趨勢所激發的，而不是保存在外部文檔。這同樣是對像 C# 語言對于 Java 語言特性壓力的一種回應。 注解是 Java 5 所引入的眾多語言變化之一。它們提供了 Java 無法表達的但是你需要完整表述程序所需的信息。因此，注解使得我們可以以編譯器驗證的格式存儲程序的額外信息。注解可以生成描述符文件，甚至是新的類定義，并且有助于減輕編寫“樣板”代碼的負擔。通過使用注解，你可以將元數據保存在 Java 源代碼中。并擁有如下優勢：簡單易讀的代碼，編譯器類型檢查，使用 annotation API 為自己的注解構造處理工具。即使 Java 定義了一些類型的元數據，但是一般來說注解類型的添加和如何使用完全取決于你。 注解的語法十分簡單，主要是在現有語法中添加 @ 符號。Java 5 引入了前三種定義在 **java.lang** 包中的注解： - **@Override**：表示當前的方法定義將覆蓋基類的方法。如果你不小心拼寫錯誤，或者方法簽名被錯誤拼寫的時候，編譯器就會發出錯誤提示。 - **@Deprecated**：如果使用該注解的元素被調用，編譯器就會發出警告信息。 - **@SuppressWarnings**：關閉不當的編譯器警告信息。 - **@SafeVarargs**：在 Java 7 中加入用于禁止對具有泛型varargs參數的方法或構造函數的調用方發出警告。 - **@FunctionalInterface**：Java 8 中加入用于表示類型聲明為函數式接口 還有 5 種額外的注解類型用于創造新的注解。你將會在這一章學習它們。 每當創建涉及重復工作的類或接口時，你通常可以使用注解來自動化和簡化流程。例如在 Enterprise JavaBean（EJB）中的許多額外工作就是通過注解來消除的。 注解的出現可以替代一些現有的系統，例如 XDoclet，它是一種獨立的文檔化工具，專門設計用來生成注解風格的文檔。與之相比，注解是真正語言層級的概念，以前構造出來就享有編譯器的類型檢查保護。注解在源代碼級別保存所有信息而不是通過注釋文字，這使得代碼更加整潔和便于維護。通過使用拓展的 annotation API 或稍后在本章節可以看到的外部的字節碼工具類庫，你會擁有對源代碼及字節碼強大的檢查與操作能力。