org.hibernate.jdbc

Interface Expectation

Known Implementing Classes:
Expectations.BasicExpectation, Expectations.BasicParamExpectation

public interface Expectation

Defines an expected DML operation outcome.
Author:
Steve Ebersole

Method Summary

boolean
canBeBatched()
Is it acceptable to combiner this expectation with statement batching?
int
prepare(PreparedStatement statement)
Perform any special statement preparation.
void
verifyOutcome(int rowCount, PreparedStatement statement, int batchPosition)
Perform verification of the outcome of the RDBMS operation based on the type of expectation defined.

Method Details

canBeBatched

public boolean canBeBatched()
Is it acceptable to combiner this expectation with statement batching?
Returns:
True if batching can be combined with this expectation; false otherwise.

prepare

public int prepare(PreparedStatement statement)
            throws SQLException,
                   HibernateException
Perform any special statement preparation.
Parameters:
statement - The statement to be prepared
Returns:
The number of bind positions consumed (if any)
Throws:
HibernateException - Problem performing preparation.

verifyOutcome

public void verifyOutcome(int rowCount,
                          PreparedStatement statement,
                          int batchPosition)
            throws SQLException,
                   HibernateException
Perform verification of the outcome of the RDBMS operation based on the type of expectation defined.
Parameters:
rowCount - The RDBMS reported "number of rows affected".
statement - The statement representing the operation
batchPosition - The position in the batch (if batching)
Throws:
HibernateException - Problem processing the outcome.