org.jooq.impl

Class DefaultExecuteListener

java.lang.Object

org.jooq.impl.DefaultExecuteListener

All Implemented Interfaces:

java.io.Serializable, java.util.EventListener, ExecuteListener

Direct Known Subclasses:

LoggerListener

public class DefaultExecuteListener
extends java.lang.Object
implements ExecuteListener

A publicly available default implementation of ExecuteListener.

Use this to stay compatible with future API changes (i.e. added methods to ExecuteListener)

Author:

Lukas Eder

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DefaultExecuteListener()

Method Summary

Modifier and Type	Method and Description
void	bindEnd(ExecuteContext ctx) Called after binding variables to the PreparedStatement Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	bindStart(ExecuteContext ctx) Called before binding variables to the PreparedStatement Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	end(ExecuteContext ctx) Called at the end of the execution lifecycle.
void	exception(ExecuteContext ctx) Called in the event of an exception at any moment of the execution lifecycle.
void	executeEnd(ExecuteContext ctx) Called after executing a statement Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	executeStart(ExecuteContext ctx) Called before executing a statement Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	fetchEnd(ExecuteContext ctx) Called after fetching data from a ResultSet.
void	fetchStart(ExecuteContext ctx) Called before fetching data from a ResultSet.
void	outEnd(ExecuteContext ctx) Called after fetching out parameter values from a CallableStatement.
void	outStart(ExecuteContext ctx) Called before fetching out parameter values from a CallableStatement.
void	prepareEnd(ExecuteContext ctx) Called after preparing / creating the SQL statement Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	prepareStart(ExecuteContext ctx) Called before preparing / creating the SQL statement Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	recordEnd(ExecuteContext ctx) Called after fetching a record from a ResultSet Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	recordStart(ExecuteContext ctx) Called before fetching a record from a ResultSet Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	renderEnd(ExecuteContext ctx) Called after rendering SQL from a QueryPart Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	renderStart(ExecuteContext ctx) Called before rendering SQL from a QueryPart Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
void	resultEnd(ExecuteContext ctx) Called after fetching a set of records from a ResultSet Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	resultStart(ExecuteContext ctx) Called before fetching a set of records from a ResultSet Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
void	start(ExecuteContext ctx) Called to initialise an ExecuteListener Available attributes from ExecuteContext: ExecuteContext.connection(): The connection used for execution Scope.configuration(): The execution configuration ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise Overridable attributes in ExecuteContext: ExecuteContext.connectionProvider(ConnectionProvider): The connection provider used for execution.
void	warning(ExecuteContext ctx) Called in the event of a warning at any moment of the execution lifecycle.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultExecuteListener

public DefaultExecuteListener()

Method Detail

start

