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