Package org.eclipse.emf.cdo.server.db

Interface IBatchingContext

All Superinterfaces:
org.eclipse.net4j.db.BatchedStatement.Context
public interface IBatchingContext extends org.eclipse.net4j.db.BatchedStatement.Context
Supplies the database context used while executing a batch of statements.
Since:
4.15
Author:
Eike Stepper

  • Method Summary

    Modifier and Type
    Method
    Description
    default org.eclipse.net4j.db.BatchedStatement
    createStatement(String sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability)
     
    org.eclipse.net4j.db.BatchedStatement
    createStatement(String sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability, String diagnosticName)
     
    default org.eclipse.net4j.db.BatchedStatement
    createStatement(org.eclipse.net4j.db.dml.SQLStatement sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability)
    Creates a batched statement from a compiled SQL definition.
    default org.eclipse.net4j.db.BatchedStatement
    createStatement(org.eclipse.net4j.db.dml.SQLStatement sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability, String diagnosticName)
    Creates a batched statement from a compiled SQL definition through the existing connection and batching path.
    void
    discardStatement(org.eclipse.net4j.db.BatchedStatement statement)
     
    void
    flushPhase()
     
    void
    flushStatement(org.eclipse.net4j.db.BatchedStatement statement)
     
    void
    recordDiagnosticCounter(String name)
     
    void
    recordDiagnosticCounter(String name, long value)
    Adds a value to an optional mapping-specific diagnostic counter.
    void
    releaseStatement(org.eclipse.net4j.db.BatchedStatement statement)
     

    Methods inherited from interface org.eclipse.net4j.db.BatchedStatement.Context

    afterExecuteUpdate, manageStatement, manageStatement

  • Method Details

    • createStatement

      default org.eclipse.net4j.db.BatchedStatement createStatement(String sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability)

    • createStatement

      org.eclipse.net4j.db.BatchedStatement createStatement(String sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability, String diagnosticName)

    • createStatement

      default org.eclipse.net4j.db.BatchedStatement createStatement(org.eclipse.net4j.db.dml.SQLStatement sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability)
      Creates a batched statement from a compiled SQL definition.
      Parameters:
      sql - the compiled statement definition
      reuseProbability - the existing statement-cache reuse hint
      Returns:
      the managed batched statement
      Since:
      4.16

    • createStatement

      default org.eclipse.net4j.db.BatchedStatement createStatement(org.eclipse.net4j.db.dml.SQLStatement sql, org.eclipse.net4j.db.IDBPreparedStatement.ReuseProbability reuseProbability, String diagnosticName)
      Creates a batched statement from a compiled SQL definition through the existing connection and batching path. The compiled SQL text remains the key used by the connection's prepared-statement cache.
      Parameters:
      sql - the compiled statement definition
      reuseProbability - the existing statement-cache reuse hint
      diagnosticName - the optional name used by batching diagnostics
      Returns:
      the managed batched statement
      Since:
      4.16

    • releaseStatement

      void releaseStatement(org.eclipse.net4j.db.BatchedStatement statement)

    • discardStatement

      void discardStatement(org.eclipse.net4j.db.BatchedStatement statement)

    • flushStatement

      void flushStatement(org.eclipse.net4j.db.BatchedStatement statement)

    • flushPhase

      void flushPhase()

    • recordDiagnosticCounter

      void recordDiagnosticCounter(String name)

    • recordDiagnosticCounter

      void recordDiagnosticCounter(String name, long value)
      Adds a value to an optional mapping-specific diagnostic counter.

      Counter names and values are diagnostic metadata only. They do not participate in statement scheduling, execution ordering, or batching decisions.

      Parameters:
      name - the short counter name
      value - the value to add