Java教程 - 什么是Java內(nèi)置注釋

內(nèi)置注釋

Java定義了許多內(nèi)置注釋。大多數(shù)是專門的，但七是通用的。

• @Retention
• @Documented
• @Target
• @Inherited
• @Override
• @Deprecated
• @SuppressWarnings

@Retention

@Retention被設計為僅用作另一個注釋的注釋。它指定保留策略。

@Documented

@Documented注釋是一個標記界面，它通知工具要注釋標記。

@Target

@Target 注釋指定了聲明的類型可以應用注釋。

它被設計為僅用作對另一注釋的注釋。 @Target接受一個參數(shù)，它必須是ElementType枚舉的常量。

目標常量注釋可以應用于

• ANNOTATION_TYPE另一個注釋
• CONSTRUCTOR 構造函數(shù)
• FIELD 領域
• LOCAL_VARIABLE 局部變量
• METHOD 方法
• PACKAGE 包
• PARAMETER 參數(shù)
• TYPE 類, 接口, 或者 枚舉

您可以在@Target注釋中指定一個或多個這些值。 要指定多個值，必須在括號分隔列表中指定它們。 例如：

@Target( { ElementType.FIELD, ElementType.LOCAL_VARIABLE } )

@Inherited

@Inherited 是一個標記注釋，只能用于另一個注釋聲明。它只影響將在類聲明中使用的注釋。 @Inherited 使得超類的注釋由子類繼承。

@Override

@Override是只能在方法上使用的標記注釋。使用@Override注釋的方法必須覆蓋超類中的方法。

@Deprecated

@Deprecated是標記注釋。它表示聲明已過時，并已被較新的表單替換。

@SuppressWarnings

@SuppressWarnings 指定可能由編譯器發(fā)出的一個或多個警告被抑制。要禁止的警告由名稱以字符串形式指定。此注釋可應用于任何類型的聲明。