Configuring References
Use
You can configure all types of references that your Web module uses to access other application modules and resources, as well as server-side resources (such as libraries, services, or interfaces). The following reference types can be configured:
● EJB remote or local references to use enterprise beans from components of your Web module;
● Resource references to use external resources (such as a DataSource, a JavaMail session object, a connection factory to a backend system, and so on).
● Resource environment reference to access resources such as a JMS topic or queue.
● Environment entries
● Component references to access components on the server.
Procedure
...
1. Open the Environment tab in the Web Module Details frame.
2. To add a new reference of any type, choose Add Entry.
3. Enter the reference name in Name.
4. Choose the type of the reference from the Type dropdown list box.
5. Depending on the type of the reference, do the following in the Full Details frame:
Reference Type |
Steps |
EJB remote reference |
... 1. Select the bean type from the Bean Type dropdown menu. 2. Enter the name of the bean in EJB Name. 3. Enter the name the bean is bound to the Naming System with in Java Naming and Directory Interface Name. 4. Enter the Remote Home value. This is a fully-qualified name of the bean home interface. 5. Enter the fully-qualified name of the bean remote interface in Remote. 6. Enter a bean reference description (optional). |
EJB local reference |
Procedure is analogous to the one for the EJB remote reference. You only specify the local and local home interfaces. |
Resource reference |
... 1. Choose the type of resource from the Type dropdown list box. 2. Choose the authentication type the resource uses (Application- or Container-managed) from the Authorization Type dropdown list box. 3. Choose the sharing attribute of the resource from the Sharing dropdown list box. 4. Enter the name with which the resource is bound to the naming system in Link. 5. To specify that the resource supports transactions, choose Is transactional. 6. Enter a resource reference description (optional). |
Environment entry |
... 1. Select a value from the Type dropdown menu This is the value expected by the Web application’s code. 2. Enter environment entry value in Value It must be a string. 3. Enter the environment entry’s description (optional). |
Resource environment entry |
... 1. Enter the reference’s type in Type. 2. Enter the name with which the resource environment entry is bound to the naming system. 3. Enter the resource environment reference’s description (optional). |
Component reference |
... 1. Select the type of the component that is referenced from the Type dropdown list box. 2. Enter the name with which the component is bound to the naming system in Java Naming and Directory Interface Name. 3. Enter a description of the reference (optional). |