com.ibm.websphere.proxyds
Interface WSDataSourceHelper


Deprecated. This interface is deprecated in XD version 6.0. Please use WSProxyDataSourceHelper instead

public interface WSDataSourceHelper

WSDataSourceHelper interface is an interface used for CMP multiple datasource support added in XD Version 5.1 (also called V5 Proxy DataSource). Users can lookup an instance of WSDataSourceHelper from the JNDI name space using JNDI name WSDataSourceHelper.JNDI_NAME.

This interface is deprecated in XD version 6.0. Please use WSProxyDataSourceHelper instead.

There are two helper methods in this interface.

See Also:
WSProxyDataSourceHelper

Field Summary
static java.lang.String JNDI_NAME
          Deprecated. The JNDI name for user to look up an instance of WSDataSourceHelper
 
Method Summary
 java.lang.String resolveDataSourceReference(java.lang.String dsResRefName)
          Deprecated. Resolve the datasource reference to the global JNDI name.
 void setCurrentDataSourceJndiName(java.lang.String dsJndiName)
          Deprecated. Set the JNDI name (not the resource reference name) of the Delegate DataSource that the current transaction will access.
 

Field Detail

JNDI_NAME

static final java.lang.String JNDI_NAME
Deprecated. 
The JNDI name for user to look up an instance of WSDataSourceHelper

See Also:
Constant Field Values
Method Detail

resolveDataSourceReference

java.lang.String resolveDataSourceReference(java.lang.String dsResRefName)
                                            throws ResRefNotFoundException
Deprecated. 
Resolve the datasource reference to the global JNDI name. For example, if a resource reference "jdbc/myDS1" is mapped to a datasource with global JNDI name "jdbc/Bank1", resolveDataSourceReference("jdbc/myDS1") will return "jdbc/Bank1".

Parameters:
dsResRefName - resource reference name
Returns:
the resolved datasource global JNDI name for this resource reference.
Throws:
ResRefNotFoundException - indicates the resource reference name cannot be found.

setCurrentDataSourceJndiName

void setCurrentDataSourceJndiName(java.lang.String dsJndiName)
Deprecated. 

Set the JNDI name (not the resource reference name) of the Delegate DataSource that the current transaction will access. Currently, one transaction can only access one Delegate DataSource.

During the development time, the developers cannot know the global JNDI name of the datasource that a resource reference will be mapped to. The only known fact is the resource reference name. The recommneded practice is to call the resolveDataSourceRefrence(String) method to get the JNDI name of the mapped datasource, and then call setCurrentDataSourceJndiName with the global JNDI name.

Parameters:
dsJndiName - the current datasource JNDI name