MySQL Connector/J 9.2.0 · com.mysql.cj.jdbc.MysqlPooledConnection

Modifier and Type	Field and Description
public static final int	CONNECTION_CLOSED_EVENT The flag for a connection being closed.
public static final int	CONNECTION_ERROR_EVENT The flag for an exception being thrown.
private Map<ConnectionEventListener, ConnectionEventListener>	connectionEventListeners
private ExceptionInterceptor	exceptionInterceptor
protected final Lock	lock
private Connection	logicalHandle
private JdbcConnection	physicalConn
private final Map<StatementEventListener, StatementEventListener>	statementEventListeners
private final Lock	statementEventListenersLock

Access	Constructor and Description
public	MysqlPooledConnection(JdbcConnection physical connection to db connection) Construct a new MysqlPooledConnection and set instance variables

Method Summary

Modifier and Type	Method and Description
public void	addConnectionEventListener(ConnectionEventListener 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 connectioneventlistener) Implements javax.sql.PooledConnection.addConnectionEventListener. Registers the given event listener so that it will be notified when an event occurs on this `PooledConnection` object.
public void	addStatementEventListener(StatementEventListener an component which implements the `StatementEventListener` interface that is to be registered with this `PooledConnection` object listener) Implements javax.sql.PooledConnection.addStatementEventListener. Registers a `StatementEventListener` with this `PooledConnection` object.
protected void	callConnectionEventListeners(int value indicating whether connectionClosed or connectionErrorOccurred called eventType, SQLException the exception being thrown sqlException) Notifies all registered ConnectionEventListeners of ConnectionEvents.
public void	close() Implements javax.sql.PooledConnection.close. Invoked by the container (not the client), and should close the physical connection.
pack-priv void	fireStatementEvent(StatementEvent event)
public Connection	getConnection() Implements javax.sql.PooledConnection.getConnection. Creates and returns a `Connection` object that is a handle for the physical connection that this `PooledConnection` object represents.
protected Connection	getConnection(boolean resetServerState, boolean forXa)
protected ExceptionInterceptor	getExceptionInterceptor()
protected static MysqlPooledConnection	getInstance(JdbcConnection connection)
public Lock	getLock()
public void	removeConnectionEventListener(ConnectionEventListener a component, usually the connection pool manager, that has implemented the `ConnectionEventListener` interface and been registered with this `PooledConnection` object as a listener connectioneventlistener) Implements javax.sql.PooledConnection.removeConnectionEventListener. Removes the given event listener from the list of components that will be notified when an event occurs on this `PooledConnection` object.
public void	removeStatementEventListener(StatementEventListener the component which implements the `StatementEventListener` interface that was previously registered with this `PooledConnection` object listener) Implements javax.sql.PooledConnection.removeStatementEventListener. 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.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

CONNECTION_CLOSED_EVENT	back to summary
public static final int CONNECTION_CLOSED_EVENT The flag for a connection being closed.

CONNECTION_ERROR_EVENT	back to summary
public static final int CONNECTION_ERROR_EVENT The flag for an exception being thrown.

connectionEventListeners	back to summary
private Map<ConnectionEventListener, ConnectionEventListener> connectionEventListeners

exceptionInterceptor	back to summary
private ExceptionInterceptor exceptionInterceptor

lock	back to summary
protected final Lock lock

logicalHandle	back to summary
private Connection logicalHandle

physicalConn	back to summary
private JdbcConnection physicalConn

statementEventListeners	back to summary
private final Map<StatementEventListener, StatementEventListener> statementEventListeners

statementEventListenersLock	back to summary
private final Lock statementEventListenersLock

MysqlPooledConnection	back to summary
public MysqlPooledConnection(JdbcConnection connection) Construct a new MysqlPooledConnection and set instance variables Parameters connection:JdbcConnection physical connection to db

Method Detail

addConnectionEventListener back to summary

addConnectionEventListener	back to summary
public void addConnectionEventListener(ConnectionEventListener connectioneventlistener) Implements javax.sql.PooledConnection.addConnectionEventListener. Doc from javax.sql.PooledConnection.addConnectionEventListener. Registers the given event listener so that it will be notified when an event occurs on this `PooledConnection` object. Parameters connectioneventlistener:ConnectionEventListener 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 Annotations @Override

public void addConnectionEventListener(ConnectionEventListener connectioneventlistener)

Implements javax.sql.PooledConnection.addConnectionEventListener.

Doc from javax.sql.PooledConnection.addConnectionEventListener.

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

Parameters

connectioneventlistener:ConnectionEventListener: 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

Annotations

@Override

addStatementEventListener back to summary

addStatementEventListener	back to summary
public void addStatementEventListener(StatementEventListener listener) Implements javax.sql.PooledConnection.addStatementEventListener. Doc from javax.sql.PooledConnection.addStatementEventListener. Registers a `StatementEventListener` with this `PooledConnection` object. Components that wish to be notified when `PreparedStatement`s created by the connection are closed or are detected to be invalid may use this method to register a `StatementEventListener` with this `PooledConnection` object. Parameters listener:StatementEventListener an component which implements the `StatementEventListener` interface that is to be registered with this `PooledConnection` object Annotations @Override

public void addStatementEventListener(StatementEventListener listener)

Implements javax.sql.PooledConnection.addStatementEventListener.

Doc from javax.sql.PooledConnection.addStatementEventListener.

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.

Parameters

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

Annotations

@Override

callConnectionEventListeners	back to summary
protected void callConnectionEventListeners(int eventType, SQLException sqlException) Notifies all registered ConnectionEventListeners of ConnectionEvents. Instantiates a new ConnectionEvent which wraps sqlException and invokes either connectionClose or connectionErrorOccurred on listener as appropriate. Parameters eventType:int value indicating whether connectionClosed or connectionErrorOccurred called sqlException:SQLException the exception being thrown

callConnectionEventListeners

back to summary

protected void callConnectionEventListeners(int eventType, SQLException sqlException)

Notifies all registered ConnectionEventListeners of ConnectionEvents. Instantiates a new ConnectionEvent which wraps sqlException and invokes either connectionClose or connectionErrorOccurred on listener as appropriate.

Parameters

eventType:int: value indicating whether connectionClosed or connectionErrorOccurred called
sqlException:SQLException: the exception being thrown

close	back to summary
public void close() throws SQLException Implements javax.sql.PooledConnection.close. Invoked by the container (not the client), and should close the physical connection. This will be called if the pool is destroyed or the connectionEventListener receives a connectionErrorOccurred event. Annotations @Override Exceptions SQLException: Doc from javax.sql.PooledConnection.close. if a database access error occurs

back to summary

public void close() throws SQLException

Implements javax.sql.PooledConnection.close.

Invoked by the container (not the client), and should close the physical connection. This will be called if the pool is destroyed or the connectionEventListener receives a connectionErrorOccurred event.

Annotations

@Override

Exceptions

SQLException:

Doc from javax.sql.PooledConnection.close.

if a database access error occurs

fireStatementEvent	back to summary
pack-priv void fireStatementEvent(StatementEvent event) throws SQLException

getConnection back to summary

getConnection	back to summary
public Connection getConnection() throws SQLException Implements javax.sql.PooledConnection.getConnection. Doc from javax.sql.PooledConnection.getConnection. 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. Returns:Connection a `Connection` object that is a handle to this `PooledConnection` object Annotations @Override Exceptions SQLException: if a database access error occurs

public Connection getConnection() throws SQLException

Implements javax.sql.PooledConnection.getConnection.

Doc from javax.sql.PooledConnection.getConnection.

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.

Returns:Connection

a Connection object that is a handle to this PooledConnection object

Annotations

@Override

Exceptions

SQLException:: if a database access error occurs

getConnection	back to summary
protected Connection getConnection(boolean resetServerState, boolean forXa) throws SQLException

getExceptionInterceptor	back to summary
protected ExceptionInterceptor getExceptionInterceptor()

getInstance	back to summary
protected static MysqlPooledConnection getInstance(JdbcConnection connection) throws SQLException

getLock	back to summary
public Lock getLock()

removeConnectionEventListener back to summary

removeConnectionEventListener	back to summary
public void removeConnectionEventListener(ConnectionEventListener connectioneventlistener) Implements javax.sql.PooledConnection.removeConnectionEventListener. Doc from javax.sql.PooledConnection.removeConnectionEventListener. Removes the given event listener from the list of components that will be notified when an event occurs on this `PooledConnection` object. Parameters connectioneventlistener:ConnectionEventListener a component, usually the connection pool manager, that has implemented the `ConnectionEventListener` interface and been registered with this `PooledConnection` object as a listener Annotations @Override

public void removeConnectionEventListener(ConnectionEventListener connectioneventlistener)

Implements javax.sql.PooledConnection.removeConnectionEventListener.

Doc from javax.sql.PooledConnection.removeConnectionEventListener.

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

Parameters

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

Annotations

@Override

removeStatementEventListener back to summary

removeStatementEventListener	back to summary
public void removeStatementEventListener(StatementEventListener listener) Implements javax.sql.PooledConnection.removeStatementEventListener. Doc from javax.sql.PooledConnection.removeStatementEventListener. 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. Parameters listener:StatementEventListener the component which implements the `StatementEventListener` interface that was previously registered with this `PooledConnection` object Annotations @Override

public void removeStatementEventListener(StatementEventListener listener)

Implements javax.sql.PooledConnection.removeStatementEventListener.

Doc from javax.sql.PooledConnection.removeStatementEventListener.

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.

Parameters

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

Annotations

@Override

public Class MysqlPooledConnection

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail