org.pentaho.platform.engine.services.connection.datasource.dbcp
Class PooledDatasourceService

java.lang.Object
  org.pentaho.platform.engine.services.connection.datasource.dbcp.BaseDatasourceService
      org.pentaho.platform.engine.services.connection.datasource.dbcp.PooledDatasourceService

All Implemented Interfaces:

IDatasourceService

public class PooledDatasourceService
extends BaseDatasourceService

Field Summary

Fields inherited from interface org.pentaho.platform.api.data.IDatasourceService

IDATASOURCE_SERVICE, JDBC_DATASOURCE, JDBC_POOL

Constructor Summary

PooledDatasourceService()

Method Summary

void	clearCache() This method clears the JNDI DS cache.
void	clearDataSource(String dsName) This method clears the JNDI DS cache.
DataSource	getDataSource(String dsName) Since JNDI is supported different ways in different app servers, it's nearly impossible to have a ubiquitous way to look up a datasource.
String	getDSBoundName(String dsName) Since JNDI is supported different ways in different app servers, it's nearly impossible to have a ubiquitous way to look up a datasource.
String	getDSUnboundName(String dsName) Since JNDI is supported different ways in different app servers, it's nearly impossible to have a ubiquitous way to look up a datasource.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PooledDatasourceService

public PooledDatasourceService()

Method Detail

clearCache

public void clearCache()

This method clears the JNDI DS cache. The need exists because after a JNDI connection edit the old DS must be removed from the cache.

Specified by:

clearCache in interface IDatasourceService

Overrides:

clearCache in class BaseDatasourceService

clearDataSource

public void clearDataSource(String dsName)

This method clears the JNDI DS cache. The need exists because after a JNDI connection edit the old DS must be removed from the cache.

Specified by:

clearDataSource in interface IDatasourceService

Overrides:

clearDataSource in class BaseDatasourceService

getDataSource

public DataSource getDataSource(String dsName)
                         throws DatasourceServiceException

Since JNDI is supported different ways in different app servers, it's nearly impossible to have a ubiquitous way to look up a datasource. This method is intended to hide all the lookups that may be required to find a jndi name.

Parameters:

dsName - The Datasource name

Returns:

DataSource if there is one bound in JNDI

Throws:

NamingException

DatasourceServiceException

getDSBoundName

public String getDSBoundName(String dsName)
                      throws DatasourceServiceException

Since JNDI is supported different ways in different app servers, it's nearly impossible to have a ubiquitous way to look up a datasource. This method is intended to hide all the lookups that may be required to find a jndi name, and return the actual bound name.

Specified by:

getDSBoundName in interface IDatasourceService

Overrides:

getDSBoundName in class BaseDatasourceService

Parameters:

dsName - The Datasource name (like SampleData)

Returns:

The bound DS name if it is bound in JNDI (like "jdbc/SampleData")

Throws:

DatasourceServiceException

getDSUnboundName

public String getDSUnboundName(String dsName)

Since JNDI is supported different ways in different app servers, it's nearly impossible to have a ubiquitous way to look up a datasource. This method is intended to extract just the regular name of a specified JNDI source.

Specified by:

getDSUnboundName in interface IDatasourceService

Overrides:

getDSUnboundName in class BaseDatasourceService

Parameters:

dsName - The Datasource name (like "jdbc/SampleData")

Returns:

The unbound DS name (like "SampleData")