Implementations of this interface should be immutable, and should offer public, no argument constructors.
The methods are handed raw, physical database Connections, not c3p0-generated proxies.
Although c3p0 will ensure this with respect to state controlled by standard JDBC methods, any modifications of vendor-specific state shold be made consistently so that all Connections in the pool are interchangable.
| Modifier and Type | Method and Description |
|---|---|
| public void | onAcquire(Connection c, String parentDataSourceIdentityToken)
Called immediately after a Connection is acquired from the underlying database for incorporation into the pool. |
| public void | onCheckIn(Connection c, String parentDataSourceIdentityToken)
Called immediately after a Connection is checked in, prior to reincorporation into the pool. |
| public void | onCheckOut(Connection c, String parentDataSourceIdentityToken)
Called immediately before a Connection is made available to a client upon checkout. |
| public void | onDestroy(Connection c, String parentDataSourceIdentityToken)
Called immediately before a Connection is destroyed after being removed from the pool. |
| onAcquire | back to summary |
|---|---|
| public void onAcquire(Connection c, String parentDataSourceIdentityToken) throws Exception Called immediately after a Connection is acquired from the underlying database for incorporation into the pool. This method is only called once per Connection. If standard JDBC Connection properties are modified — specifically catalog, holdability, transactionIsolation, readOnly, and typeMap — those modifications will override defaults throughout the Connection's tenure in the pool. | |
| onCheckIn | back to summary |
|---|---|
| public void onCheckIn(Connection c, String parentDataSourceIdentityToken) throws Exception Called immediately after a Connection is checked in, prior to reincorporation into the pool. | |
| onCheckOut | back to summary |
|---|---|
| public void onCheckOut(Connection c, String parentDataSourceIdentityToken) throws Exception Called immediately before a Connection is made available to a client upon checkout. | |
| onDestroy | back to summary |
|---|---|
| public void onDestroy(Connection c, String parentDataSourceIdentityToken) throws Exception Called immediately before a Connection is destroyed after being removed from the pool. | |