Traitement des annotations

Les processeurs d'annotations sont des programmes utilitaires qui peuvent générer du code Java supplémentaire ou d'autres fichiers, et créer des marqueurs d'erreur, en fonction des annotations Java 5 (JSR-175). Ces processeurs peuvent reposer sur les API miroir Java 5 ou sur les API de traitement d'annotations Java 6. La sous-fenêtre des préférences de traitement des annotations permet de configurer les préférences qui s'appliquent à tous les processeurs d'un projet ou d'un espace de travail. La sous-fenêtre des préférences du chemin d'accès aux fabriques indique les processeurs à activer et permet de configurer un processeur particulier.

Activer le traitement des annotations

Le traitement des annotations est désactivé par défaut et doit être activé en sélectionnant cette case à cocher pour chaque projet nécessitant ce type de traitement. Il est nécessaire d'activer ce traitement dans un projet pour que des processeurs d'annotations interviennent sur le code de ce projet. L'existence même d'annotations dans le code ne nécessite pas forcément le traitement de ces annotations. Par exemple, les annotations @Deprecated et @Override n'ont pas besoin de traitement.

Activer le traitement dans l'éditeur

Lorsque cette option est activée, les processeurs s'exécutent à chaque modification effectuée dans l'éditeur Java, et à chaque compilation du projet. Permettre aux processeurs de s'exécuter dans l'éditeur leur permet de générer des erreurs et des avertissements au cours de la saisie. Par exemple, les processeurs peuvent raturer en rouge une mauvaise valeur d'annotation pour signifier un problème de sémantique que le compilateur seul ne saurait révéler. Toutefois, certains processeurs d'annotation sont si lents que les exécuter dans l'éditeur affecte la convivialité de ce dernier. Dans ce type de situation, désactiver cette option est susceptible d'améliorer les performances de l'éditeur. Les processeurs s'exécuteront tout de même dès compilation du projet. Cette option ne s'applique pas aux processeurs d'annotations Java 6, Eclipse ne pouvant actuellement les exécuter que lors d'une génération.

Répertoire source généré

Les fichiers sont générés sur le disque, de manière relative par rapport au répertoire indiqué. Par défaut, ce répertoire est nommé ".apt_generated" ; puisqu'il commence par le caractère ".", il est exclu de la vue Explorateur de packages. Les fichiers générés sont dotés du terme "derived" (dérivé) ; lorsqu'un projet est nettoyé, tous les fichiers dérivés contenus dans le répertoire source généré sont supprimés. Il est recommandé de n'utiliser ce répertoire que pour les fichiers générés par les processeurs. N'y placez aucun fichier créé manuellement et n'utilisez pas de répertoire pré-existant comme répertoire source généré.

Options de processeur

Les options entrées ici seront disponibles via l'interface AnnotationProcessorEnvironment pour les processeurs Java 5 ou ProcessingEnvironment pour les processeurs Java 6. Certaines options sont fournies automatiquement aux processeurs Java 5. Les définir dans cette boîte de dialogue n'aura aucun effet car les valeurs fournies automatiquement remplacent toute valeur définie ici. Les options automatiques sont décrites ici. Pour plus d'informations sur les options de processeur, consultez la rubrique concernant la boîte de dialogue de saisie des options de processeur.