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:

org.pentaho.platform.api.data.IDBDatasourceService

public class PooledDatasourceService
extends BaseDatasourceService

Field Summary

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

IDBDATASOURCE_SERVICE, JDBC_DATASOURCE, JDBC_POOL, MAX_ACTIVE_KEY, MAX_IDLE_KEY, MAX_WAIT_KEY, QUERY_KEY

Constructor Summary

Constructors

Constructor and Description
PooledDatasourceService()

Method Summary

Methods

Modifier and Type	Method and Description
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 org.pentaho.platform.api.data.IDBDatasourceService

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 org.pentaho.platform.api.data.IDBDatasourceService

Overrides:

clearDataSource in class BaseDatasourceService

getDataSource

public DataSource getDataSource(String dsName)
                         throws org.pentaho.platform.api.data.DBDatasourceServiceException

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

org.pentaho.platform.api.data.DBDatasourceServiceException

getDSBoundName

public String getDSBoundName(String dsName)
                      throws org.pentaho.platform.api.data.DBDatasourceServiceException

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 org.pentaho.platform.api.data.IDBDatasourceService

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:

org.pentaho.platform.api.data.DBDatasourceServiceException

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 org.pentaho.platform.api.data.IDBDatasourceService

Overrides:

getDSUnboundName in class BaseDatasourceService

Parameters:

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

Returns:

The unbound DS name (like "SampleData")