Discussion :

[pitoubicou]

Salut a tous,

Je suis en train d'essayer de comprendre les annotation (merci les tutoriels de Developpez)...
J'ai bien compris leur utilisations mais je ne comprends pas en quoi c'est si révolutionnaire.
Je ne comprends pas non plus l'utilité du paramètre value(), par exemple dans le tutoriel :

Il donne cette annotation :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
 
@Documented
@Retention(SOURCE)
public @interface TODO {
	/** Message décrivant la tâche à effectuer. */
	String value();
	/** Niveau de criticité de la tâche. */
	Level  level();
	/** Enumération des différents niveaux de criticités. */
	public static enum Level { MINEUR, NORMAL, IMPORTANT };
}

Et cette utilisation :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
 
@TODO(value="La gestion des exceptions est incorrecte...", level=TODO.Level.NORMAL)
	public void doSometing () {
		/* ... */
	}

Pouvez vous m'eclairé sur l'intéret de ce genre d'utilisation...

Merci beaucoup

[adiGuba]

Salut,

J'ai bien compris leur utilisations mais je ne comprends pas en quoi c'est si révolutionnaire.

Le principal intérêt est de pouvoir marquer des éléments du langage afin d'effectuer des traitement particulier, que ce soit à la compilation (avec APT) ou pendant l'exécution du code (avec l'API de reflection), ou encore avec des outils d'analyse du code.

Tu conserves dans ton code une information que tu peux utiliser plus tard...

Je ne comprends pas non plus l'utilité du paramètre value()

value() correspond à l'attribut principal d'une annotation, que l'on n'est pas obligé de nommer lorsqu'il est seul.

Cela est décrit dans la section 2.3 : Les membres et les valeurs par défauts. Si tu donnes une valeur par défaut à level(), par exemple :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
@Documented
@Retention(SOURCE)
public @interface TODO {
	/** Message décrivant la tâche à effectuer. */
	String value();
	/** Niveau de criticité de la tâche (défaut : NORMAL). */
	Level  level() default Level.NORMAL;
	/** Enumération des différents niveaux de criticités. */
	public static enum Level { MINEUR, NORMAL, IMPORTANT };
}

Tu peux faire ensuite :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

@TODO("message")

qui est équivalent à

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

@TODO(value="message")

et à

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

@TODO(value="message",level=Level.NORMAL)

Pouvez vous m'eclairé sur l'intéret de ce genre d'utilisation...

L'intérêt des annotations vient du fait que tu conserves des informations directement dans ton code, et que tu peux traiter à différents moments. Que ce soit via des outils de gestion de fichiers sources (compilateur ou outils style javadoc), via des annotation processors à la compilation (voir la section concernant APT) qui permettent d'effectuer des action particulières sur les annotations : dans l'exemple j'affiche une message concernant les @TODO restant à faire lors de la compilation, mais on peut très bien générer des fichiers texte voir carrément du code source selon les annotations...

On peut même effectuer des traitements pendant l'exécution via l'API de reflection... quelques exemples :

• Mustang, JDBC 4.0 et les Annotations
• Configuration d'une application avec les Annotations
• http://blog.developpez.com/index.php?blog=51&title=configurer_vos_interfaces_avec_les_annot&more=1&c=1&tb=1&pb=1]Configurer vos interfaces avec les annotations[/url]

Une note toutefois, l'API d'APT fournit avec Java 5.0 n'était pas encore officiel, et elle a été standardisé dans Java 6.0 (avec beaucoup de changement). Il faut que je prenne le temps de mettre à jours le tutoriel...

a++

[pitoubicou]

Merci pour ce complement d'information,

Heureusement que vous êtes là, sinon on serait souvent dans la m...

[LaJavanaise]

Une question SVP concernant les annotations: Sont elles interprétées à la compilation ou l'exécution?
Merci

[Gfx]

Cela dépend de la Retention Policy appliquée. Par exemple @Retention(SOURCE) crée une annotation n'existant qu'à la compilation alors qu'avec RUNTIME elle serait disponible à l'exécution. Bref, lis les liens qu'adiGuba a donné.

[adiGuba]

Une question SVP concernant les annotations: Sont elles interprétées à la compilation ou l'exécution?

Les Deux !!! Et même plus puisqu'on peux définir trois comportement différents pour les annotations grâce à la méta-annotation Retention

Plus d'info : http://adiguba.developpez.com/tutori...ns/#LRetention

a++

[LaJavanaise]

BOnjour à tous,
J'ai toujours des problèmes à manipuler les annotations bien que j'aie lu le manuel proposé. Par exemple pour accéder aux attributs de mes annotations:
Voilà ce que j'ai fait:
décalrer les annotations ayant toutes un attribut:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 @Retention(java.lang.annotation.RetentionPolicy.RUNTIME)public @interface Creation{
    public int capabilityId();
    }
 
    @Retention(java.lang.annotation.RetentionPolicy.RUNTIME)public @interface Operation{
        public int capabilityId();
        public boolean value();
    }
 
 
    @Retention(java.lang.annotation.RetentionPolicy.RUNTIME)public @interface Format{
        public int capabilityId();
    }
 
 
    @Retention(java.lang.annotation.RetentionPolicy.RUNTIME)public @interface Get{
        public int capabilityId();
    }

Et dans ma classe cible,j'ai chaune des méthodes est taggée par une annotation avec affectationd es attributs:
Par exemple:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
 @Operation(value=false, capabilityId = ConstCapability.MAMETHODLABEL)
 
public MonObjetdeRetour MaMethode(arguments...){
...
...
}

Dans a classe d'aspect (puisque je travaille toujours avec les aspects) j'ai besoin d'évaluer les valeurs de ces attributs; donc quelque part dans mon aspect j'ai besoin de faire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
 int i = capabilityId;
boolean  evaluate = value();
if(evaluate == true)

...
Mais je ne sais pas comment accéder à ces valeurs là!!
J'ai vu sur le tutorial qu'une méthode est proposée dans la partie "recherche dynamique des annotations":

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
 // Instanciation de l'objet
    Exemple objet = new Exemple();
    // On récupère la classe de l'objet :
    Class<Exemple> classInstance = objet.getClass();
    // On regarde si la classe possède une annotation :
    MonAnnotation annotation = classInstance.getAnnotation(MonAnnotation.class);
    if (annotation!=null) {
        System.out.println ("Annotation TODO : " + annotation.value() );
}

Mais ca ne marche pas!
Est ce que quelqu'un peut me proposer comment faire SVP?
Merci d'avance

[lunatix]

visiblement, tu utilises une annotation sur un methode, et tu la recherche au niveau de la classe.

a priori, si tu veux trouver ces annotation la, faut les chercher par methode je crois (suis pas un specialiste des annotations)

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
Method [] methods =
                testObject.getClass().getDeclaredMethods();
            for(Method amethod : methods) {
            UnitTest utAnnotation =
                amethod.getAnnotation(UnitTest.class);
            if(utAnnotation!=null) {
                System.out.print(utAnnotation.value() +
                                " : " );
                String result =
                    invoke(amethod, testObject);
                System.out.println(result);
                }
            }