weblogic.jdbc.extensions
Interface WLDataSource

public interface WLDataSource

A WLDataSource provides methods not supported by javax.sql.DataSource.

WLDataSource provides methods for the following:

• Get a connection with matching labels
• Register and unregister the connection labeling callback
• Register and unregister the connection initialization callback

See Also:

DataSource

getConnection

Connection getConnection(Properties labels)
                         throws SQLException

Attempts to obtain a database connection with the requested connection labels.

Parameters:

labels - The requested connection labels.

Returns:

A Connection to the database.

Throws:

SQLException - if a database-access error occurs.

getConnection

Connection getConnection(String username,
                         String password,
                         Properties labels)
                         throws SQLException

Attempts to obtain a database connection with the requested connection labels.

Parameters:

username - The database user on whose behalf the connection is being made.

password - The user's password.

labels - The requested connection labels.

Returns:

A Connection to the database.

Throws:

SQLException - if a database-access error occurs.

registerConnectionLabelingCallback

void registerConnectionLabelingCallback(ConnectionLabelingCallback cbk)
                                        throws SQLException

Registers a connection labeling callback with the underlying connection pool.

Parameters:

cbk - The ConnectionLabelingCallback object to be registered.

Throws:

SQLException - If there is a callback already registered with the pool.

removeConnectionLabelingCallback

void removeConnectionLabelingCallback()
                                      throws SQLException

Removes the ConnectionLabelingCallback object registered with the underlying connection pool, if any.

Throws:

SQLException - If callback removal fails.

registerConnectionInitializationCallback

void registerConnectionInitializationCallback(ConnectionInitializationCallback cbk)
                                              throws SQLException

Registers a connection initialization callback with the underlying connection pool.

Parameters:

cbk - The ConnectionInitializationCallback object to be registered.

Throws:

SQLException - If there is a callback already registered with the pool.

unregisterConnectionInitializationCallback

void unregisterConnectionInitializationCallback()
                                                throws SQLException

Unregisters the ConnectionInitializationCallback object registered with the underlying connection pool, if any.

Throws:

SQLException - If callback removal fails.