Annotation Interface EJB
Either the beanName
or the lookup
element can
be used to resolve the EJB dependency to its target session bean component.
It is an error to specify values for both beanName
and
lookup
.
If no explicit linking information is provided and there is only one session bean within the same application that exposes the matching client view type, by default the EJB dependency resolves to that session bean.
- Since:
- EJB 3.0
-
Optional Element Summary
Modifier and TypeOptional ElementDescriptionThe interface type of the Enterprise Java Bean to which this reference is mapped.ThebeanName
element references the value of thename
element of theStateful
orStateless
annotation, whether defaulted or explicit.A string describing the bean.A portable lookup string containing the JNDI name for the target EJB component.The product specific name of the EJB component to which this ejb reference should be mapped.The logical name of the ejb reference within the declaring component's (e.g., java:comp/env) environment.
-
Element Details
-
name
String nameThe logical name of the ejb reference within the declaring component's (e.g., java:comp/env) environment.- Default:
- ""
-
description
String descriptionA string describing the bean.- Default:
- ""
-
beanName
String beanNameThebeanName
element references the value of thename
element of theStateful
orStateless
annotation, whether defaulted or explicit. If the deployment descriptor was used to define the name of the bean, thebeanName
element references theejb-name
element of the bean definition.The
beanName
element allows disambiguation if multiple session beans in the ejb-jar implement the same interface.In order to reference a bean in another ejb-jar file in the same application, the
beanName
may be composed of a path name specifying the ejb-jar containing the referenced bean with the bean name of the target bean appended and separated from the path name by #. The path name is relative to the jar file containing the component that is referencing the target bean.Only applicable if the target EJB is defined within the same application or stand-alone module as the declaring component.
- Default:
- ""
-
beanInterface
Class beanInterfaceThe interface type of the Enterprise Java Bean to which this reference is mapped.Holds one of the following types of the target EJB :
- Local business interface
- Bean class (for no-interface view)
- Remote business interface
- Local Home interface
- Remote Home interface
- Default:
- java.lang.Object.class
-
mappedName
String mappedNameThe product specific name of the EJB component to which this ejb reference should be mapped. This mapped name is often a global JNDI name, but may be a name of any form.Application servers are not required to support any particular form or type of mapped name, nor the ability to use mapped names. The mapped name is product-dependent and often installation-dependent. No use of a mapped name is portable.
- Default:
- ""
-
lookup
String lookupA portable lookup string containing the JNDI name for the target EJB component.- Since:
- EJB 3.1
- Default:
- ""
-