Class StatementContext

java.lang.Object
org.jdbi.v3.core.statement.StatementContext
All Implemented Interfaces:
Closeable, AutoCloseable

public class StatementContext extends Object implements Closeable
The statement context provides access to statement-local configuration. Context is inherited from the parent Handle initially and changes will not outlive the statement. The context will be passed through most major jdbi APIs.

DISCLAIMER: The class is not intended to be extended. The final modifier is absent to allow mock tools to create a mock object of this class in the user code.

  • Method Details

    • getJdbiStatementType

      @Beta public Type getJdbiStatementType()
      Inspect the type of the statement that owns this statement context.
    • describeJdbiStatementType

      @Beta public String describeJdbiStatementType()
      Returns:
      the type of the statement that owns this statement context as a descriptive string
    • getConfig

      public <C extends JdbiConfig<C>> C getConfig(Class<C> configClass)
      Gets the configuration object of the given type, associated with this context.
      Type Parameters:
      C - the configuration type
      Parameters:
      configClass - the configuration type
      Returns:
      the configuration object of the given type, associated with this context.
    • getConfig

      public ConfigRegistry getConfig()
      Returns the ConfigRegistry.
      Returns:
      the ConfigRegistry used by this context.
    • getAttributes

      public Map<String,Object> getAttributes()
      Returns the attributes applied in this context.
      Returns:
      the defined attributes.
    • getAttribute

      public Object getAttribute(String key)
      Obtain the value of an attribute
      Parameters:
      key - the name of the attribute
      Returns:
      the value of the attribute
    • define

      public void define(String key, Object value)
      Define an attribute for in this context.
      Parameters:
      key - the key for the attribute
      value - the value for the attribute
    • findArgumentFor

      public Optional<Argument> findArgumentFor(Type type, Object value)
      Obtain an argument for given value in this context
      Parameters:
      type - the type of the argument.
      value - the argument value.
      Returns:
      an Argument for the given value.
    • findArgumentFor

      public Optional<Argument> findArgumentFor(QualifiedType<?> type, Object value)
      Obtain an argument for given value in this context
      Parameters:
      type - the type of the argument.
      value - the argument value.
      Returns:
      an Argument for the given value.
    • getSqlArrayArgumentStrategy

      public SqlArrayArgumentStrategy getSqlArrayArgumentStrategy()
      Returns the strategy used by this context to bind array-type arguments to SQL statements.
      Returns:
      the strategy used to bind array-type arguments to SQL statements
    • findSqlArrayTypeFor

      public Optional<SqlArrayType<?>> findSqlArrayTypeFor(Type elementType)
      Obtain an SqlArrayType for the given array element type in this context
      Parameters:
      elementType - the array element type.
      Returns:
      an SqlArrayType for the given element type.
    • findMapperFor

      public <T> Optional<RowMapper<T>> findMapperFor(Class<T> type)
      Obtain a mapper for the given type in this context.
      Type Parameters:
      T - the type to map
      Parameters:
      type - the target type to map to
      Returns:
      a mapper for the given type, or empty if no row or column mappers is registered for the given type.
    • findMapperFor

      public <T> Optional<RowMapper<T>> findMapperFor(GenericType<T> type)
      Obtain a mapper for the given type in this context.
      Type Parameters:
      T - the type to map
      Parameters:
      type - the target type to map to
      Returns:
      a mapper for the given type, or empty if no row or column mappers is registered for the given type.
    • findMapperFor

      public Optional<RowMapper<?>> findMapperFor(Type type)
      Obtain a mapper for the given type in this context.
      Parameters:
      type - the target type to map to
      Returns:
      a mapper for the given type, or empty if no row or column mappers is registered for the given type.
    • findMapperFor

      public <T> Optional<RowMapper<T>> findMapperFor(QualifiedType<T> type)
      Obtain a mapper for the given qualified type in this context.
      Parameters:
      type - the target qualified type to map to
      Returns:
      a mapper for the given qualified type, or empty if no row or column mappers is registered for the given type.
    • findColumnMapperFor

      public <T> Optional<ColumnMapper<T>> findColumnMapperFor(Class<T> type)
      Obtain a column mapper for the given type in this context.
      Type Parameters:
      T - the type to map
      Parameters:
      type - the target type to map to
      Returns:
      a ColumnMapper for the given type, or empty if no column mapper is registered for the given type.
    • findColumnMapperFor

      public <T> Optional<ColumnMapper<T>> findColumnMapperFor(GenericType<T> type)
      Obtain a column mapper for the given type in this context.
      Type Parameters:
      T - the type to map
      Parameters:
      type - the target type to map to
      Returns:
      a ColumnMapper for the given type, or empty if no column mapper is registered for the given type.
    • findColumnMapperFor

      public Optional<ColumnMapper<?>> findColumnMapperFor(Type type)
      Obtain a column mapper for the given type in this context.
      Parameters:
      type - the target type to map to
      Returns:
      a ColumnMapper for the given type, or empty if no column mapper is registered for the given type.
    • findColumnMapperFor

      public <T> Optional<ColumnMapper<T>> findColumnMapperFor(QualifiedType<T> type)
      Obtain a column mapper for the given qualified type in this context.
      Parameters:
      type - the qualified target type to map to
      Returns:
      a ColumnMapper for the given type, or empty if no column mapper is registered for the given type.
    • findRowMapperFor

      public Optional<RowMapper<?>> findRowMapperFor(Type type)
      Obtain a row mapper for the given type in this context.
      Parameters:
      type - the target type to map to
      Returns:
      a RowMapper for the given type, or empty if no row mapper is registered for the given type.
    • findRowMapperFor

      public <T> Optional<RowMapper<T>> findRowMapperFor(Class<T> type)
      Obtain a row mapper for the given type in this context.
      Type Parameters:
      T - the type to map
      Parameters:
      type - the target type to map to
      Returns:
      a RowMapper for the given type, or empty if no row mapper is registered for the given type.
    • findRowMapperFor

      public <T> Optional<RowMapper<T>> findRowMapperFor(GenericType<T> type)
      Obtain a row mapper for the given type in this context.
      Type Parameters:
      T - the type to map
      Parameters:
      type - the target type to map to
      Returns:
      a RowMapper for the given type, or empty if no row mapper is registered for the given type.
    • findCollectorFor

      public Optional<Collector<?,?,?>> findCollectorFor(Type containerType)
      Obtain a collector for the given type.
      Parameters:
      containerType - the container type.
      Returns:
      a Collector for the given container type, or empty null if no collector is registered for the given type.
    • findElementTypeFor

      public Optional<Type> findElementTypeFor(Type containerType)
      Returns the element type for the given container type.
      Parameters:
      containerType - the container type.
      Returns:
      the element type for the given container type, if available.
    • getRawSql

      public String getRawSql()
      Obtain the initial sql for the statement used to create the statement
      Returns:
      the initial sql
    • getRenderedSql

      public String getRenderedSql()
      Obtain the rendered SQL statement

      Not available until until statement execution time

      Returns:
      the sql statement after processing template directives.
    • getParsedSql

      public ParsedSql getParsedSql()
      Obtain the parsed SQL statement

      Not available until until statement execution time

      Returns:
      the sql statement as it will be executed against the database
    • getStatement

      public PreparedStatement getStatement()
      Obtain the actual prepared statement being used.

      Not available until execution time

      Returns:
      Obtain the actual prepared statement being used.
    • getConnection

      public Connection getConnection()
      Obtain the JDBC connection being used for this statement
      Returns:
      the JDBC connection
    • getBinding

      public Binding getBinding()
      Returns the statement binding.
      Returns:
      The statement binding.
    • setReturningGeneratedKeys

      public void setReturningGeneratedKeys(boolean b)
      Sets whether the current statement returns generated keys.
      Parameters:
      b - return generated keys?
    • isReturningGeneratedKeys

      public boolean isReturningGeneratedKeys()
      Whether the statement being generated is expected to return generated keys.
      Returns:
      whether the statement being generated is expected to return generated keys.
    • getGeneratedKeysColumnNames

      public String[] getGeneratedKeysColumnNames()
      Returns the generated key column names or empty if none were generated.
      Returns:
      the generated key column names. Returns an empty array if none exist.
    • setGeneratedKeysColumnNames

      public void setGeneratedKeysColumnNames(String[] generatedKeysColumnNames)
      Set the generated key column names.
      Parameters:
      generatedKeysColumnNames - the generated key column names
    • isConcurrentUpdatable

      public boolean isConcurrentUpdatable()
      Return if the statement should be concurrent updatable. If this returns true, the concurrency level of the created ResultSet will be ResultSet.CONCUR_UPDATABLE, otherwise the result set is not updatable, and will have concurrency level ResultSet.CONCUR_READ_ONLY.
      Returns:
      if the statement generated should be concurrent updatable.
    • setConcurrentUpdatable

      public void setConcurrentUpdatable(boolean concurrentUpdatable)
      Set the context to create a concurrent updatable result set. This cannot be combined with isReturningGeneratedKeys(), only one option may be selected. It does not make sense to combine these either, as one applies to queries, and the other applies to updates.
      Parameters:
      concurrentUpdatable - if the result set should be concurrent updatable.
    • getExecutionMoment

      @Nullable public Instant getExecutionMoment()
      Returns the query execution start as an Instant.
      Returns:
      the Instant at which query execution began
    • setExecutionMoment

      public void setExecutionMoment(Instant executionMoment)
      Sets the query execution start. This is not part of the Jdbi API and should not be called by code outside JDBI.
      Parameters:
      executionMoment - Sets the start of query execution.
    • getCompletionMoment

      @Nullable public Instant getCompletionMoment()
      If query execution was successful, returns the query execution end as an Instant.
      Returns:
      the Instant at which query execution ended, if it did so successfully
    • setCompletionMoment

      public void setCompletionMoment(Instant completionMoment)
      Sets the query execution end. This is not part of the Jdbi API and should not be called by code outside JDBI.
      Parameters:
      completionMoment - Sets the end of query execution.
    • getExceptionMoment

      @Nullable public Instant getExceptionMoment()
      If query execution failed, returns the query execution end as an Instant.
      Returns:
      the Instant at which query execution ended, if it did so with an exception
    • setExceptionMoment

      public void setExceptionMoment(Instant exceptionMoment)
      Sets the query execution end. This is not part of the Jdbi API and should not be called by code outside JDBI.
      Parameters:
      exceptionMoment - Sets the end of query execution.
    • getMappedRows

      @Alpha public long getMappedRows()
      Retrieve the number of mapped rows. Only intended for internal instrumentation to call.
    • setMappedRows

      @Alpha public void setMappedRows(long mappedRows)
      Instrument the number of mapped rows. Only intended for internal instrumentation to call.
    • setTraceId

      @Alpha public void setTraceId(String traceId)
      Instrument the telemetry trace id. Only intended for internal instrumentation to call.
    • getTraceId

      @Alpha public String getTraceId()
      Instrument the telemetry trace id. Only intended for internal instrumentation to call.
    • getElapsedTime

      public long getElapsedTime(ChronoUnit unit)
      Convenience method to measure elapsed time between start of query execution and completion or exception as appropriate. Do not call with a null argument or before a query has executed/exploded.
      Parameters:
      unit - the time unit to convert to
      Returns:
      the elapsed time in the given unit
    • addCleanable

      public void addCleanable(Cleanable cleanable)
      Registers a Cleanable to be invoked when the statement context is closed. Cleanables can be registered on a statement context, which will be cleaned up when the statement finishes or (in the case of a ResultIterator), the object representing the results is closed.

      Resources cleaned up by Jdbi include ResultSet, Statement, Handle, Array, and StatementBuilder.

      Parameters:
      cleanable - the Cleanable to clean on close
    • close

      public void close()
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
    • getExtensionMethod

      public ExtensionMethod getExtensionMethod()
    • equals

      public final boolean equals(Object o)
      Overrides:
      equals in class Object
    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class Object