oracle.ucp

Interface UniversalConnectionPoolAdapter

All Known Implementing Classes:

PoolDataSourceImpl, PoolXADataSourceImpl

public interface UniversalConnectionPoolAdapter

Universal Connection Pool Adapter interface.

A Universal Connection Pool Adapter extends Universal Connection Pool to provide resource-specific functionality. The Universal Connection Pool Adapter is tightly coupled with the connection factory adapter and provides resource-specific implementations of the pooled connections.

This interface defines standard operations that a Universal Connection Pool Adapter supports.

Method Summary

Modifier and Type	Method and Description
UniversalConnectionPool	createUniversalConnectionPool() Creates a Universal Connection Pool instance using this adapter.
UniversalConnectionPoolMBean	createUniversalConnectionPoolMBean() Creates a Universal Connection Pool MBean using this adapter.

Method Detail

createUniversalConnectionPool

UniversalConnectionPool createUniversalConnectionPool()
                                               throws java.lang.Exception

Creates a Universal Connection Pool instance using this adapter. Pool and connection factory configuration properties should be set on this adapter prior to invoking this method.

This method should not register the created pool instance with the Universal Connection Pool Manager. The createConnectionPool method on UniversalConnectionPoolManager is responsible for that.

Returns:

The created Universal Connection Pool instance.

Throws:

java.lang.Exception - If any error occurs during the process of connection pool creation.

See Also:

UniversalConnectionPoolManager

createUniversalConnectionPoolMBean

UniversalConnectionPoolMBean createUniversalConnectionPoolMBean()
                                                         throws java.lang.Exception

Creates a Universal Connection Pool MBean using this adapter. If a Universal Connection Pool instance is not yet created, this method must first create a pool instance, in which case pool and connection factory configuration properties should be set on this adapter prior to invoking this method.

This method should not register the created pool MBean with the MBean server. The createConnectionPool operation on UniversalConnectionPoolManagerMBean is responsible for that.

Returns:

The created Universal Connection Pool MBean.

Throws:

java.lang.Exception - If any error occurs during the process of connection pool creation.

See Also:

UniversalConnectionPoolManagerMBean