如何记录 Java Record 参数？

Question

应该如何记录Java Record参数？我指的是最终成为构造函数参数、类字段的参数。

我试过：

/**
 * @param name the name of the animal
 * @param age the age of the animal
 */
public record Animal(String name, int age)
{
}

但 IntelliJ IDEA 将@params标记为错误。我找不到有关这应该如何工作的在线示例。我发现的最接近的讨论是https://bugs.openjdk.java.net/browse/JDK-8225055。

我发现JDK 中的一些单元 测试似乎暗示这应该有效。也许这是一个IDE错误？

我使用的是 OpenJDK 14+36-1461，IDEA 2020.1。

以防万一，我针对 IDEA提交了错误报告。

Answer 1

IntelliJ 错误/缺失功能

使用内置的 JDK 工具和更高javadoc版本14-ea，我可以轻松地为record.

用于相同的命令是\

/jdk-14.jdk/.../javadoc --release=14 --enable-preview .../src/main/java/.../CityRecord.java

所以这肯定是 IntelliJ 中缺少的东西。（因为“添加 Javadoc”选项也不包括组件。）

我必须从 IntelliJ 开发的角​​度补充一下，当然作为一个预览功能，将专门用于它的工作放在这种程度也是一个必须谨慎对待的呼吁。

更新：我可以验证这是否已通过 IntelliJ 的最新更新解决：

IntelliJ IDEA 2020.2.2 Preview (Community Edition)
Build #IC-202.7319.5, built on September 1, 2020
Runtime version: 11.0.8+10-b944.31 x86_64