Looking up data sources with resource references for relational access

Using a resource reference to access your data source or connection factory is required when running in WebSphere Application Server - Express. Some of the reasons follow:

Use a resource reference (resource-ref) for looking up a data source through the standard Java Naming and Directory Interface (JNDI) naming interface. The JNDI name defined in the resource-ref is a logical name of the data source. Have your application use this JNDI name to look up a data source instead of using the JNDI name that is defined on the data source.

Later, you can substitute the real name during installation of the application EAR file onto the server.

For example, assume that you use a DataSource jdbc/Section as illustrated in the code below.

import javax.sql.*;
import javax.rmi.*;
...
DataSource specificDataSource = (DataSource) PortableRemoteObject.narrow(
 (new InitialContext()).lookup("java:comp/env/jdbc/Section"), DataSource.class);

Using the WebSphere Development Studio Client, specify the name (jdbc/Section) as the resource reference. If you know the name of the DataSource, specify it also. For more information, see the WebSphere Development Studio Client Help.