Java9 @Deprecated註解

在java 5版本中引入了@deprecated註解。 使用@Deprecated注釋的程式元素意味著它不應該用於以下任何原因 -

• 它的使用可能會導致錯誤。
• 它可能在未來版本中不相容。
• 它可能在未來的版本中被刪除。
• 一個更好和更高效的替代方案已經取代它。

每當使用不推薦使用的元素時，編譯器會生成警告。 使用Java 9，對@Deprecated注釋進行了兩項新的增強。

• forRemoval - 指示注釋的元素是否在將來的版本中被刪除。 預設值是false。
• since - 返回注釋元素已過時的版本。 預設值是空字串。

Deprecated與since

以下Java 9上的布林類javadoc範例說明了在@Deprecated注釋中使用since屬性。
Boolean類since屬性的使用範例 - https://docs.oracle.com/javase/9/docs/api/java/lang/Boolean.html

Deprecated與forRemoval

Java 9上的System類javadoc的以下範例說明了在@Deprecated注釋中使用forRemoval屬性。

• https://docs.oracle.com/javase/9/docs/api/java/lang/System.html