7.6.3. Configurer un intercepteur de conteneur

Procédure 7.11. Créer le fichier de descripteur pour configurer l'intercepteur de conteneur

1. Créer un fichier jboss-ejb3.xml dans le répertoire META-INF du déploiement EJB.
2. Configurer les éléments de l'intercepteur du conteneur dans le fichier du descripteur.
   1. Utiliser l'espace-nom urn:container-interceptors:1.0 pour indiquer la configuration des éléments de l'intercepteur du conteneur.
   2. Utiliser l'élément <container-interceptors> pour indiquer les intercepteurs du conteneur.
   3. Utiliser les éléments <interceptor-binding> pour relier l'intercepteur du conteneur aux EJB. Les intercepteurs peuvent être reliés d'une des manières suivantes :
      • Relier l'intercepteur à tous les EJB du déploiement par le caractère générique *.
      • Relier l'intercepteur au niveau bean individuel par le nom spécifique de l'EJB.
      • Relier l'intercepteur au niveau de méthode spécifique des EJB.

      Note

      Ces éléments sont configurés par EJB 3.1 XSD de la même façon que pour les intercepteurs Java EE.
3. Vérifier les exemples d'éléments ci-dessus dans le fichier de descripteur suivant.

   Exemple 7.3. jboss-ejb3.xml

   Copy to Clipboard Toggle word wrap

   <jboss xmlns="http://www.jboss.com/xml/ns/javaee"
          xmlns:jee="http://java.sun.com/xml/ns/javaee"
          xmlns:ci ="urn:container-interceptors:1.0">
    
       <jee:assembly-descriptor>
           <ci:container-interceptors>
               <!-- Default interceptor -->
               <jee:interceptor-binding>
                   <ejb-name>*</ejb-name>
                   <interceptor-class>org.jboss.as.test.integration.ejb.container.interceptor.ContainerInterceptorOne</interceptor-class>
               </jee:interceptor-binding>
               <!-- Class level container-interceptor -->
               <jee:interceptor-binding>
                   <ejb-name>AnotherFlowTrackingBean</ejb-name>
                   <interceptor-class>org.jboss.as.test.integration.ejb.container.interceptor.ClassLevelContainerInterceptor</interceptor-class>
               </jee:interceptor-binding>
               <!-- Method specific container-interceptor -->
               <jee:interceptor-binding>
                   <ejb-name>AnotherFlowTrackingBean</ejb-name>
                   <interceptor-class>org.jboss.as.test.integration.ejb.container.interceptor.MethodSpecificContainerInterceptor</interceptor-class>
                   <method>
                       <method-name>echoWithMethodSpecificContainerInterceptor</method-name>
                   </method>
               </jee:interceptor-binding>
               <!-- container interceptors in a specific order -->
               <jee:interceptor-binding>
                   <ejb-name>AnotherFlowTrackingBean</ejb-name>
                   <interceptor-order>
                       <interceptor-class>org.jboss.as.test.integration.ejb.container.interceptor.ClassLevelContainerInterceptor</interceptor-class>
                       <interceptor-class>org.jboss.as.test.integration.ejb.container.interceptor.MethodSpecificContainerInterceptor</interceptor-class>
                       <interceptor-class>org.jboss.as.test.integration.ejb.container.interceptor.ContainerInterceptorOne</interceptor-class>
                   </interceptor-order>
                   <method>
                       <method-name>echoInSpecificOrderOfContainerInterceptors</method-name>
                   </method>
               </jee:interceptor-binding>
           </ci:container-interceptors>
       </jee:assembly-descriptor>
   </jboss>
   
   

   L'XSD de l'espace-nom urn:container-interceptors:1.0 se trouve dans EAP_HOME/docs/schema/jboss-ejb-container-interceptors_1_0.xsd.