Comment doit-on documenter les paramètres d' enregistrement Java ? Je fais référence aux paramètres qui finissent par devenir des paramètres constructeurs, des champs de classe.
J'ai essayé:
/**
* @param name the name of the animal
* @param age the age of the animal
*/
public record Animal(String name, int age)
{
}
mais IntelliJ IDEA signale @param
s comme une erreur. Je n'ai pas pu trouver un exemple en ligne de la façon dont cela est censé fonctionner. La discussion la plus proche que j'ai trouvée est https://bugs.openjdk.java.net/browse/JDK-8225055 .
J'ai trouvé des tests unitaires dans le JDK qui semblent impliquer que cela devrait fonctionner. C'est peut-être un bug IDE?
J'utilise OpenJDK 14 + 36-1461, IDEA 2020.1.
J'ai déposé un rapport de bogue contre IDEA au cas où.