oracle.odi.core

Class DataSourceManager

java.lang.Object

oracle.odi.core.DataSourceManager

public class DataSourceManager
extends java.lang.Object

Manages and gives access to JDBC DataSource for given DataSourceDefinition instances.

Act as a factory of DataSources, while maintaining a cache of any created DataSources using given DataSourceDefinition as key. Each call to getDataSource(DataSourceDefinition) will return the same DataSource instance for equals definition.

To produce DataSource, this manager uses IDataSourceProviders for each managed data sources. They are instantiated according the property DataSourceSettingsEnvironment.DataSourceProvider#CLASS that define the provider class to be instantiated for the given definition.

In order to actually release a DataSourceManager and every managed DataSource, method release() must be called.

This class is not public and is internal to oracle.odi.core package. It is internally used by OdiInstance class plus depreciated OdiPlatform class.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	JDBC_RESOURCE_MONITOR_CLASS_PROPERTY

Constructor Summary

Constructors

Constructor and Description
DataSourceManager()
DataSourceManager(int pDefaultLoginTimeout)

Method Summary

Modifier and Type	Method and Description
javax.sql.DataSource	getDataSource(oracle.odi.core.datasource.DataSourceDefinition pDefinition) Creates or gets DataSource for the specified DataSourceDefinition.
oracle.odi.core.datasource.monitoring.IJdbcResourceMonitor	getJdbcResourceMonitor() Returns the IJdbcResourceMonitor used by this DataSourceManager.
void	release() Freeze all DataSources held by this DataSourceManager.
boolean	release(oracle.odi.core.datasource.DataSourceDefinition pDefinition) Release the given DataSource if it is managed by this.

Methods inherited from class java.lang.Object

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

Field Detail

JDBC_RESOURCE_MONITOR_CLASS_PROPERTY

public static final java.lang.String JDBC_RESOURCE_MONITOR_CLASS_PROPERTY

See Also:

Constant Field Values

Constructor Detail

DataSourceManager

public DataSourceManager()

DataSourceManager

public DataSourceManager(int pDefaultLoginTimeout)

Method Detail

getJdbcResourceMonitor

public oracle.odi.core.datasource.monitoring.IJdbcResourceMonitor getJdbcResourceMonitor()

Returns the IJdbcResourceMonitor used by this DataSourceManager. The IJdbcResourceMonitor is created during DataSourceManager instantiation by instantiating the class name provided in "oracle.odi.core.DataSourceManager.JdbcResourceMonitor" system property. If the property is not defined or the class name cannot be instantiated correctly as a IJdbcResourceMonitor then no monitor will be used.

Returns:

the IJdbcResourceMonitor or null if no IJdbcResourceMonitor is configured

getDataSource

public javax.sql.DataSource getDataSource(oracle.odi.core.datasource.DataSourceDefinition pDefinition)

Creates or gets DataSource for the specified DataSourceDefinition.

Multiple call to this method with a same (or equals) data source definition will always return the same DataSource instance.

Note:

Parameters:

pDefinition - the data source definition

Returns:

a JDBC DataSource for specified definition

release

public boolean release(oracle.odi.core.datasource.DataSourceDefinition pDefinition)

Release the given DataSource if it is managed by this.

Returns:

true if the DataSource has been released (i.e. contained in this manager), false otherwise

release

public void release()

Freeze all DataSources held by this DataSourceManager.