如何记录Java Record参数?


12

应该如何记录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 提交了错误报告

Answers:


7

IntelliJ错误/缺少功能

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

在此处输入图片说明

用于相同的命令是\

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

因此,这肯定是IntelliJ中缺少的东西。(由于“添加Javadoc”选项也不包含组件。)

我必须从IntelliJ开发的角度来补充一点,当然,因为预览功能将为此专门工作的优先次序定为如此程度,这也是一个必须谨慎考虑的要求。


1
更新-显然,追踪者报告的错误已被修复。
纳曼
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.