没有什么事情比看到一个没有任何说明的@deprecated标注更让人愤怒的事情了.这种做法只能让人困惑,我到底还要不要用这个已经‘废弃’的方法?如果开发者不希望某个方法再被人用的话,就要好好地为@deprecated标注写说明.这篇文章就讨论了正确地使用@deprecated 标注需要遵守的一些规则. 什么是使用@Deprecated标注的规则? Rule #1: do Javadoc how not to 每当你弃用某方法时,创建JavaDoc告诉其他程序员如何不再使用这个方法.不要只说“这个
用@Deprecated注释的程序元素,不鼓励程序员使用这样的元素,通常是因为它很危险或存在更好的选择.在使用不被赞成的程序元素或在不被赞成的代码中执行重写时,编译器会发出警告. 那么相应的替代方法应该怎么看? 点进画删除线的方法,会看到.比如:直接提供替代的方法 @deprecated replaced by <code>getEncodingForIndex(int charsetIndex)</code> @deprecated Initialize the frame wi