Exclusion d'avertissements à l'aide de @SuppressWarnings
A partir de Java 5.0, vous pouvez désactiver les avertissements de compilation relatifs à un sous-réseau d'une unité de compilation à l'aide de l'annotation java.lang.SuppressWarning.
@SuppressWarning("unused") public void foo() {
String s;
}
Sans cette annotation, le compilateur signalerait le fait que la variable locale s n'est jamais utilisée. Avec cette annotation, il ignore cet avertissement localement par rapport à la méthode foo. Il est ainsi possible de conserver les avertissements dans d'autres emplacements de la même unité de compilation ou du même projet.
La liste des jetons pouvant être utilisée dans une annotation SuppressWarnings est la suivante :
- all pour supprimer tous les avertissements
- boxing pour supprimer les avertissements relatifs aux opérations d'emballage/déballage
- cast pour supprimer les avertissements relatifs aux opérations de transtypage
- dep-ann pour supprimer les avertissements relatifs aux annotations obsolètes
- deprecation pour supprimer les avertissements relatifs à un état obsolète
- fallthrough pour supprimer les avertissements relatifs aux instructions break manquantes dans les instructions switch
- finally pour supprimer les avertissements relatifs à un bloc finally non renvoyé
- hiding pour supprimer les avertissements relatifs aux paramètres locaux qui masquent la variable
- incomplete-switch pour supprimer les avertissements relatifs aux entrées manquantes dans une instruction switch (enum case)
- javadoc pour supprimer les avertissements relatifs aux avertissements javadoc
- nls pour supprimer les avertissements relatifs aux littéraux chaîne non-nls
- null pour supprimer les avertissements relatifs à une analyse null
- rawtypes pour supprimer les avertissements relatifs à l'utilisation des types bruts
- resource pour supprimer les avertissements relatifs à l'utilisation de ressources de type Closeable
- restriction pour supprimer les avertissements relatifs à l'utilisation de références déconseillées ou interdites
- serial pour supprimer les avertissements relatifs à la zone manquante serialVersionUID d'une classe sérialisable
- static-access pour supprimer les avertissements relatifs à un accès statique incorrect
- static-method pour supprimer les avertissements relatifs aux méthodes pouvant être déclarées comme étant statiques
- super pour supprimer les avertissements relatifs au remplacement d'une méthode sans super appels
- synthetic-access pour supprimer les avertissements relatifs à un accès non optimisé à partir de classes internes
- sync-override pour supprimer les avertissements relatifs à l'absence de synchronisation lors de la suppression d'une méthode synchronisée
- unchecked pour supprimer les avertissements relatifs aux opérations non vérifiées (unchecked)
- unqualified-field-access pour supprimer les avertissements relatifs à un accès à une zone non qualifiée
- unused pour supprimer les avertissements relatifs au code inutilisé et au code mort