# ConnectionEventListener

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# ConnectionEventListener

```
interface ConnectionEventListener : EventListener
```

|------------------------------------------------------------------------------------------------------------------------|
| [javax.sql.ConnectionEventListener](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEventListener#) |

An object that registers to be notified of events generated by a`PooledConnection`object.

The`ConnectionEventListener`interface is implemented by a connection pooling component. A connection pooling component will usually be provided by a JDBC driver vendor or another system software vendor. A JDBC driver notifies a`ConnectionEventListener`object when an application is finished using a pooled connection with which the listener has registered. The notification occurs after the application calls the method`close`on its representation of a`PooledConnection`object. A`ConnectionEventListener`is also notified when a connection error occurs due to the fact that the`PooledConnection`is unfit for future use---the server has crashed, for example. The listener is notified by the JDBC driver just before the driver throws an`SQLException`to the application using the`PooledConnection`object.

## Summary

|                                                                                                                                                                                                                                     Public methods                                                                                                                                                                                                                                     ||
|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| abstract[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [connectionClosed](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEventListener#connectionClosed(javax.sql.ConnectionEvent))`(`event:` `[ConnectionEvent](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEvent)!`)` Notifies this`ConnectionEventListener`that the application has called the method`close`on its representation of a pooled connection. |
| abstract[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html) | [connectionErrorOccurred](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEventListener#connectionErrorOccurred(javax.sql.ConnectionEvent))`(`event:` `[ConnectionEvent](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEvent)!`)` Notifies this`ConnectionEventListener`that a fatal error has occurred and the pooled connection can no longer be used. |

## Public methods

### connectionClosed

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun connectionClosed(event: ConnectionEvent!): Unit
```

Notifies this`ConnectionEventListener`that the application has called the method`close`on its representation of a pooled connection.

|                                                                        Parameters                                                                        ||
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| `event` | [ConnectionEvent](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEvent)!:an event object describing the source of the event |

### connectionErrorOccurred

Added in[API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun connectionErrorOccurred(event: ConnectionEvent!): Unit
```

Notifies this`ConnectionEventListener`that a fatal error has occurred and the pooled connection can no longer be used. The driver makes this notification just before it throws the application the`SQLException`contained in the given`ConnectionEvent`object.

|                                                                                                         Parameters                                                                                                         ||
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `event` | [ConnectionEvent](https://developer.android.com/reference/kotlin/javax/sql/ConnectionEvent)!:an event object describing the source of the event and containing the`SQLException`that the driver is about to throw |