L'annotation @EJB permet de préciser les sessions beans que le container EJB va instancier et initialiser automatiquement.

L'annotation peut être utilisée avec des variables pour indiquer au container EJB d'y injecter automatiquement l'instance des sessions beans.
L'injection des instances des sessions beans est faite avant que les méthodes métiers ne soient invoquées.

Notes : L'annotation peut être aussi utilisée au niveau des méthodes et des classes.

Code source (JBoss) de l'annotation @EJB:
package javax.ejb; /** * The EJB annotation denotes a reference to an EJB session bean. */ @Retention(RUNTIME) @Target({ TYPE, METHOD, FIELD }) public @interface EJB { String name() default ""; String beanName() default ""; String mappedName() default ""; Class beanInterface() default java.lang.Object.class; /** * A portable lookup string containing the JNDI name for the target EJB component. */ String lookup() default ""; String description() default ""; }

Dans le cas où une interface est implémentée par plusieurs classes, alors l'élément name des annotations @Stateless, @Stateful, et @Singleton et l'élément beanName de l'annotation @EJB doivent être utilisés pour préciser les sessions beans à injecter.

• Commençant par créer une interface locale :
  package com.mtitek.session.beans.ejb; import javax.ejb.Local; @Local public interface MyInterfaceLocal { public String localMethodTest(); }
  
  
• Créant maintenant deux classes distinctes qui implémentent l'interface locale : package com.mtitek.session.beans.ejb; import javax.ejb.Local; import javax.ejb.Stateless; @Stateless(name = "MyStatelessAlphaName") @Local({ MyInterfaceLocal.class }) public class MyStatelessAlpha implements MyInterfaceLocal { @Override public String localMethodTest() { return "MyStatelessAlpha - localMethodTest ..."; } }
  package com.mtitek.session.beans.ejb; import javax.ejb.Local; import javax.ejb.Stateless; @Stateless(name = "MyStatelessDeltaName") @Local({ MyInterfaceLocal.class }) public class MyStatelessDelta implements MyInterfaceLocal { @Override public String localMethodTest() { return "MyStatelessDelta - localMethodTest ..."; } }
  Notes :
  - Il faut remarquer que les deux classes MyStatelessAlpha et MyStatelessDelta utilisent l'annotation @Local pour préciser les interfaces métiers des stateless beans (cela n'est pas nécessaire si les interfaces sont annotées directement par cette annotation).
  
  - Les deux classes (MyStatelessAlpha et MyStatelessDelta) implémente la même interface (MyInterfaceLocal) comme interface métier, et il peut être pratique d'utiliser l'élément name de l'annotation @Stateless pour donner des noms explicites (et typiquement différents des noms par défaut des classes) pour distinguer chaque stateless bean ("MyStatelessAlphaName", "MyStatelessDeltaName").
  
  
• Enfin, utilisant l'annotation @EJB pour référencer les deux stateless beans. package com.mtitek.session.beans.ejb; import javax.ejb.EJB; import javax.ejb.LocalBean; import javax.ejb.Stateless; @Stateless @LocalBean public class MyClassCBean { @EJB(beanName = "MyStatelessAlphaName") MyInterfaceLocal myInterfaceLocal1; @EJB(beanName = "MyStatelessDeltaName") MyInterfaceLocal myInterfaceLocal2; public String foo() { return "MyClassCBean - foo ..." + " | " + myInterfaceLocal1.localMethodTest() + " | " + myInterfaceLocal2.localMethodTest(); } }
  Notes :
  - Il faut remarquer l'utilisation l'élément beanName de l'annotation @EJB pour spécifier au container EJB quel stateless bean doit être injecté.
  
  

L'utilisation de l'annotation @EJB au niveau de la méthode fonctionne de la même façon que lorsqu'elle est utilisée avec les variables mais elle donne plus de contrôle sur les instances des sessions beans injectées.
package com.mtitek.session.beans.ejb; import javax.ejb.EJB; import javax.ejb.LocalBean; import javax.ejb.Stateless; @Stateless @LocalBean public class MyClassDBean { MyInterfaceLocal myInterfaceLocal1; MyInterfaceLocalWrapper myInterfaceLocalWrapper; @EJB(beanName = "MyStatelessAlphaName") public void setMyInterfaceLocal1(MyInterfaceLocal myInterfaceLocal1) { this.myInterfaceLocal1 = myInterfaceLocal1; } @EJB(beanName = "MyStatelessDeltaName") public void setMyInterfaceLocal2(MyInterfaceLocal myInterfaceLocal2) { this.myInterfaceLocalWrapper = new MyInterfaceLocalWrapper(myInterfaceLocal2); } public String foo() { return "MyClassDBean - foo ..." + " | " + myInterfaceLocal1.localMethodTest() + " | " + myInterfaceLocalWrapper.getMyInterfaceLocal2().localMethodTest(); } } class MyInterfaceLocalWrapper { MyInterfaceLocal myInterfaceLocal2; public MyInterfaceLocalWrapper(MyInterfaceLocal myInterfaceLocal2) { this.myInterfaceLocal2 = myInterfaceLocal2; } public MyInterfaceLocal getMyInterfaceLocal2() { return myInterfaceLocal2; } }

L'utilisation de l'annotation au niveau de la classe est importante lorsqu'on a besoin de faire des injections anonymes des sessions beans qui peuvent être référencées par la suite en utilisant JNDI.
Cela peut être utile dans des contextes où l'injection n'est pas possible.
package com.mtitek.session.beans.ejb; import javax.ejb.EJB; import javax.ejb.LocalBean; import javax.ejb.Stateless; import javax.naming.InitialContext; import javax.naming.NamingException; @EJB(name = "MyStatelessAlphaEJBName", beanInterface = MyInterfaceLocal.class, beanName = "MyStatelessAlphaName") @Stateless @LocalBean public class MyClassEBean { public String foo() { return "MyClassEBean - foo ..." + " | " + new MyClassEUtil().lookupBean(); } } class MyClassEUtil { public String lookupBean() { MyInterfaceLocal myInterfaceLocal; try { myInterfaceLocal = (MyInterfaceLocal) new InitialContext().lookup("java:comp/env/MyStatelessAlphaEJBName"); } catch (NamingException e) { e.printStackTrace(); return null; } return myInterfaceLocal.localMethodTest(); } }
Notes :
- Les attributs name et beanInterface sont obligatoires lorsque l'annotation @EJB est utilisée au niveau de la classe.