content/ejb-local-ref.mdtext

Title: ejb-local-ref
<a name="ejb-local-ref-Viaannotation"></a>
#  Via annotation

Usable by EJB, Interceptor, Servlet, Filter, or Listener

    package org.superbiz.refs;

    import javax.ejb.EJB;
    import javax.ejb.Stateless;
    import javax.naming.InitialContext;

    @Stateless
    @EJB(name = "myFooEjb", beanInterface = FooLocal.class)
    public class MyEjbLocalRefBean implements MyBeanInterface {

        @EJB
        private BarLocal myBarEjb;

        public void someBusinessMethod() throws Exception {
            if (myBarEjb == null) throw new NullPointerException("myBarEjb not injected");

            // Both can be looked up from JNDI as well
            InitialContext context = new InitialContext();
            FooLocal fooLocal = (FooLocal) context.lookup("java:comp/env/myFooEjb");
            BarLocal barLocal = (BarLocal) context.lookup("java:comp/env/org.superbiz.refs.MyEjbLocalRefBean/myBarEjb");
        }
    }


<a name="ejb-local-ref-Viaxml"></a>
# Via xml

The above @EJB annotation usage is 100% equivalent to the following xml.

    <ejb-local-ref>
      <ejb-ref-name>myFooEjb</ejb-ref-name>
      <local>org.superbiz.refs.FooLocal</local>
    </ejb-local-ref>

    <ejb-local-ref>
      <ejb-ref-name>org.superbiz.refs.MyEjbLocalRefBean/myBarEjb</ejb-ref-name>
      <local>org.superbiz.refs.BarLocal</local>
      <injection-target>
        <injection-target-class>org.superbiz.refs.MyEjbLocalRefBean</injection-target-class>
        <injection-target-name>myBarEjb</injection-target-name>
      </injection-target>
    </ejb-local-ref>