【发布时间】:2013-04-01 16:44:01
【问题描述】:
我使用 Lombok 项目,但 getter 和 setter 没有 JavaDoc。
如何激活此选项?
【问题讨论】:
-
在这些方法上使用 JavaDoc 的意义在于,它们可以解释通常如何使用该字段或链接到相关字段。尽管在大多数情况下,名称应该具有足够的描述性,但我已经阅读了我的部分代码,其中字段的用途不明显,或者 setter 修改了其他行为。此外,它是一个注释空值合法性的地方。
我使用 Lombok 项目,但 getter 和 setter 没有 JavaDoc。
如何激活此选项?
【问题讨论】:
0.12.0 版本中有一个初始实现。默认情况下,该字段上的 javadoc 的整个内容将被复制到 getter 和 setter。 Getter 将获得返回位;设置参数位。这些将从现场的 javadoc 中删除。使用部分,您甚至可以指定不同的 getter/setter javadoc。
这仅在您在生成 javadoc 之前对代码进行 delombok 时有效,并且可能永远不会在 eclipse 中工作。
有关当前语法,请查看feature requests 文档。
完全披露:我是Project Lombok 开发人员之一。
【讨论】: