用@Deprecated注释的程序元素,不鼓励程序员使用这样的元素,通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时,编译器会发出警告。
那么相应的替代方法应该怎么看?
点进画删除线的方法,会看到。比如:直接提供替代的方法
@deprecated replaced by <code>getEncodingForIndex(int charsetIndex)</code>
@deprecated Initialize the frame with the {@link Procframe.Initializer} that can be obtained by the {@link #initializer()}method.
如果没有直接的替代方法,往往也会提供其他方式。比如:使用另一种实现方式来替代该方法
@deprecated refresh datasource instead
这个指的是使用更新数据库的方式,来替代frame的refresh()方法
也可能有一些没有替代方法的,比如:预定在下一个版本取消
@deprecated in POI 3.14, scheduled for removal in POI 3.16
其次,请注意标题,这两个标记有大小写之分,一个是D,一个是d。
源代码标记@Deprecated是在JDK1.5中作为内置的annotation引入的,用于表明类(class)、方法(method)、字段(field)已经不再推荐使用,并且在以后的JDK版本中可能将其删除,编译器在默认情况下检测到有此标记的时候会提示警告信息。
Java注释中的@deprecated用于在用Javadoc工具生成文档的时候,标注此类/接口、方法、字段已经被废止。
把每一件简单的事情做好,就是不简单;把每一件平凡的事情做好,就是不平凡!相信自己,创造奇迹~~