什么是已弃用的注释目标 - 实现、接口或两者？

Question

我想知道，是否必须在所有出现的地方注释一个

@Deprecated

方法，例如：接口、基础（抽象类）和所有实现类，或者接口中的一个注释就足够了？

Answer 1

实际上取决于如何使用已弃用的类。如果您使用良好实践（实例化接口以使用实现），弃用接口（方法或属性）就足够了。

无论如何，

• 您无法确保/强制其他用户进行这种做法
• 并非所有编译器/解析器都会抛出警告或显示 javadoc

  @deprecated

  标签

  使用

  @Deprecated

  注释来弃用类、方法或字段可确保所有编译器在代码使用该程序元素时发出警告。相比之下，不能保证所有编译器总是会根据

  @deprecated

  Javadoc 标记发出警告，尽管 Sun 编译器目前这样做。 其他编译器可能不会发出此类警告。因此，使用 @Deprecated 注解生成警告比依赖 @deprecated Javadoc 标记更可移植。

---

恢复：如果您想弃用方法实现，则必须同时弃用接口和实现。

来源 1 2 3