千锋教育-做有情怀、有良心、有品质的职业教育机构

手机站
千锋教育

千锋学习站 | 随时随地免费学

千锋教育

扫一扫进入千锋手机站

领取全套视频
千锋教育

关注千锋学习站小程序
随时随地免费学习课程

当前位置:首页  >  技术干货  > Java基础中注释添加的位置以及原则详解

Java基础中注释添加的位置以及原则详解

来源:千锋教育
发布人:wjy
时间: 2022-08-10 10:45:00 1660099500

  1.添加注释的位置

  (1)类,接口

  这一部分注释是必须的。在这里,我们需要使用javadoc注释,需要标明,创建者,创建时间,版本,以及该类的作用。

  (2)方法

  在方法中,我们需要对入参,出参,以及返回值,均要标明。

  (3)常量

  对常量,我们需要使用多行注释,进行标明该常量的用途,如下所示:

  (4)关键算法上

  在关键算法上,添加注释并且按照顺序依次标明,写明白该方法为什么这么做。

Java基础中注释添加的位置以及原则详解

  2.添加注释的原则

  (1)注释形式统一

  在整个应用程序中,使用具有一致的标点和结构的样式来构造注释。如果在其它项目中发现它们的注释规范与这份文档不同,按照这份规范写代码,不要试图在既成的规范系统中引入新的规范。

  (2)注释内容准确简洁

  内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。

  在之前的文章中学习了不少关于java注释的方式以及快捷操作,有些人还不清楚应该注释的位置,以及注释时需要注意的原则。注释位置为类,接口、方法、常量、关键算法,原则有注释形式统一和注释内容准确简洁。以上就是我们在Java基础中注释添加位置以及原则的详解,学会了的小伙伴在使用java注释时一定要时时牢记,本篇内容到这里就结束啦。

  推荐操作环境:windows7系统、java10版,DELL G3电脑。

  更多关于“Java培训”的问题,欢迎咨询千锋教育在线名师。千锋已有十余年的培训经验,课程大纲更科学更专业,有针对零基础的就业班,有针对想提升技术的好程序员班,高品质课程助力你实现java程序员梦想。

tags:
声明:本站稿件版权均属千锋教育所有,未经许可不得擅自转载。
10年以上业内强师集结,手把手带你蜕变精英
请您保持通讯畅通,专属学习老师24小时内将与您1V1沟通
免费领取
今日已有369人领取成功
刘同学 138****2860 刚刚成功领取
王同学 131****2015 刚刚成功领取
张同学 133****4652 刚刚成功领取
李同学 135****8607 刚刚成功领取
杨同学 132****5667 刚刚成功领取
岳同学 134****6652 刚刚成功领取
梁同学 157****2950 刚刚成功领取
刘同学 189****1015 刚刚成功领取
张同学 155****4678 刚刚成功领取
邹同学 139****2907 刚刚成功领取
董同学 138****2867 刚刚成功领取
周同学 136****3602 刚刚成功领取
相关推荐HOT