Class StatementLog<T>

java.lang.Object

com.pyranid.StatementLog<T>

@ThreadSafe
public final 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)
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()
static <T> StatementLog.Builder	withStatementContext(StatementContext<T> statementContext)	Creates a StatementLog builder for the given statementContext.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

withStatementContext

@Nonnull
public static <T> StatementLog.Builder withStatementContext(@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