Java 內(nèi)置注釋

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

內(nèi)置注釋

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

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

@Retention

@Retention被設(shè)計(jì)為僅用作另一個(gè)注釋的注釋。它指定保留策略。

@Documented

@Documented注釋是一個(gè)標(biāo)記界面，它通知工具要注釋標(biāo)記。

@Target

@Target 注釋指定了聲明的類型可以應(yīng)用注釋。

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

目標(biāo)常量注釋可以應(yīng)用于

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

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

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

@Inherited

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

@Override

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

@Deprecated

@Deprecated是標(biāo)記注釋。它表示聲明已過(guò)時(shí)，并已被較新的表單替換。

@SuppressWarnings

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