Java: en utilisant les annotations prédéfinies

Les types et le contenu des annotations en Java, comme les commentaires, ne sont limitées que par votre imagination. Oui, Java fournit quelques annotations prédéfinies, mais vous pouvez aussi créer des annotations qui décrivent les éléments du programme de quelque manière que vous voulez. L'idée est que vous décrivez comment une annotation devrait travailler, fournir des données pour, et le compilateur prend soin du reste.

Annotations commencent toujours par le symbole @ (at). Alors, quand vous voyezDocumented, vous savez que vous voyez une annotation. Les sections suivantes vous disent plus sur annotations prédéfinis et personnalisés.

Une annotation prédéfinie est celui qui existe dans le cadre de Java. Vous trouverez ces annotations dans le package de java.lang.annotation. Pour les utiliser, vous ajoutez java.lang.annotation d'importation * -. Au début de votre application. La liste suivante présente un aperçu des annotations prédéfinies:

• deprecated: Parfois, un élément - une classe, une méthode, un champ ou une autre caractéristique de programmation - est remplacée par un élément plus récent ou est tout simplement plus nécessaires.

  Lorsque cela se produit, vous marquez l'élément comme obsolète afin que les développeurs savent qu'ils ont besoin de mettre à jour leur code et cesser d'utiliser cet élément particulier. Ajout de l'annotationdeprecated renvoie l'état obsolète de l'élément dans la documentation générée par Javadoc (un utilitaire qui est utilisé pour créer la documentation automatiquement basé sur le contenu de vos fichiers de code).

• 
  
  
  
  

  Documented: Chaque fois que vous marquez un élément comme documenté, les services publics sorties Javadoc dans le fichier de documentation Il crée basées sur le contenu du fichier source.

• FunctionalInterface: Indique que l'interface est une interface fonctionnelle utilisée pour les classes anonymes et les expressions lambda.

• Inherited: Les classes peuvent hériter des caractéristiques d'une classe parente. Par défaut, ce qui inclut des fonctionnalités telles que les méthodes, mais ne comprend pas les annotations de la classe parente. En utilisant l'annotationInherited raconte Java pour appliquer les annotations de classe parent à la sous-classe ainsi.

• Override: Indique qu'un élément de la classe de l'enfant est la suppression d'un élément superclasse (classe parent). Si cette annotation est présente et la superclasse manque un élément du même nom, le compilateur génère une erreur de sorte que vous savez quelque chose ne va pas avec le remplacement.

• Repeatable: La plupart des annotations sont appliqués qu'une seule fois à un élément particulier. Cependant, dans certains cas, vous devez appliquer l'annotation plus d'une fois. Cette annotation Java raconte qu'il est acceptable d'appliquer l'annotation à un élément particulier plus d'une fois.

• Retention: Une annotation peut affecter seulement la source code- le code source et compiler- ou le code source, compilateur, et JVM. Cette annotation définit quel effet une autre annotation devrait avoir. Par exemple, vous devrez peut-être seulement une annotation spécifique à la documentation d'affecter le code source et le compilateur.

• SafeVarargs: Il est possible d'effectuer des opérations qui ne sont pas en sécurité sur les arguments passés à une méthode ou d'un constructeur. Cette annotation dit que le code ne fait rien dangereux et ne nécessite donc pas tous les contrôles habituels. Réduire le nombre de contrôles rend l'application de courir plus vite.

• SuppressWarnings: Le compilateur Java génère une richesse d'avertissements pour signaler les problèmes potentiels. Par exemple, si vous essayez d'utiliser une méthode obsolète dans votre code, le compilateur émet un message d'avertissement à ce sujet. Cette annotation indique au compilateur de ne pas sortie de tels avertissements pour l'élément concerné.

• Target: Lorsque vous créez vos propres annotations, il peut être utile pour indiquer au compilateur que ces annotations doivent affecter seulement un type d'élément spécifique. Par exemple, si vous créez un bloc de l'auteur qui est destinée à comparaître seulement au niveau de paquet, vous pouvez limiter l'annotation à tout ce type d'élément en utilisant l'annotationTarget.