Java 9 增强的@Deprecated注解

  @Deprecated注解是在Java 5中引入的。用@Deprecated注释的程序元素意味着它不应用于以下任何原因

•   它的使用可能会导致错误。

•   它在未来版本中可能不兼容。

•   它可能会在未来版本中被删除。

•   已经有更好更有效的替代方案取代它。

  每当使用过时的元素时，编译器都会生成警告。在Java 9中，对@Deprecated注释进行了两项新的增强。

•   forRemoval：指示注释元素是否会在未来版本中被移除。默认值为false。

•   since：返回注释元素被弃用的版本。默认值为空字符串。

基于since的Deprecated注解

  以下Java 9上的Boolean类javadoc示例说明了在@Deprecated注释上使用since属性。

基于forRemoval的Deprecated注解

Following example of System class javadoc on Java 9 illustrate the use of forRemoval attribute on @Deprecated annotation.

  以下Java 9上的System类javadoc示例说明了forRemoval属性在@Deprecated注释上的使用。