Interface StatementBuilder

All Known Implementing Classes:
DefaultStatementBuilder

public interface StatementBuilder
Used to convert translated SQL into a prepared statement. The default implementation created by DefaultStatementBuilder.FACTORY creates a new statement on every call. A StatementBuilder is always associated with exactly one Handle instance
See Also:
  • Method Details

    • create

      Called each time a statement needs to be created.
      Parameters:
      conn - the JDBC Connection the statement is being created for
      ctx - Statement context associated with the SqlStatement this is building for
      Returns:
      a Statement
      Throws:
      SQLException - if anything goes wrong getting the statement
    • create

      Called each time a prepared statement needs to be created.
      Parameters:
      conn - the JDBC Connection the statement is being created for
      sql - the translated SQL which should be prepared
      ctx - Statement context associated with the SqlStatement this is building for
      Returns:
      a PreparedStatement for the given arguments
      Throws:
      SQLException - if anything goes wrong preparing the statement
    • createCall

      CallableStatement createCall(Connection conn, String sql, StatementContext ctx) throws SQLException
      Called each time a Callable statement needs to be created.
      Parameters:
      conn - the JDBC Connection the statement is being created for
      sql - the translated SQL which should be prepared
      ctx - Statement context associated with the SqlStatement this is building for
      Returns:
      a CallableStatement for the given arguments
      Throws:
      SQLException - if anything goes wrong preparing the statement
    • close

      void close(Connection conn, String sql, Statement stmt) throws SQLException
      Called to close an individual prepared statement created from this builder.
      Parameters:
      conn - the connection to close
      sql - the translated SQL which was prepared
      stmt - the statement
      Throws:
      SQLException - if anything goes wrong closing the statement
    • close

      void close(Connection conn)
      Called when the handle this StatementBuilder is attached to is closed.
      Parameters:
      conn - the connection to close.