public void start(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called to initialise an ExecuteListener

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise

Overridable attributes in ExecuteContext:

• ExecuteContext.connectionProvider(ConnectionProvider): The connection provider used for execution. This may be particularly interesting if a Query was de-serialised and is thus lacking the underlying connection

Specified by:

start in interface ExecuteListener

renderStart

public void renderStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before rendering SQL from a QueryPart

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise

Specified by:

renderStart in interface ExecuteListener

renderEnd

public void renderEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after rendering SQL from a QueryPart

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..

Overridable attributes in ExecuteContext:

• ExecuteContext.sql(String): The rendered SQL statement that is about to be executed. You can modify this statement freely.

Specified by:

renderEnd in interface ExecuteListener

prepareStart

public void prepareStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before preparing / creating the SQL statement

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..

Overridable attributes in ExecuteContext:

• ExecuteContext.sql(String): The rendered SQL statement that is about to be executed. You can modify this statement freely.

Specified by:

prepareStart in interface ExecuteListener

prepareEnd

public void prepareEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after preparing / creating the SQL statement

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine

Overridable attributes in ExecuteContext:

• ExecuteContext.statement(PreparedStatement): The Statement, PreparedStatement, or CallableStatement that is about to be executed. You can modify this statement freely, or wrap ExecuteContext.statement() with your enriched statement wrapper

Specified by:

prepareEnd in interface ExecuteListener

bindStart

public void bindStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before binding variables to the PreparedStatement

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine

Overridable attributes in ExecuteContext:

• ExecuteContext.statement(PreparedStatement): The PreparedStatement, or CallableStatement that is about to be executed. You can modify this statement freely, or wrap ExecuteContext.statement() with your enriched statement wrapper

Note that this method is not called when executing queries of type StatementType.STATIC_STATEMENT

Specified by:

bindStart in interface ExecuteListener

bindEnd

public void bindEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after binding variables to the PreparedStatement

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine

Overridable attributes in ExecuteContext:

• ExecuteContext.statement(PreparedStatement): The Statement, PreparedStatement, or CallableStatement that is about to be executed. You can modify this statement freely, or wrap ExecuteContext.statement() with your enriched statement wrapper

Note that this method is not called when executing queries of type StatementType.STATIC_STATEMENT

Specified by:

bindEnd in interface ExecuteListener

executeStart

public void executeStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before executing a statement

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine

Overridable attributes in ExecuteContext:

• ExecuteContext.statement(PreparedStatement): The Statement, PreparedStatement, or CallableStatement that is about to be executed. You can modify this statement freely, or wrap ExecuteContext.statement() with your enriched statement wrapper

Specified by:

executeStart in interface ExecuteListener

executeEnd

public void executeEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after executing a statement

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.resultSet(): The ResultSet that is about to be fetched or null, if the Query returns no result set, or if a Routine is being executed.
• ExecuteContext.rows(): The number of affected rows if applicable. In case a ResultSet is fetched, this number is only available at the ExecuteListener.fetchEnd(ExecuteContext) event.

Overridable attributes in ExecuteContext:

• ExecuteContext.resultSet(ResultSet): The ResultSet that is about to be fetched. You can modify this result set freely, or wrap ExecuteContext.resultSet() with your enriched result set wrapper

Specified by:

executeEnd in interface ExecuteListener

outStart

public void outStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before fetching out parameter values from a CallableStatement.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Note that this method is called only when executing standalone routine calls.

Specified by:

outStart in interface ExecuteListener

outEnd

public void outEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after fetching out parameter values from a CallableStatement.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Note that this method is called only when executing standalone routine calls.

Specified by:

outEnd in interface ExecuteListener

fetchStart

public void fetchStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before fetching data from a ResultSet.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.resultSet(): The ResultSet that is about to be fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Overridable attributes in ExecuteContext:

• ExecuteContext.resultSet(ResultSet): The ResultSet that is about to be fetched. You can modify this result set freely, or wrap ExecuteContext.resultSet() with your enriched result set wrapper

In case of multiple ResultSets with ResultQuery.fetchMany(), this is called several times, once per ResultSet

Note that this method is not called when executing queries that do not return a result, or when executing routines.

Specified by:

fetchStart in interface ExecuteListener

resultStart

public void resultStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before fetching a set of records from a ResultSet

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.resultSet(): The ResultSet that is about to be fetched.
• ExecuteContext.result(): The set of records that are about to be fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Note that this method is not called when executing queries that do not return a result, or when executing routines. This is also not called when fetching single records, with Cursor.fetchOne() for instance.

Specified by:

resultStart in interface ExecuteListener

recordStart

public void recordStart(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called before fetching a record from a ResultSet

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.resultSet(): The ResultSet that is about to be fetched.
• ExecuteContext.record(): The Record that is about to be fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Note that this method is not called when executing queries that do not return a result, or when executing routines.

Specified by:

recordStart in interface ExecuteListener

recordEnd

public void recordEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after fetching a record from a ResultSet

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.resultSet(): The ResultSet that is about to be fetched.
• ExecuteContext.record(): The last Record that was fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Note that this method is not called when executing queries that do not return a result, or when executing routines.

Specified by:

recordEnd in interface ExecuteListener

resultEnd

public void resultEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after fetching a set of records from a ResultSet

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
• ExecuteContext.resultSet(): The ResultSet that is about to be fetched.
• ExecuteContext.record(): The last Record that was fetched.
• ExecuteContext.result(): The set of records that were fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Note that this method is not called when executing queries that do not return a result, or when executing routines. This is also not called when fetching single records, with Cursor.fetchOne() for instance.

Specified by:

resultEnd in interface ExecuteListener

fetchEnd

public void fetchEnd(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called after fetching data from a ResultSet.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
  Note that the Statement is already closed!
• ExecuteContext.resultSet(): The ResultSet that was fetched. Note that the ResultSet is already closed!
• ExecuteContext.rows(): The number of affected rows if applicable.
• ExecuteContext.record(): The last Record that was fetched.
• ExecuteContext.result(): The last set of records that were fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

In case of multiple ResultSets with ResultQuery.fetchMany(), this is called several times, once per ResultSet

Note that this method is not called when executing queries that do not return a result, or when executing routines.

Specified by:

fetchEnd in interface ExecuteListener

end

public void end(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called at the end of the execution lifecycle.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
  Note that the Statement is already closed!
• ExecuteContext.resultSet(): The ResultSet that was fetched or null, if no result set was fetched. Note that the ResultSet may already be closed!
• ExecuteContext.rows(): The number of affected rows if applicable.
• ExecuteContext.record(): The last Record that was fetched or null if no records were fetched.
• ExecuteContext.result(): The last set of records that were fetched or null if no records were fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database or null if no warning was emitted.

Specified by:

end in interface ExecuteListener

exception

public void exception(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called in the event of an exception at any moment of the execution lifecycle.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
  Note that the Statement may be closed!
• ExecuteContext.resultSet(): The ResultSet that was fetched or null, if no result set was fetched. Note that the ResultSet may already be closed!
• ExecuteContext.rows(): The number of affected rows if applicable.
• ExecuteContext.record(): The last Record that was fetched or null if no records were fetched.
• ExecuteContext.result(): The last set of records that were fetched or null if no records were fetched.
• ExecuteContext.exception(): The RuntimeException that is about to be thrown
• ExecuteContext.sqlException(): The SQLException that was thrown by the database

Specified by:

exception in interface ExecuteListener

warning

public void warning(ExecuteContext ctx)

Description copied from interface: ExecuteListener

Called in the event of a warning at any moment of the execution lifecycle.

Available attributes from ExecuteContext:

• ExecuteContext.connection(): The connection used for execution
• Scope.configuration(): The execution configuration
• ExecuteContext.query(): The Query object, if a jOOQ query is being executed or null otherwise
• ExecuteContext.routine(): The Routine object, if a jOOQ routine is being executed or null otherwise
• ExecuteContext.sql(): The rendered SQL statement that is about to be executed, or null if the SQL statement is unknown..
• ExecuteContext.statement(): The PreparedStatement that is about to be executed, or null if no statement is known to jOOQ. This can be any of the following:
  
  
  • A java.sql.PreparedStatement from your JDBC driver when a jOOQ Query is being executed as StatementType.PREPARED_STATEMENT
  • A java.sql.Statement from your JDBC driver wrapped in a java.sql.PreparedStatement when your jOOQ Query is being executed as StatementType.STATIC_STATEMENT
  • A java.sql.CallableStatement when you are executing a jOOQ Routine
  Note that the Statement may be closed!
• ExecuteContext.resultSet(): The ResultSet that was fetched or null, if no result set was fetched. Note that the ResultSet may already be closed!
• ExecuteContext.rows(): The number of affected rows if applicable.
• ExecuteContext.record(): The last Record that was fetched or null if no records were fetched.
• ExecuteContext.result(): The last set of records that were fetched or null if no records were fetched.
• ExecuteContext.sqlWarning(): The SQLWarning that was emitted by the database
• ExecuteContext.exception(): The RuntimeException that is about to be thrown or null, if no exception is being thrown.
• ExecuteContext.sqlException(): The SQLException that was thrown by the database or null, if no exception is being thrown.

This method is only invoked if a warning appears. Note that fetching of warnings can be disabled using Settings.isFetchWarnings()

Specified by:

warning in interface ExecuteListener