Java注释中的@deprecated与源代码中的@Deprecated

发布时间:2017-7-1 11:43:32编辑:www.fx114.net 分享查询网我要评论
本篇文章主要介绍了"Java注释中的@deprecated与源代码中的@Deprecated ",主要涉及到Java注释中的@deprecated与源代码中的@Deprecated 方面的内容,对于Java注释中的@deprecated与源代码中的@Deprecated 感兴趣的同学可以参考一下。

Java注释中的@deprecated与源代码中的@Deprecated

用 @Deprecated注释的程序元素,不鼓励程序员使用这样的元素,通常是因为它很危险或存在更好的选择。在使用不被赞成的程序元素或在不被赞成的代码中执行重写时,编译器会发出警告。
   

    其次,请注意标题,这两个标记有大小写之分,一个是D,一个是d

源代码标记@Deprecated是在JDK1.5中作为内置的annotation引入的,用于表明类(class)、方法(method)、字段(field)已经不再推荐使用,并且在以后的JDK版本中可能将其删除,编译器在默认情况下检测到有此标记的时候会提示警告信息。

Java注释中的@deprecated用于在用Javadoc工具生成文档的时候,标注此类/接口、方法、字段已经被废止。

不过后者还有一个功能就是和源代码标记@Deprecated同样的功能,在JDK1.4版本之后,该功能被@Deprecated所取代。

   

java.lang.Deprectated是J2SE 5.0中标准的Annotation型态之一,它对编译器说明某个方法已经不建议使用,如果有人试图使用或重新定义该方法,必须提出警示讯息。

举个例子来说,您可能定义一个CustomObject类别,并在当中定义有getSomething()方法,而在一段时间之后,您不建议使用这个方法 了,并要将这个方法标示为deprectated,您可以这么作:

CustomObject.java
public class CustomObject {	@Deprecated public String getSomething() {		return "something";	}}

如果有人试图在继承这个类别后重新定义getSomething(),或是在程序中呼叫使用getSomething()方法,则进行编译时,就会出现这 个警讯:

Note: SubCustomObject.java uses or overrides a deprecated API.Note: Recompile with -Xlint:deprecation for details.


上一篇:参数化曲面的绘制
下一篇:KRPANO开发拍摄拼图视频常用软件分享

相关文章

相关评论

本站评论功能暂时取消,后续此功能例行通知。

一、不得利用本站危害国家安全、泄露国家秘密,不得侵犯国家社会集体的和公民的合法权益,不得利用本站制作、复制和传播不法有害信息!

二、互相尊重,对自己的言论和行为负责。

好贷网好贷款