Les intercepteurs sont des méthodes spéciales (définies par le programmeur) que le container EJB utilise pour intercepter l'appel d'une méthode "cible" d'un bean (la méthode cible va réagir comme si elle a été appelée directement par la méthode de l'intercepteur).

Les intercepteurs peuvent être utilisées avec des stateless, statefull, singleton et MDBs.

Une méthode d'interception doit avoir la signature suivante :
public Object interceptorMethodName(InvocationContext invocationContext) throws Exception

• Créer un projet Maven:
  $ mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DarchetypeVersion=1.4 \ -DgroupId=mtitek.modulez.interceptors \ -DartifactId=mtitek-modulez-interceptors \ -Dversion=1.0.0-SNAPSHOT \ -DinteractiveMode=false
  Importez le projet dans votre éditeur du code (Eclipse, NetBeans, …).
  
  Notes :
  Sur Linux, le caractère "\" permet d'écrire une commande sur plusieurs lignes.
  Sur Windows, il faut utiliser le caractère "^".
  
  
• Modifier le fichier "pom.xml":
  <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>mtitek.modulez.interceptors</groupId> <artifactId>mtitek-modulez-interceptors</artifactId> <version>1.0.0-SNAPSHOT</version> <packaging>war</packaging> <name>mtitek-modulez-interceptors Maven Webapp</name> <dependencies> <dependency> <groupId>javax</groupId> <artifactId>javaee-api</artifactId> <version>6.0</version> <scope>provided</scope> </dependency> </dependencies> </project>
  
  
• Modifier le fichier "web.xml":
  <?xml version="1.0" encoding="ISO-8859-1"?> <web-app 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/web-app_3_0.xsd" version="3.0"> <display-name>mtitek-modulez-interceptors</display-name> </web-app>
  
  
• Créer une classe Java pour déclarer un intercepteur :
  package mtitek.modulez.interceptors; import javax.interceptor.AroundInvoke; import javax.interceptor.InvocationContext; public class InterceptorFirst { @AroundInvoke public Object interceptMethod(InvocationContext invocationContext) throws Exception { System.out.println(this.getClass().toString() + " : interceptMethod start [" + invocationContext.getMethod().getName() + "]"); Object targetReturnedValue = invocationContext.proceed(); System.out.println(this.getClass().toString() + " : interceptMethod end [" + invocationContext.getMethod().getName() + "]"); return targetReturnedValue; } }
  - L'annotation @AroundInvoke permet de designer la méthode comme une méthode d'interception.
  
  
  
• Créer une classe Java (stateless) pour déclarer une méthode cible de l'intercepteur :
  package mtitek.modulez.ejb; import mtitek.modulez.interceptors.InterceptorFirst; import javax.ejb.Stateless; import javax.interceptor.Interceptors; @Stateless @Interceptors(InterceptorFirst.class) public class StatelessFirst { public String sayHello() { System.out.println(this.getClass().toString() + " : sayHello"); return "Hello, here's a First Interceptor Test !!!"; } }
  - L'annotation @Interceptors permet de designer la classe comme cible de l'intercepteur.
  - L'attribut value de l'annotation @Interceptors permet de specifier les intercepteurs.
  - Dans cet exemple, toutes les méthodes de la classe seront des cibles de l'intercepteur.
  
  
  
• Créer une classe Java (servlet) pour tester l'intercepteur :
  package mtitek.modulez.servlet; import mtitek.modulez.ejb.StatelessFirst; import java.io.IOException; import java.io.PrintWriter; import javax.ejb.EJB; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; @WebServlet(urlPatterns = { "/ServletFirst" }) public class ServletFirst extends HttpServlet { private static final long serialVersionUID = 659383429298868458L; @EJB private StatelessFirst statelessFirst; @Override protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html; charset=utf-8"); PrintWriter out = response.getWriter(); out.println("<html>"); out.println("<head><title>Interceptor Hello, world!</title></head>"); out.println("<body>"); out.println("Interceptor Hello, world!<hr /><br />"); out.println("<h1>" + statelessFirst.sayHello() + "</h1><br />"); out.println("</body>"); out.println("</html>"); out.flush(); out.close(); } }
  
  
• Créer, déployer et tester l'intercepteur :
  Pour builder le projet il faut utiliser la commande Maven : "mvn install".
  Le fichier WAR créé peut être déployé seul ou packagé dans un EAR.
  
  Pour tester l'intercepteur utiliser l'URL swivante : "http://localhost:9080/modulez-interceptors/ServletFirst"
  
  Voici un exemple de log du fichier "SystemOut.log" de WebSphere WAS :
  [13/12/14 3:38:44:162 EST] 0000007f SystemOut O class mtitek.modulez.interceptors.InterceptorFirst : interceptMethod start [sayHello] [13/12/14 3:38:44:162 EST] 0000007f SystemOut O class mtitek.modulez.ejb.StatelessFirst : sayHello [13/12/14 3:38:44:162 EST] 0000007f SystemOut O class mtitek.modulez.interceptors.InterceptorFirst : interceptMethod end [sayHello]