Class StatementTimer

java.lang.Object

com.kingsrook.qqq.backend.core.instrumentation.StatementTimer

public class StatementTimer
extends Object

Times one statement for StatementExecutionListeners. Backend modules call start() just before executing, succeeded(rows) after it returns, and finish(sql) in a finally block; a statement never marked as succeeded is reported as failed.

 StatementTimer timer = StatementExecutionListeners.start(backend, table, StatementOperation.QUERY);
 try { ...execute...; timer.succeeded(rowCount); }
 finally { timer.finish(sql); }
 

Field Summary

Fields

Modifier and Type	Field	Description
static final StatementTimer	NOOP	The shared timer used while nobody listens; every method is a no-op.

Method Summary

Modifier and Type	Method	Description
void	finish(CharSequence sql)	Report the statement (once).
StatementTimer	succeeded(Integer rowCount)	The statement completed; rows read or affected when known.

Methods inherited from class java.lang.Object

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

Field Details

NOOP

public static final StatementTimer NOOP

The shared timer used while nobody listens; every method is a no-op.

Method Details

succeeded

public StatementTimer succeeded(Integer rowCount)

The statement completed; rows read or affected when known.

finish

public void finish(CharSequence sql)

Report the statement (once). Never throws.