com.mockrunner.jdbc

Class AbstractParameterResultSetHandler

java.lang.Object

com.mockrunner.jdbc.AbstractResultSetHandler

com.mockrunner.jdbc.AbstractParameterResultSetHandler

Direct Known Subclasses:

AbstractOutParameterResultSetHandler, PreparedStatementResultSetHandler

public abstract class AbstractParameterResultSetHandler
extends AbstractResultSetHandler

Abstract base class for all statement types that support parameters, i.e. PreparedStatement and CallableStatement.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	exactMatchParameter

Constructor Summary

Constructors

Constructor and Description
AbstractParameterResultSetHandler()

Method Summary

Modifier and Type	Method and Description
void	addParameterMapForExecutedStatement(String sql, MockParameterMap parameters) Collects all SQL strings that were executed.
Map<String,ParameterSets>	getExecutedStatementParameter() Deprecated. use getExecutedStatementParameterMap()
Map<String,ParameterSets>	getExecutedStatementParameterMap() Returns the Map of executed SQL strings.
MockResultSet	getGeneratedKeys(String sql, MockParameterMap parameters) Returns the first generated keys ResultSet that matches the specified SQL string.
ParameterSets	getParametersForExecutedStatement(String sql) Returns the ParameterSets for a specified SQL string.
MockResultSet	getResultSet(String sql, MockParameterMap parameters) Returns the first ResultSet that matches the specified SQL string and the specified parameters.
MockResultSet[]	getResultSets(String sql, MockParameterMap parameters) Returns the first ResultSet[] that matches the specified SQL string and the specified parameters.
SQLException	getSQLException(String sql, MockParameterMap parameters) Returns the SQLException the specified SQL string should throw.
boolean	getThrowsSQLException(String sql, MockParameterMap parameters) Returns if the specified SQL string with the specified parameters should raise an exception.
Integer	getUpdateCount(String sql, MockParameterMap parameters) Returns the first update count that matches the specified SQL string and the specified parameters.
Integer[]	getUpdateCounts(String sql, MockParameterMap parameters) Returns the first update count array that matches the specified SQL string and the specified parameters.
boolean	hasMultipleResultSets(String sql, MockParameterMap parameters) Returns the if the specified SQL string with the specified parameters returns multiple result sets.
boolean	hasMultipleUpdateCounts(String sql, MockParameterMap parameters) Returns the if the specified SQL string with the specified parameters returns multiple update counts.
void	prepareGeneratedKeys(String sql, MockResultSet generatedKeysResult) Prepare the generated keys ResultSet for a specified SQL string with an empty parameter map.
void	prepareGeneratedKeys(String sql, MockResultSet generatedKeysResult, List<Object> parameters) Prepare the generated keys ResultSet for a specified SQL string.
void	prepareGeneratedKeys(String sql, MockResultSet generatedKeysResult, MockParameterMap parameters) Prepare the generated keys ResultSet for a specified SQL string.
void	prepareGeneratedKeys(String sql, MockResultSet generatedKeysResult, Object[] parameters) Prepare the generated keys ResultSet for a specified SQL string.
void	prepareResultSet(String sql, MockResultSet resultSet) Prepare a ResultSet for a specified SQL string and an empty parameter map.
void	prepareResultSet(String sql, MockResultSet resultSet, List<Object> parameters) Prepare a ResultSet for a specified SQL string and the specified parameters.
void	prepareResultSet(String sql, MockResultSet resultSet, MockParameterMap parameters) Prepare a ResultSet for a specified SQL string and the specified parameters.
void	prepareResultSet(String sql, MockResultSet resultSet, Object[] parameters) Prepare a ResultSet for a specified SQL string and the specified parameters.
void	prepareResultSets(String sql, MockResultSet[] resultSets) Prepare an array of ResultSet objects for a specified SQL string and an empty parameter map.
void	prepareResultSets(String sql, MockResultSet[] resultSets, List<Object> parameters) Prepare an array of ResultSet objects for a specified SQL string and the specified parameters.
void	prepareResultSets(String sql, MockResultSet[] resultSets, MockParameterMap parameters) Prepare an array of ResultSet objects for a specified SQL string and the specified parameters.
void	prepareResultSets(String sql, MockResultSet[] resultSets, Object[] parameters) Prepare an array of ResultSet objects for a specified SQL string and the specified parameters.
void	prepareThrowsSQLException(String sql) Prepare that the specified SQL string with empty parameters should raise an exception.
void	prepareThrowsSQLException(String sql, List<Object> parameters) Prepare that the specified SQL string with the specified parameters should raise an exception.
void	prepareThrowsSQLException(String sql, MockParameterMap parameters) Prepare that the specified SQL string with the specified parameters should raise an exception.
void	prepareThrowsSQLException(String sql, Object[] parameters) Prepare that the specified SQL string with the specified parameters should raise an exception.
void	prepareThrowsSQLException(String sql, SQLException exc) Prepare that the specified SQL string with empty parameters should raise an exception.
void	prepareThrowsSQLException(String sql, SQLException exc, List<Object> parameters) Prepare that the specified SQL string with the specified parameters should raise an exception.
void	prepareThrowsSQLException(String sql, SQLException exc, MockParameterMap parameters) Prepare that the specified SQL string with the specified parameters should raise an exception.
void	prepareThrowsSQLException(String sql, SQLException exc, Object[] parameters) Prepare that the specified SQL string with the specified parameters should raise an exception.
void	prepareUpdateCount(String sql, int updateCount) Prepare the update count for execute update calls for a specified SQL string with an empty parameter map.
void	prepareUpdateCount(String sql, int updateCount, List<Object> parameters) Prepare the update count for execute update calls for a specified SQL string and the specified parameters.
void	prepareUpdateCount(String sql, int updateCount, MockParameterMap parameters) Prepare the update count for execute update calls for a specified SQL string and the specified parameters.
void	prepareUpdateCount(String sql, int updateCount, Object[] parameters) Prepare the update count for execute update calls for a specified SQL string and the specified parameters.
void	prepareUpdateCounts(String sql, Integer[] updateCounts) Prepare the update counts for execute update calls for a specified SQL string with an empty parameter map.
void	prepareUpdateCounts(String sql, Integer[] updateCounts, List<Object> parameters) Prepare an array update count values for execute update calls for a specified SQL string and the specified parameters.
void	prepareUpdateCounts(String sql, Integer[] updateCounts, MockParameterMap parameters) Prepare an array update count values for execute update calls for a specified SQL string and the specified parameters.
void	prepareUpdateCounts(String sql, Integer[] updateCounts, Object[] parameters) Prepare an array update count values for execute update calls for a specified SQL string and the specified parameters.
void	removeGeneratedKeys(String sql, MockParameterMap parameters) Remove the generated keys mock for the specified SQL string.
void	removeResultSet(String sql, MockParameterMap parameters) Given a SQL string, remove the associated entry from the resultSetsForStatement TreeMap
void	removeThrowsSqlException(String sql, MockParameterMap parameters) Remove the throws mock for the specified SQL string.
void	removeUpdateCount(String sql, MockParameterMap parameters) Remove the update count mock for the specified SQL string.
void	setExactMatchParameter(boolean exactMatchParameter) Sets if the specified parameters must match exactly in order and number.

