注解 @Deprecated 可以標(biāo)記 Java API 狀態(tài),可以是以下幾種:
• 使用它存在風(fēng)險,可能導(dǎo)致錯誤
•可能在未來版本中不兼容
• 可能在未來版本中刪除
• 一個更好和更高效的方案已經(jīng)取代它。
Java 9 中注解增加了兩個新元素:since 和 forRemoval。
• since: 元素指定已注解的API元素已被棄用的版本。
• forRemoval: 元素表示注解的 API 元素在將來的版本中被刪除,應(yīng)該遷移 API。
以下實例為 Java 9 中關(guān)于 Boolean 類的說明文檔,文檔中 @Deprecated 注解使用了 since 屬性:Boolean Class。
以下實例為在 Java 9 中關(guān)于系統(tǒng)類的說明文檔,文檔中 @Deprecated 注解使用了 forRemoval 屬性:System Class。