Java 9 @Deprecated 注解增强：forRemoval 与 since 属性

增强动机

@Deprecated 自 Java 5 起存在，但仅标记“不推荐使用”，未区分“将来会移除”还是“仅建议迁移”。Java 9 新增两个属性提供语义精度：

forRemoval()：boolean，默认 false。true 表示计划在未来版本移除，迁移紧迫性高。
since()：String，默认 ""。标记废弃起始版本（如 "9"），便于工具生成迁移时间线。

注解定义

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, MODULE, PARAMETER, TYPE})
public @interface Deprecated {
    String since() default "";
    boolean forRemoval() default false;
}

标准库示例

Boolean 类：since 属性

@Deprecated(since="9")
public static Boolean valueOf(String s) { ... }

标明自 Java 9 起废弃，建议使用 Boolean.parseBoolean() 或 valueOf(boolean)。

System 类：forRemoval 属性

@Deprecated(forRemoval=true, since="9")
public static void runFinalizersOnExit(boolean value) { ... }

标明将在未来版本移除，且自 Java 9 起废弃，调用者应立即迁移。

工具链支持

javac 编译时：forRemoval=true 触发更强烈警告（-Xlint:removal）。
jdeprscan：扫描项目中使用的废弃 API，可按 --for-removal 过滤高风险项。
IDE（IntelliJ IDEA、Eclipse）在编辑器中区分显示：删除线（普通废弃）vs 红色波浪线/删除线+图标（计划移除）。
文档生成：Javadoc 自动在废弃条目显示 “Since: 9”、“For Removal: true”。

最佳实践

库作者：新废弃 API 显式标注 @Deprecated(since="X", forRemoval=true/false)。
应用开发者：启用 -Xlint:deprecation,removal 编译检查，定期运行 jdeprscan。
优先处理 forRemoval=true 的调用点，制定迁移计划。
配合 @since 文档标签，保持源码与注解一致。

Java 9 try-with-resources 改进：Effectively-final 变量直接使用 Java 9 菱形操作符扩展：匿名内部类也能用 <> 推断

java