java - "/* (non-javadoc)"有很好理解的含义吗?

标签 java comments javadoc

除了向源代码的读者指出注释 block 故意不是 Javadoc 注释之外,/* (non-javadoc) 是否有意义?最近看到很多这样的代码:

/*
 * (non-javadoc)
 *
 * This method converts widgets to gizmos
 */
public Foo bar() {
   ...

这是某种既定的惯例吗?如果是这样,它是什么意思(超出明显的字面意思)以及何时使用?

最佳答案

根据info I could find ,这是为了修复 JavaDoc 工具的旧版本(或更可能是 Eclipse 处理 JavaDoc 注释的旧版本)中的一个错误,该错误不会显示覆盖父类方法的方法的正确文档。

正如 Konstantin 所说,Eclipse 的覆盖模板包括此文本。

关于java - "/* (non-javadoc)"有很好理解的含义吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/4597329/

相关文章:

java - 将 DAO 类与应用程序实际实例化的 DAO 类分开的目的是什么

java - 为什么我看不到从 spring hibernate 程序提交到 Postgres 数据库的数据?

php - 在 PHP 和 MySql 中为每个 ID 创建一个评论框

java - Checkstyle 未检测到 @throws 标记

java - 如何记录 Java 方法的(简单)先决条件?

java - 从 Java 中的不同类追加到私有(private) TextArea

java - 如何从git存储库中读取具有不同扩展名的所有文件?

intellij-idea - 在 PyCharm 中用换行符包装注释

xcode - 在 Xcode 中自动生成方法注释

java - 如何将maven版本设置为Javadoc中的@version标签?