org.mariadb.jdbc

Class MySQLPooledConnection

java.lang.Object

org.mariadb.jdbc.MySQLPooledConnection

All Implemented Interfaces:

PooledConnection

Direct Known Subclasses:

MySQLXAConnection

public class MySQLPooledConnection
extends Object
implements PooledConnection

Constructor Summary

Constructors

Constructor and Description
MySQLPooledConnection(MySQLConnection connection)

Method Summary

Modifier and Type	Method and Description
void	addConnectionEventListener(ConnectionEventListener listener) Registers the given event listener 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()
void	fireConnectionErrorOccured(SQLException e)
void	fireStatementClosed(Statement st)
void	fireStatementErrorOccured(Statement st, SQLException e)
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 listener 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

MySQLPooledConnection

public MySQLPooledConnection(MySQLConnection connection)

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 listener 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 listener 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 listener

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)

fireStatementErrorOccured

public void fireStatementErrorOccured(Statement st,
                                      SQLException e)

fireConnectionClosed

public void fireConnectionClosed()

fireConnectionErrorOccured

public void fireConnectionErrorOccured(SQLException e)