有哪些常見的Java注解

有哪些常見的Java注解？很多新手對此不是很清楚，為了幫助大家解決這個難題，下面小編將為大家詳細(xì)講解，有這方面需求的人可以來學(xué)習(xí)下，希望你能有所收獲。

注解(Annotation)

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

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

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

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

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

常見的注解

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

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

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

• @version 標(biāo)明該類模塊的版本

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

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

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

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

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

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

注意：

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

• @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;
    }
}

看完上述內(nèi)容是否對您有幫助呢？如果還想對相關(guān)知識有進(jìn)一步的了解或閱讀更多相關(guān)文章，請關(guān)注億速云行業(yè)資訊頻道，感謝您對億速云的支持。