什么是不推荐的注释目标 - 实现，接口或两者兼而有之？

Question

嗨，我想知道是否必须在所有出现的情况下注释一个已弃用的方法，如Interface，Base（Abstract Class）和所有Implementation Classes，或者接口中的一个注释是否足够？

Answer 1

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

无论如何，

• 您无法在其他用户中确保/强制执行此操作
• 并非所有编译器/解析器都会发出警告或显示javadoc @deprecated标记

    

  使用@Deprecated注释来弃用类，方法或字段可确保所有编译器在代码使用该程序元素时发出警告。相反，不能保证所有编译器总是会发出基于@deprecated Javadoc标记的警告，尽管Sun编译器目前这样做。 其他编译器可能不会发出此类警告。因此，使用@Deprecated注释生成警告更加便携，依赖于@deprecated Javadoc标记。

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

来源1 2 3