「java废弃注释」java废弃注解

博主:adminadmin 2022-11-22 20:20:07 62

今天给各位分享java废弃注释的知识,其中也会对java废弃注解进行解释,如果能碰巧解决你现在面临的问题,别忘了关注本站,现在开始吧!

本文目录一览:

java中怎么把一整段注释掉?怎么去掉注释符?

选中代码 ctrl+/ 是每一行代码前面加注释 //

ctrl+shift+/ 是/* */注释

取消是同样的操作,已有注释的就会取消没有就会加注释(前提是你已经设置了快捷键,我说的这些是默认的快捷键eclipse中的)

java @注解 可以删除吗

java@注解可以删除。

如果是自己写的代码觉得特别没用了可以删掉,如果是别人的,或者是修改需求什么的可以不用删,当你在改代码把以前的注掉时写个备注说明,以防以后再需要或者是想看下之前的想法。所以最好不要删掉。

简单性:

Java看起来设计得很像C++,但是为了使语言小和容易熟悉,设计者们把C++语言中许多可用的特征去掉了,这些特征是一般程序员很少使用的。例如,Java不支持goto语句,代之以提供break和continue语句以及异常处理。

Java还剔除了C++的操作符过载(overload)和多继承特征,并且不使用主文件,免去了预处理程序。因为Java没有结构,数组和串都是对象,所以不需要指针。Java能够自动处理对象的引用和间接引用,实现自动的无用单元收集。

java中 把一整段注释掉 有什么方法?? 相反的 把注释掉的代码前的注释符去掉 有什么方法??

需要一个标识符,标识多行注释是否开始

读取一行:

(1)判断此行内是否包含“/*“,如果包含,定位到“/*“第一个字符,并标识多行注释开始,继续判断当前读取行是否包含"*/",如果包含,注释部分删除,其他写回文件,未包含删除,及以后的只判断多行结束,直至判断到多行注释结束,把注释部分删除

(2)多行注释未开始,则判断此行内是否包含“//“,如果包含,定位到“//“第一个字符,把后面的全部删除,注意多行注释开始的当前行,还要再判断一次“//“,因为java支持以下注释

//单行注释/*

*多行注释

*/

其实在代码当中适当加点注释,对自己、别人阅读代码以及以后维护都是有好处的,没必要删除全部的注释,而且编译会跳过注释部分,就算你把一部武侠小说加到代码注释里,也不会影响编译出来的文件大小的

如何正确地使用Java的@deprecated 标注

Rule #1: do Javadoc how not to

每当你弃用某方法时,创建JavaDoc告诉其他程序员如何不再使用这个方法。不要只说“这个方法废弃了,不要用它”。因为这就是废弃标注和JavaDoc中@deprecated的字面意义,完全没有必要再重复一遍。Java开发人员作为目标受众,都知道deprecation的意思。

命名新的方法,取代旧有的。(使用@link标注!)这可能还不够,新的方法对应的文档将解释如何使用它。不要在JavaDoc中重复(其字面意义),文档也应遵从DRY原则。另一方面你可能想要描述怎样替换掉旧方法的调用,你可以就重构的细节给出提示。

Rule #2: do not Javadoc how to

移除过时的JavaDoc文档。有些人可能争辩:维护遗留代码的用户可能还会需要这些文档。事实上,他们使用的是旧版本库中的旧版本方法。旧版本的文档仍旧存在那里,像被刻在石头上(更确切的说是刻在资源仓库的某个版本上)。含有被废弃掉的方法的实际版本不应包含过时的描述文档,那会鼓励程序员去继续使用。对于废弃的方法,只有一种用法:不去用。JavaDoc应该被实时描述,如同rule#1所述。

Rule #3: 不要在JavaDoc中解释

不要在JavaDoc中解释为什么方法被废弃了。你是一个可靠的的开发,这是你的决定,你的选择,其他人只能忍着。如果愿意,可以写一篇博客记录这次调整的决策背景。这可能有帮助,但它不应被写在JavaDoc中。

JavaDoc的Deprecated API专用来讲解如何不再使用。

重点是如何(how)。而不是“为什么不再使用它(why)”。

Rule #4: do deprecate

如果你觉得需要弃用一方法,那就去做吧!如果你害怕你的用户,或不想因你废弃掉一些方法导致你用户体验更加痛苦,这个决定将让你自己痛苦。尽你所能去让API维持长久的稳定。但如果有需要被废弃的:立刻扔掉它。不要因“为何当初设计API时没有考虑到未来的变动”而感到愧疚。没有人能完美的预见未来。毕竟,如果你知道未来,生活就无趣了。

请列出java中的注释

在Java里面主要有三种注释:行注释、段落注释、文档注释

1)行注释:行注释也成为单行注释,行注释使用 “//注释文字”的格式来对某一行的代码进行注释或者加以说明

2)段注释:段注释也成为多行注释,通常是当说明文字比较长的时候的注释方法

3)文档注释:文档注释是Java里面的一个比较厉害的功能,它可以用于注释类、属性、方法等说明,而且通过JDK工具javadoc直接生成相关文档,文档注释的基本格式为“/**...*/”,不仅仅如此,文档注释本身还存在语法

java废弃注释的介绍就聊到这里吧,感谢你花时间阅读本站内容,更多关于java废弃注解、java废弃注释的信息别忘了在本站进行查找喔。

The End

发布于:2022-11-22,除非注明,否则均为首码项目网原创文章,转载请注明出处。