注解(Annotation)

（推薦教程：java入門教程）

• 從 JDK 5.0 開始, Java 增加了對元數(shù)據(jù)(MetaData) 的支持, 也就是Annotation(注解)

• Annotation 其實就是代碼里的特殊標記, 這些標記可以在編譯, 類加載, 運行時被讀取, 并執(zhí)行相應(yīng)的處理。通過使用 Annotation, 我們可以在不改變原有邏輯的情況下, 在源文件中嵌入一些補充信息。代碼分析工具、開發(fā)工具和部署工具可以通過這些補充信息進行驗證或者進行部署。

• Annotation 可以像修飾符一樣被使用, 可用于修飾包,類, 構(gòu)造器, 方法, 成員變量, 參數(shù), 局部變量的聲明, 這些信息被保存在 Annotation 的 “name=value” 對中。

• 在JavaSE中，注解的使用比較簡單，例如標記過時的功能，忽略警告等。在JavaEE/Android中注解占據(jù)了更重要的角色，例如用來配置應(yīng)用程序的任何切面，代替JavaEE舊版中所遺留的繁冗代碼和XML配置等。

• 未來的開發(fā)模式都是基于注解的，JPA是基于注解的，Spring2.5以上都是基于注解的，Hibernate3.x以后也是基于注解的，現(xiàn)在的Struts2有一部分也是基于注解的了，注解是一種趨勢。一定程度上可以說：框架 = 注解 + 反射 + 設(shè)計模式。

常見的注解

使用 Annotation 時要在其前面增加 @ 符號, 并把該 Annotation 當(dāng)成一個修飾符使用。用于修飾它支持的程序元素。

生成文檔相關(guān)的注解

• @author 標明開發(fā)該類模塊的作者，多個作者之間使用,分割

• @version 標明該類模塊的版本

• @see 參考轉(zhuǎn)向，也就是相關(guān)主題

• @since 從哪個版本開始增加的

• @param 對方法中某參數(shù)的說明，如果沒有參數(shù)就不能寫

• @return 對方法返回值的說明，如果方法的返回值類型是void就不能寫

• @exception 對方法可能拋出的異常進行說明 ，如果方法沒有用throws顯式拋出的異常就不能寫

（視頻教程：java視頻教程）

注意：

• @param @return 和 @exception 這三個標記都是只用于方法的。

• @param的格式要求：@param 形參名 形參類型 形參說明

• @return 的格式要求：@return 返回值類型 返回值說明

• @exception的格式要求：@exception 異常類型 異常說明

• @param和@exception可以并列多個

代碼示例：

/**  * @author wushanghui  * @date 2020/7/16 17:51  * @see Math  * @version	 1.0  *  */ public class JavadocAnnotation {      /**      * 程序的主方法，程序的入口      *      * @param args String[] 命令行參數(shù)      */     public static void main(String[] args) {         System.out.println(getArea(1.0d)); // 3.141592653589793     }       /**      * 求圓面積的方法      * @since 1.0      * @param radius double 半徑值      * @return double 圓的面積      */     public static double getArea(double radius) {         return Math.PI * radius * radius;     } }