问我自己不赞成的注解

EN

@Deprecated注释是为开发环境设计的(通常，但不只是这样)。它本身什么也做不了。但是对于IDE来说，它是某种标记，当它“看到”那个注释时，它执行一些逻辑(例如，“清除”代码)。我的文章的目的是告诉我们，仅仅开发和使用注释是不够的:它必须得到环境的支持。

你可以做两件事：

将@Deprecated注释添加到方法中，并向方法的javadoc添加@deprecated标记。

你应该两样都做！

引用有关此主题的java文档：

从J2SE 5.0开始，您可以使用@Deprecated注释取消类、方法或字段的推荐。此外，您还可以使用@deprecated标记来告诉开发人员应该使用什么。

使用注释会使Java编译器在使用不推荐的类、方法或字段时生成警告。如果不推荐的编译单元使用不推荐的类、方法或字段，则编译器将取消推荐的警告。这使您能够在不生成警告的情况下构建遗留API。

强烈建议您使用Javadoc @deprecated标记，并附带适当的注释，说明如何使用新的API。这将确保开发人员有一个从旧API到新API的可行迁移路径。

在查看不推荐注释的源代码时，您将看到没有什么特别的东西可以使它在删除时显示出来。它是IDE的一个特性，它可以用删除标记@Deprecated代码。

下面是：

@Documented
@Retention(RetentionPolicy.RUNTIME)
public @interface Deprecated {
}