单元测试类中的测试方法可能是不言自明的最常见例子了,我们通常可以从这些方法的描述性命名中知道它是干什么的,因此不需要额外的文档说明 。
Tip:7.3.2 例外:重载如果一个方法重载了超类中的方法,那么Javadoc并非必需的 。
如果有一些相关信息是需要读者了解的,那么以上的例外不应作为忽视这些信息的理由 。例如,对于方法名getCanonicalName, 就不应该忽视文档说明,因为读者很可能不知道词语canonical name指的是什么 。
7.3.3 可选的Javadoc对于包外不可见的类和方法,如有需要,也是要使用Javadoc的 。如果一个注释是用来定义一个类,方法,字段的整体目的或行为, 那么这个注释应该写成Javadoc,这样更统一更友好 。
推荐阅读
- JavaScript 里的奇葩知识
- 对于 JavaScript 中循环之间的技术差异概述
- 推荐5个爆款Java开源博客,是我目前用过最好用的博客系统
- 为什么Java类不支持多继承而接口可以?
- 如何利用Java代码操作索引库?
- Java8——异步编程
- Java如何判断一个字符串中某个字符出现的次数?
- 开源JavaScript实用日期处理库——date-fns
- java 伪共享 False Sharing
- Java15的新特性
