Edition et validation de vos projets d'injection de contextes et de dépendances

Vous pouvez utiliser l'éditeur de descripteur de déploiement d'injection de contextes et de dépendances pour éditer votre fichier beans.xml.

Avant de commencer

Créez un projet à facette Java™ EE (un projet d'utilitaire, EJB, web, de connecteur ou de client d'application) dans votre espace de travail. Pour plus d'informations sur la création d'un de ces projets, voir Création et configuration de projets Java EE à l'aide d'assistants.

Pourquoi et quand exécuter cette tâche

Dans CDI 1.0, le fichier beans.xml est requis pour l'empaquetage et le déploiement d'un projet activé pour CDI. La présence du fichier beans.xml indique au conteneur que le module déployé est une archive de bean. Le descripteur de déploiement est généré lors de l'installation de la facette CDI. Voir Création d'applications qui utilisent CDI (Contexts and Dependency Injection). Initialement, le fichier beans.xml est vide, ce qui signifie que les intercepteurs annotés, les décorateurs ou les alternatives qui existent dans le module sont désactivés. Pour activer ces classes, vous pouvez les configurer à l'aide de l'éditeur de descripteur de déploiement CDI.

A partir de CDI 1.2, le fichier beans.xml est facultatif lors de l'empaquetage et du déploiement d'un projet compatible CDI. Ce fichier n'est pas créé lorsque vous ajoutez la facette CDI 1.2. Vous pouvez créer ce fichier en cliquant avec le bouton droit de la souris sur votre projet et en sélectionnant Outils Java EE > Generate CDI Beans Deployment Descriptor Stub dans le menu.

Procédure

  1. Pour ouvrir l'éditeur de descripteur de déploiement d'injection de contexte et de dépendance, effectuez un double-clic sur votre fichier beans.xml.
  2. Cliquez sur Ajouter pour ajouter des alternatives, des décorateurs et des Intercepteur à votre fichier beans.xml.

    A partir de CDI 1.2, vous pouvez également cliquer sur Ajouter et spécifier Analyse pour définir des filtres d'exclusion. Les filtres d'exclusion empêchent l'identification de classes comme étant des beans.

  3. Dans l'éditeur CDI 1.2, utilisez les valeurs de mode de reconnaissance de bean suivantes pour spécifier comment analyser votre archive de bean : tous, annoté ou aucun.

    L'éditeur de descripteur de déploiement CDI émet des erreurs de validation sous les conditions suivantes :

    • Si vous avez des classes alternatives, des classes de décorateurs, ou des classes d'intercepteurs vides.
    • Si vous avez des classes alternatives, des classes de décorateurs, ou des classes d'intercepteurs non existantes.
    • Si vous avez des classes alternatives, des classes de décorateurs, ou des classes d'intercepteurs en double.
    • Si vous avez des classes dépourvues des annotations @Alternative, @Interceptor ou @Decorator appropriées.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcdideploymentdescriptoreditor.html