public interface WLDataSource
WLDataSource provides methods for the following:
DataSource
Modifier and Type | Method and Description |
---|---|
Connection |
createConnection(Properties additionalProperties)
Attempts to create a new database connection with the requested additional
connection properties.
|
Connection |
createConnectionToInstance(String instance,
Properties additionalProperties)
Attempts to create a new database connection with the requested additional
connection properties to the specified instance.
|
Connection |
getConnection(Properties labels)
Attempts to obtain a database connection with the requested connection
labels.
|
Connection |
getConnection(String username,
String password,
Properties labels)
Attempts to obtain a database connection with the requested connection
labels.
|
void |
registerConnectionInitializationCallback(ConnectionInitializationCallback cbk)
Registers a connection initialization callback with the underlying
connection pool.
|
void |
registerConnectionLabelingCallback(ConnectionLabelingCallback cbk)
Registers a connection labeling callback with the underlying connection
pool.
|
void |
removeConnectionLabelingCallback()
Removes the
ConnectionLabelingCallback object registered
with the underlying connection pool, if any. |
void |
unregisterConnectionInitializationCallback()
Unregisters the
ConnectionInitializationCallback object
registered with the underlying connection pool, if any. |
Connection getConnection(Properties labels) throws SQLException
labels
- The requested connection labels.SQLException
- if a database-access error occurs.Connection getConnection(String username, String password, Properties labels) throws SQLException
username
- The database user on whose behalf the connection is being made.password
- The user's password.labels
- The requested connection labels.SQLException
- if a database-access error occurs.void registerConnectionLabelingCallback(ConnectionLabelingCallback cbk) throws SQLException
cbk
- The ConnectionLabelingCallback
object to be
registered.SQLException
- If there is a callback already registered with the pool.void removeConnectionLabelingCallback() throws SQLException
ConnectionLabelingCallback
object registered
with the underlying connection pool, if any.SQLException
- If callback removal fails.void registerConnectionInitializationCallback(ConnectionInitializationCallback cbk) throws SQLException
cbk
- The ConnectionInitializationCallback
object to be
registered.SQLException
- If there is a callback already registered with the pool.void unregisterConnectionInitializationCallback() throws SQLException
ConnectionInitializationCallback
object
registered with the underlying connection pool, if any.SQLException
- If callback removal fails.Connection createConnection(Properties additionalProperties) throws SQLException
additionalProperties
- The requested additional connection properties.SQLException
- if a database-access error occurs.Connection createConnectionToInstance(String instance, Properties additionalProperties) throws SQLException
instance
- Target instance.additionalProperties
- The requested additional connection properties.SQLException
- if a database-access error occurs.SQLFeatureNotSupportedException
- The method was invoked on an
unsupported connection or driver type