Java: la création de nouvelles annotations

Vous avez vu les commentaires utilisés dans de nombreux exemples de code Java. Le compilateur ignore les commentaires, donc quand vous créez un commentaire vous pouvez écrire ce que vous vous sentez sera utile plus tard dans déterminer ce que l'application peut faire. Commentaires documenter votre code.

Cependant, il ya un autre type de documentation - l'annotation. Une annotation est une sorte de documentation qui comprend également le compilateur. Quand le compilateur voit annotation dans votre code, il sait qu'il a besoin de faire quelque chose de spécial avec le code qui suit. Annotations sont utiles pour documenter votre code d'une manière fonctionnelle afin que le compilateur peut aider à faire respecter ce que la documentation que vous fournissez.

L'ensemble des annotations prédéfinies qui viennent avec Java sont relativement limitées en usage. Pour créer des annotations vraiment utiles, il faut les concevoir vous-même ou les faire dans le cadre d'un paquet tiers. Création d'une nouvelle annotation est un processus en trois étapes:

  1. Ajoutez l'instruction d'importation approprié:




    importer java.lang.annotation *. -
  2. Définir une interface qui décrit l'annotation au compilateur:

    . // Création d'une description d'annotation @ documentée interface @ AuthorData {Nom String () - Chaîne Date () - version double () par défaut 1.0-}

    Dans ce cas, l'annotation apparaîtra dans la documentation créée par Javadoc car il inclut l'annotationDocumented. Chaque description de l'annotation commence avec le mot-cléinterface suivie par le nom du type d'annotation, qui est AuthorData dans ce cas.

    Dans les accolades, vous voyez les champs utilisés pour définir les données d'annotation. Cet exemple inclut le nom, la date et la version. Le mot-clé par défaut fournit une valeur pour un champ particulier. Cela signifie que le champ utilise la valeur si elle n'a pas été définie comme étant une partie de l'annotation dans la demande.

  3. Utilisez l'annotation dans l'application:

    AuthorData (Name = "John Smythe", date = "01/04/2014")

    L'annotation apparaît avant que l'élément qu'il affecte, comme une déclaration de classe. Vous devez définir chaque champ qui n'a pas de valeur par défaut. En option, vous définissez également les champs qui ne ont une valeur par défaut. Dans ce cas, le nom de l'auteur est John Smythe, et le code a été mis à jour le 01/04/2014.


» » » » Java: la création de nouvelles annotations