
![[8.5.5.6 ou ultérieure]](../ng_v8556.gif)
Changements de comportement dans Contexts and Dependency Injection 1.2
L'implémentation Contexts and Dependency Injection (CDI) 1.2 contient des changements de comportement qui peuvent provoquer qu'une application ayant migré depuis CDI 1.0 se comporte différemment ou échoue sous CDI 1.2.
Vous pouvez choisir entre les implémentations des fonctions CDI 1.0 et CDI 1.2 pour chaque instance de serveur, mais vous devez tenir compte des changements de comportement. Si le comportement désiré est uniquement contenu dans la fonction CDI 1.2, vous devez utiliser la fonction CDI 1.2. Si les changements de comportement de la fonction CDI 1.2 sont susceptibles de nuire à une application existante, utilisez la fonction CDI 1.0 pour conserver le comportement existant pour cette application. Il n'est pas possible d'utiliser à la fois les fonctions CDI 1.0 et les fonctions CDI 1.2 dans le même serveur car les fonctions ne sont pas compatibles. Si vous configurez les deux fonctions, le serveur générera une erreur de configuration.
La fonction CDI 1.0 repose sur l'implémentation Apache OpenWebBeans de CDI. La fonction CDI 1.2 repose sur l'implémentation Weld de CDI. Les changements de comportement ont été introduits en raison des différences entre les deux implémentations.
Utilisation de l'annotation @Named sur les beans
Le nom par défaut qui est affecté aux classes avec l'annotation @Named est le nom de classe non qualifié, avec la première lettre en minuscule au lieu d'une majuscule. Par exemple, TestBean devient par défaut testBean. Dans l'implémentation CDI 1.0, ce comportement s'applique à tous les noms de classes. L'implémentation Weld suit la spécification JavaBeans qui a un comportement différent pour les noms de classes et utilise plusieurs lettres majuscules au début. Dans cette instance, la majuscule n'est pas supprimée dans le nom qui est donné au bean. Par exemple, JSFTest est appelé avec JSFTest à partir des pages JavaServer (JSP).
CID de l'ID de conversation
Dans l'implémentation CDI 1.0, le CID est unique au niveau global. Dans CDI 1.2, il est unique par session Http. Ce comportement est en ligne avec la spécification CDI et correspond à la convention choisie par le Weld. Pour obtenir un CID unique à niveau global, le CID doit être spécifié au début de la conversation en appelant Conversation.begin.
Référencement des schémas dans le fichier beans.xml
xmlns="http://java.sun.com/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/beans_1_1.xsd"
Si un
schéma non valide est utilisé, une erreur d'exception se produit sur
le serveur.
Vous pouvez désactiver la validation du fichier
beans.xml en définissant la propriété
org.jboss.weld.xml.disableValidating=true jvm, qui
permet également d'éviter cette erreur. Si le fichier
beans.xml spécifie des décorateurs ou des
intercepteurs, un schéma valide doit être utilisé, sinon les
décorateurs et les intercepteurs ne seront pas instanciés
correctement.Archives de bean implicites
L'implémentation CDI 1.2 définit deux types différents d'archives de bean : les archives explicites et les archives implicites.
- avec un numéro de version de 1.1 (ou ultérieur) et avec le mode de détection de bean all
- sans numéro de version
- qui est un fichier vide
Une archive de bean implicite est tout autre archive contenant une ou plusieurs classes de bean avec une annotation de définition de bean (comme défini dans la section 2.5.1 “Bean defining annotations” de la spécification) ou un ou plusieurs bean de session. Voir la spécification : Contexts and Dependency Injection for the Java™ EE platform.
<beans
xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
http://xmlns.jcp.org/xml/ns/javaee/beans_1_1.xsd"
bean-discovery-mode="all"
version="1.1">
<cdi12 enableImplicitBeanArchives="false"/>
En définissant cette propriété sur false, vous
évitez que les archives sans fichier beans.xml
ne deviennent des archives de bean implicites.