Quel est le point de paquet les annotations?

Je comprends l'objectif de la classe d'annotations, grâce à Comment et où sont les Annotations de Java?. Quel est le but de package annotations, comme décrit dans ce blog et §7.4.1 de la Spécification du Langage Java?

Pourquoi voudriez-vous d'associer des métadonnées à un package? Quels sont les types de choses que vous pouvez faire?

InformationsquelleAutor Gili | 2010-01-20
  1. 41
    1. bnd outil (et maven-bundle-plugin) rend l'utilisation de l'emballage des annotations. Mettre @Version et @Exportation d'annotation dans package-info.java permet de générer OSGi métadonnées.
    2. javadoc utilise le package annotations.
    3. JAXB utilise au niveau du package annotations, par exemple, pour spécifier le mappage d'un type Java, XML Schéma type de paquet entier. Package annotations sont également utilisés dans JBoss xml de liaison.
    4. Struts 2 de la Convention de plugin utilise une annotation pour spécifier une valeur par défaut de l'intercepteur pour toutes les actions dans un package.
    5. Il y a un paquet de niveau Hibernate Annotations. Un exemple de ces annotations d'utilisation peuvent être trouvés ici.
    InformationsquelleAutor viaclectic
  2. 7

    Je suppose que @Deprecated aurait du sens. Et peut-être quelque chose comme @Generated si l'ensemble du paquet a été généré par un outil de non-source Java. Ou @Internal si ce paquet n'est pas partie d'une API publique.

    Peut-être OSGi outils (où vous avez besoin de déclarer les versions de vos paquets et les paquets dont vous dépendez) pourraient l'utiliser, trop.

    Quelqu'un a vu ces sauvages?

    InformationsquelleAutor Thilo
  3. 4

    Deux raisons que je peux penser:

    • L'annotation des forfaits spéciaux pour laisser certains aspects (par exemple à l'aide de AspectJ) pour tisser les classes pour des fonctionnalités spécifiques.
    • L'annotation de certains paquets qui doivent être lus par certains outils, par exemple pour la source, le méta-données ou d'autres types de production de ressources.
    • Dites-vous que l'annotation d'un paquet est équivalent à l'annotation de toutes les classes au sein de ce package en un seul coup?
    • Non, je veux dire que vous pouvez l'utiliser pour indiquer que l'ensemble des classes de ce package doit être tissé.
    • Comment est-ce différent de ce que j'ai écrit?
    • J'ai compris votre commentaire pour dire que les classes semblent réellement avoir cette annotation eux, au niveau du langage. Et j'ai compris Amir commentaire pour signifier qu'un processeur d'annotation pourrait voir l'annotation sur le paquet (pas sur les classes en soi), puis sur décidez sur la base que pour réaliser une action de chaque classe au sein de ce package. Très différents en termes de résultat quand on appelle Class.getAnnotations().
    • Tu as mon commentaire juste. Votre commentaire explique encore le mien.
    InformationsquelleAutor Amir Moghimi
  4. 2

    JAXB par exemple permet la plupart des annotations qui sont normalement utilisés sur un type tout aussi bien s'appliquer à un package. Le sens dans ce cas serait de spécifier la valeur par défaut pour toutes les classes de ce package.

    Par exemple, si vous voulez toutes les propriétés de toutes les classes dans un package qui sont exposées via des accesseurs/mutateurs pour être mappées dans le XML, vous pouvez spécifier @XmlAccessorType(XMLAccessType.PROPERTY) sur chaque classe ou simplement l'indiquer sur le paquet.

    InformationsquelleAutor Joachim Sauer
  5. 1

    Ce n'est pas l'objet réel, mais je suis en les utilisant comme une solution de contournement pour éviter la recompilation de l'package-info.java les fichiers.

    Le problème est que javac (et la tâche Ant <javac>) ne crée pas de fichier de classe pour le package-info.java si ce n'est que de la documentation (la raison de leur existence) et la package bla; déclaration, et que la tâche ant recompile tous les fichiers pour lesquels il n'existe pas (ou plus) correspondant .class fichier.

    L'ajout d'un mannequin d'annotation là (comme SuppressWarnings) a eu pour effet qu'un package-info.class est produite et donc le fichier n'est pas recompilé jusqu'à ce que de nouveau changé.

    (Ant 1.8.0 résolu ce problème en créant un vide package-info.class même si il n'y avait pas d'annotation, mais je suis en utilisant une ancienne ant ici.)

    InformationsquelleAutor Paŭlo Ebermann
  6. 0

    Test de métadonnées -- c'est métadonnées autour de forfait de tests (tests unitaires ou autre). Vous pouvez attribuer différentes pièces de test de métadonnées qui sont appropriées au niveau du package, tels que: les caractéristiques, les propriétaires, les versions, les bugs/problèmes, etc. Celles-ci pourraient être raffiné à la classe ou au niveau de la méthode, mais ayant paquet au niveau des définitions ou des valeurs par défaut peut être pratique pour des raisons de concision. J'ai utilisé une variante de cette approche (avant que la prestation des annotations).

    Un argument similaire peut être faite pour l'généralisée code de métadonnées autour des mêmes sortes de choses: les fonctions, à la propriété, des défauts, des informations historiques, etc.

    InformationsquelleAutor Will