org.mariadb.jdbc

Class MariaDbPooledConnection

java.lang.Object

org.mariadb.jdbc.MariaDbPooledConnection

All Implemented Interfaces:

PooledConnection

Direct Known Subclasses:

MariaXaConnection

public class MariaDbPooledConnection
extends Object
implements PooledConnection

Constructor Summary

Constructors

Constructor and Description
MariaDbPooledConnection(MariaDbConnection connection) Constructor.

Method Summary

Modifier and Type	Method and Description
void	addConnectionEventListener(ConnectionEventListener listener) Registers the given event failover so that it will be notified when an event occurs on this PooledConnection object.
void	addStatementEventListener(StatementEventListener listener) Registers a StatementEventListener with this PooledConnection object.
void	close() Closes the physical connection that this PooledConnection object represents.
void	fireConnectionClosed() Fire Connection close to listening listeners.
void	fireConnectionErrorOccured(SQLException ex) Fire connection error to listening listerners.
void	fireStatementClosed(Statement st) Fire statement close event to listeners.
void	fireStatementErrorOccured(Statement st, SQLException ex) Fire statement error to listeners.
Connection	getConnection() Creates and returns a Connection object that is a handle for the physical connection that this PooledConnection object represents.
void	removeConnectionEventListener(ConnectionEventListener listener) Removes the given event failover from the list of components that will be notified when an event occurs on this PooledConnection object.
void	removeStatementEventListener(StatementEventListener listener) Removes the specified StatementEventListener from the list of components that will be notified when the driver detects that a PreparedStatement has been closed or is invalid.

Methods inherited from class java.lang.Object

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

Constructor Detail

MariaDbPooledConnection

public MariaDbPooledConnection(MariaDbConnection connection)

Constructor.

Parameters:

connection - connection to retrieve connection options

Method Detail

getConnection

public Connection getConnection()
                         throws SQLException

Creates and returns a Connection object that is a handle for the physical connection that this PooledConnection object represents. The connection pool manager calls this method when an application has called the method DataSource.getConnection and there are no PooledConnection objects available. See the interface description for more information.

Specified by:

getConnection in interface PooledConnection

Returns:

a Connection object that is a handle to this PooledConnection object

Throws:

SQLException - if a database access error occurs if the JDBC driver does not support this method

Since:

1.4

close

public void close()
           throws SQLException

Closes the physical connection that this PooledConnection object represents. An application never calls this method directly; it is called by the connection pool module, or manager.
See the interface description for more information.

Specified by:

close in interface PooledConnection

Throws:

SQLException - if a database access error occurs if the JDBC driver does not support this method

Since:

1.4

addConnectionEventListener

public void addConnectionEventListener(ConnectionEventListener listener)

Registers the given event failover so that it will be notified when an event occurs on this PooledConnection object.

Specified by:

addConnectionEventListener in interface PooledConnection

Parameters:

listener - a component, usually the connection pool manager, that has implemented the ConnectionEventListener interface and wants to be notified when the connection is closed or has an error

See Also:

removeConnectionEventListener(javax.sql.ConnectionEventListener)

removeConnectionEventListener

public void removeConnectionEventListener(ConnectionEventListener listener)

Removes the given event failover from the list of components that will be notified when an event occurs on this PooledConnection object.

Specified by:

removeConnectionEventListener in interface PooledConnection

Parameters:

listener - a component, usually the connection pool manager, that has implemented the ConnectionEventListener interface and been registered with this PooledConnection object as a failover

See Also:

addConnectionEventListener(javax.sql.ConnectionEventListener)

addStatementEventListener

public void addStatementEventListener(StatementEventListener listener)

Registers a StatementEventListener with this PooledConnection object. Components that wish to be notified when PreparedStatements created by the connection are closed or are detected to be invalid may use this method to register a StatementEventListener with this PooledConnection object.

Specified by:

addStatementEventListener in interface PooledConnection

Parameters:

listener - an component which implements the StatementEventListener interface that is to be registered with this PooledConnection object

Since:

1.6

removeStatementEventListener

public void removeStatementEventListener(StatementEventListener listener)

Removes the specified StatementEventListener from the list of components that will be notified when the driver detects that a PreparedStatement has been closed or is invalid.

Specified by:

removeStatementEventListener in interface PooledConnection

Parameters:

listener - the component which implements the StatementEventListener interface that was previously registered with this PooledConnection object

Since:

1.6

fireStatementClosed

public void fireStatementClosed(Statement st)

Fire statement close event to listeners.

Parameters:

st - statement

fireStatementErrorOccured

public void fireStatementErrorOccured(Statement st,
                                      SQLException ex)

Fire statement error to listeners.

Parameters:

st - statement

ex - exception

fireConnectionClosed

public void fireConnectionClosed()

Fire Connection close to listening listeners.

fireConnectionErrorOccured

public void fireConnectionErrorOccured(SQLException ex)

Fire connection error to listening listerners.

Parameters:

ex - exception