Methods inherited from class com.mockrunner.jdbc.AbstractResultSetHandler

addExecutedStatement, addReturnedResultSet, addReturnedResultSets, clearGeneratedKeys, clearGlobalGeneratedKeys, clearGlobalResultSet, clearGlobalUpdateCount, clearResultSets, clearReturnsResultSet, clearThrowsSQLException, clearUpdateCounts, createResultSet, createResultSet, createResultSet, createResultSet, getCaseSensitive, getContinueProcessingOnBatchFailure, getExactMatch, getExecutedStatements, getGeneratedKeys, getGeneratedKeys, getGlobalGeneratedKeys, getGlobalResultSet, getGlobalResultSets, getGlobalUpdateCount, getGlobalUpdateCounts, getListFromMapForSQLStatement, getMatchingObjects, getMatchingParameterWrapper, getPatternMatcherFactory, getResultSet, getResultSet, getResultSetFactory, getResultSets, getResultSets, getReturnedResultSets, getReturnsResultSet, getSQLException, getSQLException, getThrowsSQLException, getUpdateCount, getUpdateCount, getUpdateCounts, getUpdateCounts, getUseRegularExpressions, hasMultipleGlobalResultSets, hasMultipleGlobalUpdateCounts, hasMultipleResultSets, hasMultipleResultSets, hasMultipleUpdateCounts, hasMultipleUpdateCounts, onPatternMatcherFactoryChanged, prepareGlobalGeneratedKeys, prepareGlobalResultSet, prepareGlobalResultSets, prepareGlobalUpdateCount, prepareGlobalUpdateCounts, prepareReturnsResultSet, recompile, removeAllGeneratedKeys, removeAllResultSet, removeAllThrowsSqlException, removeAllUpdateCount, removeGeneratedKeys, removeGeneratedKeys, removeMatchingParameterWrapper, removeResultSet, removeResultSet, removeThrowsSqlException, removeThrowsSqlException, removeUpdateCount, removeUpdateCount, resetPatternMatcherFactory, setCaseSensitive, setContinueProcessingOnBatchFailure, setExactMatch, setPatternMatcherFactory, setResultSetFactory, setUseRegularExpressions

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

exactMatchParameter

protected boolean exactMatchParameter

Constructor Detail

AbstractParameterResultSetHandler

public AbstractParameterResultSetHandler()

Method Detail

addParameterMapForExecutedStatement

public void addParameterMapForExecutedStatement(String sql,
                                                MockParameterMap parameters)

Collects all SQL strings that were executed.

Parameters:

sql - the SQL string

parameters - a copy of the corresponding parameter map

getParametersForExecutedStatement

public ParameterSets getParametersForExecutedStatement(String sql)

Returns the ParameterSets for a specified SQL string.

Parameters:

sql - the SQL string

Returns:

the Map of parameters

getExecutedStatementParameterMap

public Map<String,ParameterSets> getExecutedStatementParameterMap()

Returns the Map of executed SQL strings. Each string maps to the corresponding ParameterSets object.

Returns:

the Map of parameters

getExecutedStatementParameter

@Deprecated
public Map<String,ParameterSets> getExecutedStatementParameter()

Deprecated. use getExecutedStatementParameterMap()

setExactMatchParameter

public void setExactMatchParameter(boolean exactMatchParameter)

Sets if the specified parameters must match exactly in order and number. Defaults to false, i.e. the specified parameters must be present in the actual parameter list of the prepared statement with the correct index but it's ok if there are more actual parameters.

Parameters:

exactMatchParameter - must parameters match exactly

getUpdateCount

public Integer getUpdateCount(String sql,
                              MockParameterMap parameters)

Returns the first update count that matches the specified SQL string and the specified parameters. If the specified SQL string was prepared to return multiple update counts, the first one will be returned. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the corresponding update count

getUpdateCounts

public Integer[] getUpdateCounts(String sql,
                                 MockParameterMap parameters)

Returns the first update count array that matches the specified SQL string and the specified parameters. If the specified SQL string was prepared to return one update count, this value will be wrapped in an array with one element. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the corresponding update count

hasMultipleUpdateCounts

public boolean hasMultipleUpdateCounts(String sql,
                                       MockParameterMap parameters)

Returns the if the specified SQL string with the specified parameters returns multiple update counts. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean).

Parameters:

sql - the SQL string

Returns:

true if the SQL string returns multiple update counts, false otherwise

getResultSet

public MockResultSet getResultSet(String sql,
                                  MockParameterMap parameters)

Returns the first ResultSet that matches the specified SQL string and the specified parameters. If the specified SQL string was prepared to return multiple result sets, the first one will be returned. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the corresponding MockResultSet

getResultSets

public MockResultSet[] getResultSets(String sql,
                                     MockParameterMap parameters)

Returns the first ResultSet[] that matches the specified SQL string and the specified parameters. If the specified SQL string was prepared to return one single ResultSet, this ResultSet will be wrapped in an array with one element. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the corresponding update count

hasMultipleResultSets

public boolean hasMultipleResultSets(String sql,
                                     MockParameterMap parameters)

Returns the if the specified SQL string with the specified parameters returns multiple result sets. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean).

Parameters:

sql - the SQL string

Returns:

true if the SQL string returns multiple update counts, false otherwise

getThrowsSQLException

public boolean getThrowsSQLException(String sql,
                                     MockParameterMap parameters)

Returns if the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

true if the specified SQL string should raise an exception, false otherwise

getSQLException

public SQLException getSQLException(String sql,
                                    MockParameterMap parameters)

Returns the SQLException the specified SQL string should throw. Returns null if the specified SQL string should not throw an exception. This can be used to simulate database exceptions. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the SQLException or null

getGeneratedKeys

public MockResultSet getGeneratedKeys(String sql,
                                      MockParameterMap parameters)

Returns the first generated keys ResultSet that matches the specified SQL string. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the corresponding generated keys MockResultSet

prepareResultSet

public void prepareResultSet(String sql,
                             MockResultSet resultSet)

Prepare a ResultSet for a specified SQL string and an empty parameter map.

Overrides:

prepareResultSet in class AbstractResultSetHandler

Parameters:

sql - the SQL string

resultSet - the corresponding MockResultSet

prepareResultSets

public void prepareResultSets(String sql,
                              MockResultSet[] resultSets)

Prepare an array of ResultSet objects for a specified SQL string and an empty parameter map.

Overrides:

prepareResultSets in class AbstractResultSetHandler

Parameters:

sql - the SQL string

resultSets - the corresponding MockResultSet[]

prepareResultSet

public void prepareResultSet(String sql,
                             MockResultSet resultSet,
                             Object[] parameters)

Prepare a ResultSet for a specified SQL string and the specified parameters. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

resultSet - the corresponding MockResultSet

parameters - the parameters

prepareResultSets

public void prepareResultSets(String sql,
                              MockResultSet[] resultSets,
                              Object[] parameters)

Prepare an array of ResultSet objects for a specified SQL string and the specified parameters. This method can be used for queries that return multiple result sets. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

resultSets - the corresponding MockResultSet[]

parameters - the parameters

prepareResultSet

public void prepareResultSet(String sql,
                             MockResultSet resultSet,
                             List<Object> parameters)

Prepare a ResultSet for a specified SQL string and the specified parameters. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

resultSet - the corresponding MockResultSet

parameters - the parameters

prepareResultSets

public void prepareResultSets(String sql,
                              MockResultSet[] resultSets,
                              List<Object> parameters)

Prepare an array of ResultSet objects for a specified SQL string and the specified parameters. This method can be used for queries that return multiple result sets. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

resultSets - the corresponding MockResultSet[]

parameters - the parameters

prepareResultSet

public void prepareResultSet(String sql,
                             MockResultSet resultSet,
                             MockParameterMap parameters)

Prepare a ResultSet for a specified SQL string and the specified parameters. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareResultSet in class AbstractResultSetHandler

Parameters:

sql - the SQL string

resultSet - the corresponding MockResultSet

parameters - the parameters

prepareResultSets

public void prepareResultSets(String sql,
                              MockResultSet[] resultSets,
                              MockParameterMap parameters)

Prepare an array of ResultSet objects for a specified SQL string and the specified parameters. This method can be used for queries that return multiple result sets. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareResultSets in class AbstractResultSetHandler

Parameters:

sql - the SQL string

resultSets - the corresponding MockResultSet[]

parameters - the parameters

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql)

Prepare that the specified SQL string with empty parameters should raise an exception. This can be used to simulate database exceptions. This method creates an SQLException and will throw this exception.

Overrides:

prepareThrowsSQLException in class AbstractResultSetHandler

Parameters:

sql - the SQL string

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      Object[] parameters)

Prepare that the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. This method creates an SQLException and will throw this exception. With prepareThrowsSQLException(String, SQLException, Object[]) you can specify the exception. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      List<Object> parameters)

Prepare that the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. This method creates an SQLException and will throw this exception. With prepareThrowsSQLException(String, SQLException, List) you can specify the exception. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      MockParameterMap parameters)

Prepare that the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. This method creates an SQLException and will throw this exception. With you can specify the exception. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareThrowsSQLException in class AbstractResultSetHandler

Parameters:

sql - the SQL string

parameters - the parameters

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      SQLException exc)

Prepare that the specified SQL string with empty parameters should raise an exception. This can be used to simulate database exceptions. This method creates an SQLException and will throw this exception.

Overrides:

prepareThrowsSQLException in class AbstractResultSetHandler

Parameters:

sql - the SQL string

exc - the SQLException that should be thrown

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      SQLException exc,
                                      Object[] parameters)

Prepare that the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. This method takes an exception object that will be thrown. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

exc - the SQLException that should be thrown

parameters - the parameters

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      SQLException exc,
                                      List<Object> parameters)

Prepare that the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. This method takes an exception object that will be thrown. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

exc - the SQLException that should be thrown

parameters - the parameters

prepareThrowsSQLException

public void prepareThrowsSQLException(String sql,
                                      SQLException exc,
                                      MockParameterMap parameters)

Prepare that the specified SQL string with the specified parameters should raise an exception. This can be used to simulate database exceptions. This method takes an exception object that will be thrown. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareThrowsSQLException in class AbstractResultSetHandler

Parameters:

sql - the SQL string

exc - the SQLException that should be thrown

parameters - the parameters

prepareUpdateCount

public void prepareUpdateCount(String sql,
                               int updateCount)

Prepare the update count for execute update calls for a specified SQL string with an empty parameter map.

Overrides:

prepareUpdateCount in class AbstractResultSetHandler

Parameters:

sql - the SQL string

updateCount - the update count

prepareUpdateCounts

public void prepareUpdateCounts(String sql,
                                Integer[] updateCounts)

Prepare the update counts for execute update calls for a specified SQL string with an empty parameter map.

Overrides:

prepareUpdateCounts in class AbstractResultSetHandler

Parameters:

sql - the SQL string

updateCounts - the update counts

prepareUpdateCount

public void prepareUpdateCount(String sql,
                               int updateCount,
                               Object[] parameters)

Prepare the update count for execute update calls for a specified SQL string and the specified parameters. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

updateCount - the update count

parameters - the parameters

prepareUpdateCounts

public void prepareUpdateCounts(String sql,
                                Integer[] updateCounts,
                                Object[] parameters)

Prepare an array update count values for execute update calls for a specified SQL string and the specified parameters. This method can be used if multiple update counts are returned. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

updateCounts - the update count array

parameters - the parameters

prepareUpdateCount

public void prepareUpdateCount(String sql,
                               int updateCount,
                               List<Object> parameters)

Prepare the update count for execute update calls for a specified SQL string and the specified parameters. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

updateCount - the update count

parameters - the parameters

prepareUpdateCounts

public void prepareUpdateCounts(String sql,
                                Integer[] updateCounts,
                                List<Object> parameters)

Prepare an array update count values for execute update calls for a specified SQL string and the specified parameters. This method can be used if multiple update counts are returned. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

