Java Language Annotations


Exemple

Les annotations de déclaration doivent être placées sur une ligne distincte de la déclaration en cours d’annotation.

@SuppressWarnings("unchecked")
public T[] toArray(T[] typeHolder) {
    ...
}

Cependant, peu ou pas d’annotations annotant une méthode à une seule ligne peuvent être placées sur la même ligne que la méthode si elle améliore la lisibilité. Par exemple, on peut écrire:

@Nullable String getName() { return name; }

Pour des raisons de cohérence et de lisibilité, toutes les annotations doivent être placées sur la même ligne ou chaque annotation doit être placée sur une ligne distincte.

// Bad.
@Deprecated @SafeVarargs
@CustomAnnotation
public final Tuple<T> extend(T... elements) {
    ...
}

// Even worse.
@Deprecated @SafeVarargs
@CustomAnnotation public final Tuple<T> extend(T... elements) {
    ...
}

// Good.
@Deprecated
@SafeVarargs
@CustomAnnotation
public final Tuple<T> extend(T... elements) {
    ...
}

// Good.
@Deprecated @SafeVarargs @CustomAnnotation
public final Tuple<T> extend(T... elements) {
    ...
}