无法在具有 onmethod 属性的 lombok setters/getters 上生成 JavaDoc

Question

我正在尝试为一个利用 lombok 的项目生成 JavaDoc，但在我对生成的 setter 和 getter 进行注释的情况下遇到问题。

代码：

public class Car {
  @Getter(onMethod = @__(@Sensitive))
  @Setter(onMethod = @__(@Sensitive))
  @Sensitive
  @ToString.Exclude
  @Transient
  protected transient String instanceKeyId;

还有，我是运行宁：

mvn javadoc:attach-javadocs

当我这样做时，我得到这个错误：

[ERROR] Exit code: 1 - Car.java:26: error: cannot find symbol
[ERROR]   @Getter(onMethod = @__(@Sensitive))

我在 Java 11 - 我的项目正在构建并且运行。我有最新版本的 javadoc 插件，我是不是还遗漏了什么？

听起来我需要听从这里的建议并设置 delombok，然后在看起来有点无关的东西上做 javadoc。这是此处所需的工作流程，还是有其他方法可以做到这一点？

Answer 1

简短的回答是：不，您最多可以编写脚本，例如在您的构建系统中使用一个插件，该插件首先 delomboks 然后 javadocs。

未来还有希望吗？ lombok 的 onMethod 位是一个不幸的 hack，解决了 javac 中的错误（oracle 开发团队不承认的错误，因此它们不太可能被修复，并且没有 TCK 规则可以证明它们；TCK 通常对注释相当轻）。 lombok 团队也试图通过添加 'any annotation' 功能来解决这个问题，作为对 java 语言规范的一个非常小的升级，但由于不明确的原因被拒绝了（具体来说，原因是：没有时间了（这是在新的 6 个月节奏之前），尽管后来提出并构建了多注释功能，证明这是一个不正确的原因。如果我不得不猜测，原因是 'nobody within oracle finds this important'）。

注意：我确实设法与一些 openjdk 工程师交谈，所以也许有一天任何注释都可能会成为现实，届时您可以避免两步工作流程的可能性会大大增加，但我们仍在谈论 JDK15最早，考虑到上次我们（Lombok 项目的核心贡献者）尝试在 java 本身中包含一个小功能时事情的进展令人沮丧，不确定再次尝试是否是花费贡献者时间的好方法。

无法在具有 onmethod 属性的 lombok setters/getters 上生成 JavaDoc

Unable to generate JavaDoc on lombok setters/getters with onmethod attribute

javadoc

lombok