Comment utiliser @valeur de la balise javadoc?

Je suis en utilisant une classe avec un constructeur privé au lieu d'un enum (c'est une obligation). Et maintenant, je suis en train d'ajouter des balises javadoc pour documenter chaque public static final entité.

1) Qu'est préférable de placer le javadoc tags: comme ob1 ou ob2?

2) les Deux options de générer d'erreur dans l'IDÉE
@value tag must reference field with a constant intializer.

/**
 * {@value #ob1} object1 description
 */

public class MyClass {
    public static final Object ob1 = new Object();

    /**
     * {@value #ob2} object2 description
     */ 
    public static final Object ob2 = new Object();

    private MyClass() {}   
}
  • Essayez d'utiliser la non-IDÉE spécifique de javadoc. Sauf si c'est en quelque sorte dans la javadoc spec et je n'ai pas entendu parler de lui... Vous pouvez laisser l'ensemble de l' @valeur de la partie.
  • Je ne pense pas que c'est l'IDÉE des balises spécifiques.
  • est n'a pas d'IDÉE spécifique. Introduit dans la version 1.4, docs.oracle.com/javase/7/docs/technotes/tools/windows/...
  • Oui, je sais que @valeur n'est pas d'IDÉE spécifique, cependant je l'ai vu dans la méthode javadocs seulement. Si vous suffit d'entrer la description à côté du terrain, il devrait générer correctement (et espérons-le, sans erreur).