Module java.sql
Package javax.sql

# Class StatementEvent

java.lang.Object
java.util.EventObject
javax.sql.StatementEvent

All Implemented Interfaces:
  `Serializable`

public class StatementEvent extends EventObject
A `StatementEvent` is sent to all `StatementEventListener`s which were registered with a `PooledConnection`. This occurs when the driver determines that a `PreparedStatement` that is associated with the `PooledConnection` has been closed or the driver determines is invalid.

Since:
  1.6
See Also:
  - Serialized Form

## Field Summary

### Fields declared in class java.util.EventObject

`source`

## Constructor Summary

Constructors
Constructor
Description
`StatementEvent(PooledConnection con, PreparedStatement statement)`
Constructs a `StatementEvent` with the specified `PooledConnection` and `PreparedStatement`.
`StatementEvent(PooledConnection con, PreparedStatement statement, SQLException exception)`
Constructs a `StatementEvent` with the specified `PooledConnection`, `PreparedStatement` and `SQLException`

## Method Summary

Modifier and Type
Method
Description
`SQLException`
`getSQLException()`
Returns the `SQLException` the driver is about to throw
`PreparedStatement`
`getStatement()`
Returns the `PreparedStatement` that is being closed or is invalid

### Methods declared in class java.util.EventObject

`getSource, toString`

### Methods declared in class java.lang.Object

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

## Constructor Details

### StatementEvent

public StatementEvent(PooledConnection con, PreparedStatement statement)
Constructs a `StatementEvent` with the specified `PooledConnection` and `PreparedStatement`. The `SQLException` contained in the event defaults to null.

Parameters:
  `con` - The `PooledConnection` that the closed or invalid `PreparedStatement`is associated with.
  `statement` - The `PreparedStatement` that is being closed or is invalid
Throws:
  `IllegalArgumentException` - if `con` is null.
Since:
  1.6

### StatementEvent

public StatementEvent(PooledConnection con, PreparedStatement statement, SQLException exception)
Constructs a `StatementEvent` with the specified `PooledConnection`, `PreparedStatement` and `SQLException`

Parameters:
  `con` - The `PooledConnection` that the closed or invalid `PreparedStatement` is associated with.
  `statement` - The `PreparedStatement` that is being closed or is invalid
  `exception` - The `SQLException` the driver is about to throw to the application
Throws:
  `IllegalArgumentException` - if `con` is null.
Since:
  1.6

## Method Details

### getStatement

public PreparedStatement getStatement()
Returns the `PreparedStatement` that is being closed or is invalid

Returns:
  The `PreparedStatement` that is being closed or is invalid
Since:
  1.6

### getSQLException

public SQLException getSQLException()
Returns the `SQLException` the driver is about to throw

Returns:
  The `SQLException` the driver is about to throw
Since:
  1.6