Answers:
建议不要使用Java中的类,方法或字段的方法是使用@Deprecated
注释(该注释在Java 5中可用)或@deprecated
JavaDoc标记(自Java 1.1开始就存在)。Oracle有一个文档,说明有关如何以及何时弃用似乎相关的API的细节。
我应该删除添加到类顶部的先前注释,以帮助其他程序员了解该类的用途还是将其添加到注释下方?
除了添加JavaDoc标记或注释之外,您不应编辑或删除任何现有注释。不推荐使用的代码可能仍在旧系统中使用,这些系统的开发人员需要访问原始开发人员以某种形式所做的文档。
@Deprecated
注释或@deprecated
JavaDoc标记。就是这样-仅此而已。
@deprecated
JavaDoc标签和说明以及@Deprecated
注释将使人们更了解为什么不推荐使用它。因此,使用两者而不是仅使用@Deprecated
注释会更加有益。