-
- All Superinterfaces:
- EventListener
public interface StatementEventListener extends EventListener
An object that registers to be notified of events that occur on PreparedStatements that are in the Statement pool.The JDBC 3.0 specification added the maxStatements
ConnectionPooledDataSource
property to provide a standard mechanism for enabling the pooling ofPreparedStatements
and to specify the size of the statement pool. However, there was no way for a driver to notify an external statement pool when aPreparedStatement
becomes invalid. For some databases, a statement becomes invalid if a DDL operation is performed that affects the table. For example an application may create a temporary table to do some work on the table and then destroy it. It may later recreate the same table when it is needed again. Some databases will invalidate any prepared statements that reference the temporary table when the table is dropped.Similar to the methods defined in the
ConnectionEventListener
interface, the driver will call theStatementEventListener.statementErrorOccurred
method prior to throwing any exceptions when it detects a statement is invalid. The driver will also call theStatementEventListener.statementClosed
method when aPreparedStatement
is closed.Methods which allow a component to register a StatementEventListener with a
PooledConnection
have been added to thePooledConnection
interface.- Since:
- 1.6
-
-
Method Summary
Methods Modifier and Type Method and Description void
statementClosed(StatementEvent event)
The driver calls this method on allStatementEventListener
s registered on the connection when it detects that aPreparedStatement
is closed.void
statementErrorOccurred(StatementEvent event)
The driver calls this method on allStatementEventListener
s registered on the connection when it detects that aPreparedStatement
is invalid.
-
-
-
Method Detail
-
statementClosed
void statementClosed(StatementEvent event)
The driver calls this method on allStatementEventListener
s registered on the connection when it detects that aPreparedStatement
is closed.- Parameters:
event
- an event object describing the source of the event and that thePreparedStatement
was closed.- Since:
- 1.6
-
statementErrorOccurred
void statementErrorOccurred(StatementEvent event)
The driver calls this method on allStatementEventListener
s registered on the connection when it detects that aPreparedStatement
is invalid. The driver calls this method just before it throws theSQLException
, contained in the given event, to the application.- Parameters:
event
- an event object describing the source of the event, the statement that is invalid and the exception the driver is about to throw. The source of the event is thePooledConnection
which the invalidPreparedStatement
is associated with.- Since:
- 1.6
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/sql/statementeventlistener.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.