Java 教程

Java 控制語句

面向物件程式設計

Java 內建類

Java 檔案處理

Java 錯誤和異常

Java 多執行緒

Java 同步

Java 網路程式設計

Java 集合

Java 介面

Java 資料結構

Java 集合演算法

高階 Java

Java 其他

Java API 和框架

Java 類引用

Java 有用資源

Java - 增強的 @Deprecated 註解



@Deprecated 註解是在 Java 5 版本中引入的。用 @Deprecated 註解的程式元素表示不應該使用它,原因如下:

  • 它的使用可能導致錯誤。
  • 它在將來的版本中可能不相容。
  • 它可能在將來的版本中被刪除。
  • 更好的更有效的替代方案已經取代了它。

每當使用已棄用的元素時,編譯器都會生成警告。從 Java 9 開始,對 @Deprecated 註解進行了兩項新的增強。

  • forRemoval - 指示被註解的元素是否可能在將來的版本中被移除。預設值為 false。

  • since - 返回被註解的元素何時被棄用的版本。預設值為空字串。

使用 since 的棄用

以下 Java 9 上 Boolean 類的 javadoc 示例說明了如何在 @Deprecated 註解上使用 since 屬性。

Boolean 類

Boolean Class javadoc

使用 forRemoval 的棄用

以下 Java 9 上 System 類的 javadoc 示例說明了如何在 @Deprecated 註解上使用 forRemoval 屬性。

System 類

System Class javadoc
廣告