Package com.pyranid

Class StatementLog<T>

java.lang.Object

com.pyranid.StatementLog<T>

@ThreadSafe
public class StatementLog<T>
extends Object

A collection of SQL statement execution diagnostics.

Since:

1.0.0

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	StatementLog.Builder<T>	Builder used to construct instances of StatementLog.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object object)
static <T> StatementLog.Builder	forStatementContext(StatementContext<T> statementContext)	Creates a StatementLog builder for the given statementContext.
Optional<Integer>	getBatchSize()	The size of the batch operation.
Optional<Duration>	getConnectionAcquisitionDuration()	How long did it take to acquire a Connection from the DataSource?
Optional<Exception>	getException()	The exception that occurred during SQL statement execution.
Optional<Duration>	getExecutionDuration()	How long did it take to execute the SQL statement?
Optional<Duration>	getPreparationDuration()	How long did it take to bind data to the PreparedStatement?
Optional<Duration>	getResultSetMappingDuration()	How long did it take to extract data from the ResultSet?
StatementContext<T>	getStatementContext()	The SQL statement that was executed.
Duration	getTotalDuration()	How long did it take to perform the database operation in total?
int	hashCode()
String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

forStatementContext

@Nonnull
public static <T> StatementLog.Builder forStatementContext(@Nonnull
 StatementContext<T> statementContext)

Creates a StatementLog builder for the given statementContext.

Parameters:

statementContext - current SQL context

Returns:

a StatementLog builder

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object object)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getConnectionAcquisitionDuration

@Nonnull
public Optional<Duration> getConnectionAcquisitionDuration()

How long did it take to acquire a Connection from the DataSource?

Returns:

how long it took to acquire a Connection, if available

getPreparationDuration

@Nonnull
public Optional<Duration> getPreparationDuration()

How long did it take to bind data to the PreparedStatement?

Returns:

how long it took to bind data to the PreparedStatement, if available

getExecutionDuration

public Optional<Duration> getExecutionDuration()

How long did it take to execute the SQL statement?

Returns:

how long it took to execute the SQL statement, if available

getResultSetMappingDuration

public Optional<Duration> getResultSetMappingDuration()

How long did it take to extract data from the ResultSet?

Returns:

how long it took to extract data from the ResultSet, if available

getTotalDuration

@Nonnull
public Duration getTotalDuration()

How long did it take to perform the database operation in total?

This is the sum of getConnectionAcquisitionDuration() + getPreparationDuration() + getExecutionDuration() + getResultSetMappingDuration().

Returns:

how long the database operation took in total

getStatementContext

@Nonnull
public StatementContext<T> getStatementContext()

The SQL statement that was executed.

Returns:

the SQL statement that was executed.

getBatchSize

@Nonnull
public Optional<Integer> getBatchSize()

The size of the batch operation.

Returns:

how many records were processed as part of the batch operation, if available

getException

@Nonnull
public Optional<Exception> getException()

The exception that occurred during SQL statement execution.

Returns:

the exception that occurred during SQL statement execution, if available