常見的Java註解有哪些

註解(Annotation)

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

• 從JDK 5.0 開始, Java 增加了對元資料(MetaData) 的支援, 也就是Annotation(註解)

• Annotation 其實就是程式碼裡的特殊標記, 這些標記可以在編譯, 類別加載, 運行時被讀取, 並執行對應的處理。透過使用 Annotation, 我們可以在不改變原有邏輯的情況下, 在來源文件中嵌入一些補充資訊。程式碼分析工具、開發工具和部署工具可以透過這些補充資訊進行驗證或部署。

• Annotation 可以像修飾符一樣被使用, 可用於修飾套件,類別, 建構器, 方法, 成員變數, 參數, 局部變數的宣告, 這些資訊被保存在Annotation 的“name=value” 對中。

• 在JavaSE中，註解的使用比較簡單，例如標記過時的功能，忽略警告等。在JavaEE/Android中註解佔據了更重要的角色，例如用來配置應用程式的任何切面，取代JavaEE舊版中所遺留的繁冗餘程式碼和XML配置等。

• 未來的開發模式都是基於註解的，JPA是基於註解的，Spring2.5以上都是基於註解的，Hibernate3.x以後也是基於註解的，現在的Struts2有一部分也是基於註解的了，註解是一種趨勢。一定程度可以說：框架 = 註解 反射 設計模式。

常見的註解

使用 Annotation 時要在其前面增加 @ 符號, 並把該 Annotation 當成一個修飾符使用。用於修飾它支援的程式元素。

產生文件相關的註解

• @author 標示開發該類別模組的作者，多個作者之間使用,分割

• @version 標示該類別模組的版本

• @see 參考轉向，也就是相關主題

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

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

• @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[] 命令行参数
     */
    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;
    }
}

以上是常見的Java註解有哪些的詳細內容。更多資訊請關注PHP中文網其他相關文章！