- All Known Implementing Classes:
StatementListenerDispatcher
FbStatement.fetchRows(int), or
FbStatement.execute(RowValue) with a singleton result.
All listener methods have a default implementation that does nothing.
- Since:
- 3.0
- Author:
- Mark Rotteveel
-
Method Summary
Modifier and TypeMethodDescriptiondefault voidafterLast(FbStatement sender) Method to be notified when the cursor of a statement is positioned after the last row.default voidbeforeFirst(FbStatement sender) Method to be notified when the cursor of a statement is positioned before the first row.default voidfetchComplete(FbStatement sender, FetchDirection fetchDirection, int rows) Method to be notified of the number of rows fetched in a singleFbStatement.fetchRows(int).default voidreceivedRow(FbStatement sender, RowValue rowValue) Method to be notified of a new row of data.default voidsqlCounts(FbStatement sender, SqlCountHolder sqlCounts) Called when the SQL counts of a statement have been retrieved.default voidstatementExecuted(FbStatement sender, boolean hasResultSet, boolean hasSingletonResult) Method to be notified when a statement has been executed.default voidstatementStateChanged(FbStatement sender, StatementState newState, StatementState previousState) Method to be notified when the state of a statement has changed.default voidwarningReceived(FbStatement sender, SQLWarning warning) Called when a warning was received for thesenderstatement.
-
Method Details
-
receivedRow
Method to be notified of a new row of data.Listeners that process
beforeFirst(FbStatement)and/orafterLast(FbStatement)should consider calls to this method to clear the before-first or after-last state to an- in-cursor
state.- Parameters:
sender- theFbStatementthat called this methodrowValue- The row values.
-
fetchComplete
Method to be notified of the number of rows fetched in a singleFbStatement.fetchRows(int).This method will not be called for singleton results of statements like
EXECUTE PROCEDURE.When end of cursor is reached, it is undefined whether this method will be called first or
afterLast/beforeFirst. Listeners must be prepared to handle either order.- Parameters:
sender- theFbStatementthat called this methodfetchDirection- fetch direction of the completed fetch operationrows- number of rows fetched in the completed fetch operation (NOTE: for native implementations, this will always be1or0for end of cursor)- Since:
- 6
-
beforeFirst
Method to be notified when the cursor of a statement is positioned before the first row.When server-side scrolling is used, this method can be called multiple times during the lifetime of a single open cursor. This method may be called even if the cursor is already before-first.
- Parameters:
sender- theFbStatementthat called this method- Since:
- 5
- See Also:
-
afterLast
Method to be notified when the cursor of a statement is positioned after the last row.When server-side scrolling is used, this method might be called multiple times during the lifetime of a single open cursor. This method may be called even if the cursor is already after-last.
- Parameters:
sender- theFbStatementthat called this method- Since:
- 5
- See Also:
-
statementExecuted
default void statementExecuted(FbStatement sender, boolean hasResultSet, boolean hasSingletonResult) Method to be notified when a statement has been executed.This event with
hasResultSet=truecan be seen as a counterpart ofafterLast(FbStatement).- Parameters:
sender- theFbStatementthat called this methodhasResultSet-truethere is a result set,falsethere is no result sethasSingletonResult-truesingleton result,falsestatement will produce indeterminate number of rows; can be ignored whenhasResultSetisfalse
-
statementStateChanged
default void statementStateChanged(FbStatement sender, StatementState newState, StatementState previousState) Method to be notified when the state of a statement has changed.- Parameters:
sender- theFbStatementthat called this methodnewState- new state of the statementpreviousState- old state of the statement
-
warningReceived
Called when a warning was received for thesenderstatement.- Parameters:
sender- Statement receiving the warningwarning- Warning
-
sqlCounts
Called when the SQL counts of a statement have been retrieved.- Parameters:
sender- Statement that called this methodsqlCounts- SQL counts
-