updateCounts - the update count array

parameters - the parameters

prepareUpdateCount

public void prepareUpdateCount(String sql,
                               int updateCount,
                               MockParameterMap parameters)

Prepare the update count for execute update calls for a specified SQL string and the specified parameters. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareUpdateCount in class AbstractResultSetHandler

Parameters:

sql - the SQL string

updateCount - the update count

parameters - the parameters

prepareUpdateCounts

public void prepareUpdateCounts(String sql,
                                Integer[] updateCounts,
                                MockParameterMap parameters)

Prepare an array update count values for execute update calls for a specified SQL string and the specified parameters. This method can be used if multiple update counts are returned. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareUpdateCounts in class AbstractResultSetHandler

Parameters:

sql - the SQL string

updateCounts - the update count array

parameters - the parameters

prepareGeneratedKeys

public void prepareGeneratedKeys(String sql,
                                 MockResultSet generatedKeysResult)

Prepare the generated keys ResultSet for a specified SQL string with an empty parameter map.

Overrides:

prepareGeneratedKeys in class AbstractResultSetHandler

Parameters:

sql - the SQL string

generatedKeysResult - the generated keys MockResultSet

prepareGeneratedKeys

public void prepareGeneratedKeys(String sql,
                                 MockResultSet generatedKeysResult,
                                 Object[] parameters)

Prepare the generated keys ResultSet for a specified SQL string. The specified parameters array must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters[0] maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

generatedKeysResult - the generated keys MockResultSet

parameters - the parameters

prepareGeneratedKeys

public void prepareGeneratedKeys(String sql,
                                 MockResultSet generatedKeysResult,
                                 List<Object> parameters)

Prepare the generated keys ResultSet for a specified SQL string. The specified parameters List must contain the parameters in the correct order starting with index 0 for the first parameter. Please keep in mind that parameters in PreparedStatement objects start with 1 as the first parameter. So parameters.get(0) maps to the parameter with index 1. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

generatedKeysResult - the generated keys MockResultSet

parameters - the parameters

prepareGeneratedKeys

public void prepareGeneratedKeys(String sql,
                                 MockResultSet generatedKeysResult,
                                 MockParameterMap parameters)

Prepare the generated keys ResultSet for a specified SQL string. The specified parameters Map must contain the parameters by mapping Integer objects to the corresponding parameter. The Integer object is the index of the parameter. In the case of a CallableStatement, String keys for named parameters are also allowed. Please note that you can modify the match parameters with AbstractResultSetHandler.setCaseSensitive(boolean), AbstractResultSetHandler.setExactMatch(boolean) and AbstractResultSetHandler.setUseRegularExpressions(boolean) and the match parameters for the specified parameter list with setExactMatchParameter(boolean).

Overrides:

prepareGeneratedKeys in class AbstractResultSetHandler

Parameters:

sql - the SQL string

generatedKeysResult - the generated keys MockResultSet

parameters - the parameters

removeResultSet

public void removeResultSet(String sql,
                            MockParameterMap parameters)

Given a SQL string, remove the associated entry from the resultSetsForStatement TreeMap

Parameters:

sql - The SQL string associated with the resultset

parameters -

removeThrowsSqlException

public void removeThrowsSqlException(String sql,
                                     MockParameterMap parameters)

Remove the throws mock for the specified SQL string.

Parameters:

sql - The SQL string which identifies the conditions under which to throw a SQLException

parameters -

removeUpdateCount

public void removeUpdateCount(String sql,
                              MockParameterMap parameters)

Remove the update count mock for the specified SQL string.

Parameters:

sql - The SQL string which identifies the conditions under which to return the specified update count

parameters -

removeGeneratedKeys

public void removeGeneratedKeys(String sql,
                                MockParameterMap parameters)

Remove the generated keys mock for the specified SQL string.

Parameters:

sql - The SQL string which identifies the conditions under which the generated keys result would be returned.

parameters -