Java 9 改進的 @Deprecated 注解

Java 9 新特性 Java 9 新特性

注解 @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。

Java 9 新特性 Java 9 新特性