Comment les différentes politiques de conservation affectent-elles mes annotations?

Quelqu'un peut -il expliquer de façon claire les différences pratiques entre les java.lang.annotation.RetentionPolicyconstantes SOURCE, CLASS, et RUNTIME?

Je ne sais pas non plus exactement ce que signifie l'expression «retenir l'annotation».

• RetentionPolicy.SOURCE: Jeter pendant la compilation. Ces annotations n'ont aucun sens une fois la compilation terminée, elles ne sont donc pas écrites dans le bytecode.
  Exemple: @Override,@SuppressWarnings

• RetentionPolicy.CLASS: Jeter pendant le chargement de la classe. Utile lors du post-traitement au niveau du bytecode. De manière assez surprenante, c'est la valeur par défaut.

• RetentionPolicy.RUNTIME: Ne pas jeter. L'annotation doit être disponible pour réflexion au moment de l'exécution. Exemple:@Deprecated

Source: L'ancienne URL est maintenant morte hunter_meta et remplacée par hunter-meta-2-098036 . Au cas où même cela tombe en panne, je télécharge l'image de la page.

Image (clic droit et sélectionnez `` Ouvrir l'image dans un nouvel onglet / fenêtre '')

D'après vos commentaires sur la décompilation de classe, voici comment je pense que cela devrait fonctionner:

• RetentionPolicy.SOURCE: N'apparaîtra pas dans la classe décompilée

• RetentionPolicy.CLASS: Apparaît dans la classe décompilée, mais ne peut pas être inspecté au moment de l'exécution avec une réflexion avec getAnnotations()

• RetentionPolicy.RUNTIME: Apparaissent dans la classe décompilée et peuvent être inspectés au moment de l'exécution avec réflexion avec getAnnotations()

Exemple exécutable minimal

Niveau de langue :

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;

@Retention(RetentionPolicy.SOURCE)
@interface RetentionSource {}

@Retention(RetentionPolicy.CLASS)
@interface RetentionClass {}

@Retention(RetentionPolicy.RUNTIME)
@interface RetentionRuntime {}

public static void main(String[] args) {
    @RetentionSource
    class B {}
    assert B.class.getAnnotations().length == 0;

    @RetentionClass
    class C {}
    assert C.class.getAnnotations().length == 0;

    @RetentionRuntime
    class D {}
    assert D.class.getAnnotations().length == 1;
}

Niveau Bytecode : en utilisant javapnous observons que la Retention.CLASSclasse annotée obtient un attribut de classe RuntimeInvisible :

#14 = Utf8               LRetentionClass;
[...]
RuntimeInvisibleAnnotations:
  0: #14()

tandis que l' Retention.RUNTIMEannotation obtient un attribut de classe RuntimeVisible :

#14 = Utf8               LRetentionRuntime;
[...]
RuntimeVisibleAnnotations:
  0: #14()

et l' Runtime.SOURCEannoté .classn'obtient aucune annotation.

Exemples sur GitHub avec lesquels vous pouvez jouer.

Politique de rétention: une politique de rétention détermine à quel moment une annotation est supprimée. Il est spécifié à l'aide des annotations intégrées de Java: @Retention^[About]

1.SOURCE: annotation retained only in the source file and is discarded
          during compilation.
2.CLASS: annotation stored in the .class file during compilation,
         not available in the run time.
3.RUNTIME: annotation stored in the .class file and available in the run time.

• CLASSE ： Les annotations doivent être enregistrées dans le fichier de classe par le compilateur mais n'ont pas besoin d'être conservées par la machine virtuelle au moment de l'exécution.
• RUNTIME ： Les annotations doivent être enregistrées dans le fichier de classe par le compilateur et conservées par la VM au moment de l'exécution, afin qu'elles puissent être lues de manière réfléchie.
• SOURCE ： Les annotations doivent être supprimées par le compilateur.

Doc Oracle