EJB resource references [Settings]
For each reference, specify the JNDI name under which the resource is known in the runtime environment. Optionally, set authentication properties and extended data source custom properties, which affect how the resource is accessed at run time.
Binding a resource reference maps a resource dependency of an enterprise bean to an actual resource available in the server runtime environment. At a minimum, you can achieve this mapping by specifying the JNDI name under which the resource reference is known in the runtime environment. By default, the JNDI name is retrieved from pre-existing bindings, or set to the value of the mapped-name specified in the resource definition.
If a JNDI name mapping for a resource reference is defined in an ibm-ejb-jar-bnd.xml file in the bundle, the corresponding JNDI name is displayed in the JNDI Name column for that reference, otherwise the JNDI name defaults to the resource reference name. You can modify the mappings, as required, by entering the appropriate values in the JNDI Name column.
@Resource
annotation on an enterprise bean.General Properties
- Select
- To modify the authentication method, or to set extended data source custom properties that apply to the database connection, select a single reference then click Modify Resource Authentication Method... or Extended Properties....
- Bundle symbolic name
- The non-localizable name for this bundle.
- Bundle version
- The version of this bundle.
The bundle symbolic name, together with the bundle version, uniquely identifies a bundle.
- EJB name
- The name of the enterprise bean that declares the resource reference.
- Resource Reference
- The name of a resource reference that is used in the application, if applicable, and is declared in the deployment descriptor of the EJB bundle.
- Resource Type
- The type of the resource reference.You can use this panel to specify bindings for any resource-ref (resource reference) resource, as defined in the Java™ specification JSR-250: Common Annotations for the Java Platform. For example, the following are all types of resource-ref resource:
- Data source
- Generic JMS connection factory
- Mail session
- J2C connection factory
- JMS queue connection factory for the JMS provider of WebSphere® MQ
- JMS topic connection factory for WebSphere MQ
- Unified JMS connection factory for WebSphere MQ
- URL configuration
- JNDI name
- The Java Naming and Directory Interface (JNDI) name of the resource that is the mapping target of the resource reference.
- Login Configuration
- The authorization type and the authentication method for securing the resource. Container-managed authorization indicates that the product signs on to the resource rather than the enterprise bean code.
Buttons
Label | Action |
---|---|
Browse |
To specify the JNDI name mapping for a specific EJB resource reference, use this option to select the resource reference from a list of available resources. |
Modify Resource Authentication Method |
You can select one of the following options:
|
Extended properties |
If your resource is a data source, and the back-end database supports
extended data source custom properties, you can use this option to add, modify, or delete these
properties. These are custom properties, in the form of name/value pairs, that you can use to obtain
a data source.
Note: If you use multiple values for an extended data source property, you must
enclose those values in quotation marks.
For more information, see Extended data source properties. |
Mapping properties |
Define arbitrary name and value pairs for extended data source properties that apply to the resource authentication method. This button is visible only if you have selected Use trusted connections or Use custom login configuration for the resource authentication method. |