Support JCA 1.6 pour les annotations dans les modules RAR
La spécification Java™ Connector Architecture (JCA) version 1.6 ajoute un support pour les annotations Java dans les modules RAR. Les annotations permettent de spécifier des métadonnées ou des données de configuration pour un module RAR dans les fichiers classe composant le module.
Avant JCA 1.6, ces métadonnées ne pouvaient être spécifiées que dans le descripteur de déploiement ; à présent, vous pouvez les spécifier avec un descripteur de déploiement ou des annotations. Les métadonnées spécifiées dans les annotations sont fusionnées dans le descripteur de déploiement d'un module RAR lors de sa mise à jour, s'il n'est pas spécifié que les métadonnées sont complètes pour le module dans le descripteur de déploiement et si la version du module est 1.6 ou ultérieure.
L'élément metadata-complete indique si le descripteur de déploiement du module d'adaptateur de ressources est complet ou si des annotations spécifiant les informations de déploiement doivent être recherchées dans les fichiers classe disponibles pour le module et conditionnées avec l'adaptateur de ressources. Si l'élément metadata-complete est associé à la valeur true, l'outil de déploiement du serveur d'applications doit ignorer toute annotation spécifiant des informations de déploiement pouvant se trouver dans les fichiers classe de l'annotation. Si l'élément metadata-complete n'est pas spécifié ou est associé à la valeur false, l'outil de déploiement doit rechercher les annotations dans les fichiers classe de l'application conformément à la spécification JCA 1.6. Si le descripteur de déploiement n'est pas inclus ou est inclus sans l'élément metadata-complete, l'outil de déploiement traite les annotations.
Les serveurs d'applications doivent supposer que l'élément metadata-complete est associé à la valeur true pour les modules d'adaptateur de ressources possédant des descripteurs de déploiement répondant aux exigences de la spécification JCA 1.5 ou antérieure. Pour une liste complète des annotations prises en charge et de leur utilisation, consultez la spécification JCA.
La spécification JCA version 1.6 ajoute également un support pour les annotations de contrainte de validation de beans dans les modules RAR. Vous pouvez spécifier des métadonnées de contrainte de validation des beans pour les modules RAR JavaBeans en ornant les classes avec des annotations de contrainte de validation des beans ou en fournissant des descripteurs de validation XML. Le serveur d'applications valide les contraintes de toutes les instances JCA 1.6 RAR JavaBeans avant de les mettre en service au moment de l'exécution.