JBoss Enterprise Application Platform Common Criteria Certification ...

4 4 Chapter 6. The JNDI Naming Service
Session.
A home element that gives the fully qualified class name of the EJB home interface.
A remote element that gives the fully qualified class name of the EJB remote interface.
An optional ejb-link element that links the reference to another enterprise bean in the same EJB
JAR or in the same J2EE application unit. The ejb-link value is the ejb-name of the referenced
bean. If there are multiple enterprise beans with the same ejb-name, the value uses the path name
specifying the location of the ejb-jar file that contains the referenced component. The path name
is relative to the referencing ejb-jar file. The Application Assembler appends the ejb-name of
the referenced bean to the path name separated by #. This allows multiple beans with the same
name to be uniquely identified.
An EJB reference is scoped to the application component whose declaration contains the ejb-ref
element. This means that the EJB reference is not accessible from other application components at
runtime, and that other application components may define ejb-ref elements with the same ejb-refname
without causing a name conflict. Example 6.7, “An example ejb-jar.xml ejb-ref descriptor fragment”
provides an ejb-jar.xml fragment that illustrates the use of the ejb-ref element. A code sample
that illustrates accessing the ShoppingCartHome reference declared in Example 6.7, “An example
ejb-jar.xml ejb-ref descriptor fragment” is given in Example 6.8, “ENC ejb-ref access code fragment”.
Example 6.7. An example ejb-jar.xml ejb-ref descriptor fragment
ShoppingCartBean
ProductBeanUser
This is a reference to the store products entity
ejb/ProductHome
Entity
org.jboss.store.ejb.ProductHome
org.jboss.store.ejb.Product
ShoppingCartUser
ejb/ShoppingCartHome
Session
org.jboss.store.ejb.ShoppingCartHome
org.jboss.store.ejb.ShoppingCart
ShoppingCartBean
The Product entity bean
ProductBean