Java 9 - Annotation améliorée @Deprecated
L'annotation @Deprecated a été introduite dans la version Java 5. Un élément de programme annoté avec @Deprecated signifie qu'il ne doit pas être utilisé pour l'une des raisons suivantes −
- Son utilisation peut entraîner des erreurs.
- Cela pourrait être incompatible dans une future version.
- Il pourra être supprimé dans une future version.
- Une alternative meilleure et efficace l'a remplacé.
Le compilateur génère des avertissements chaque fois qu'un élément obsolète est utilisé. Avec Java 9, deux nouvelles améliorations sont apportées à l'annotation @Deprecated.
-
pour suppression − Indique si l'élément annoté est susceptible d'être supprimé dans une future version. La valeur par défaut est faux.
-
depuis − Renvoie la version dans laquelle l'élément annoté est devenu obsolète. La valeur par défaut est la chaîne vide.
Obsolète depuis
L'exemple suivant de la classe booléenne javadoc sur Java 9 illustre l'utilisation de l'attribut since sur l'annotation @Deprecated.
Classe booléenne
Obsolète avec forRemoval
L'exemple suivant de la classe System javadoc sur Java 9 illustre l'utilisation de l'attribut forRemoval sur l'annotation @Deprecated.
Classe système
Java