com.mockrunner.jdbc

Class AbstractOutParameterResultSetHandler

java.lang.Object

com.mockrunner.jdbc.AbstractResultSetHandler

com.mockrunner.jdbc.AbstractParameterResultSetHandler

com.mockrunner.jdbc.AbstractOutParameterResultSetHandler

Direct Known Subclasses:

CallableStatementResultSetHandler

public abstract class AbstractOutParameterResultSetHandler
extends AbstractParameterResultSetHandler

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

Field Summary

Fields inherited from class com.mockrunner.jdbc.AbstractParameterResultSetHandler

exactMatchParameter

Constructor Summary

Constructors

Constructor and Description
AbstractOutParameterResultSetHandler()

Method Summary

Modifier and Type	Method and Description
void	clearOutParameter() Clears the out parameters.
MockParameterMap	getGlobalOutParameter() Returns the global out parameter Map.
boolean	getMustRegisterOutParameters() Get if out parameter must be registered to be returned.
MockParameterMap	getOutParameter(String sql) Returns the first out parameter Map that matches the specified SQL string.
MockParameterMap	getOutParameter(String sql, MockParameterMap parameters) Returns the first out parameter Map that matches the specified SQL string and the specified parameters.
protected void	onPatternMatcherFactoryChanged()
void	prepareGlobalOutParameter(MockParameterMap outParameters) Prepares the global out parameter Map.
void	prepareOutParameter(String sql, MockParameterMap outParameters) Prepare an out parameter Map for a specified SQL string.
void	prepareOutParameter(String sql, MockParameterMap outParameters, List<Object> parameters) Prepare an out parameter Map for a specified SQL string and the specified parameters.
void	prepareOutParameter(String sql, MockParameterMap outParameters, MockParameterMap parameters) Prepare an out parameter Map for a specified SQL string and the specified parameters.
void	prepareOutParameter(String sql, MockParameterMap outParameters, Object[] parameters) Prepare an out parameter Map for a specified SQL string and the specified parameters.
void	removeOutParameter(String sql)
void	removeOutParameter(String sql, MockParameterMap parameters)
void	setMustRegisterOutParameters(boolean mustOutParameterBeRegistered) Set if out parameters must be registered to be returned.

Methods inherited from class com.mockrunner.jdbc.AbstractParameterResultSetHandler

addParameterMapForExecutedStatement, getExecutedStatementParameter, getExecutedStatementParameterMap, getGeneratedKeys, getParametersForExecutedStatement, getResultSet, getResultSets, getSQLException, getThrowsSQLException, getUpdateCount, getUpdateCounts, hasMultipleResultSets, hasMultipleUpdateCounts, prepareGeneratedKeys, prepareGeneratedKeys, prepareGeneratedKeys, prepareGeneratedKeys, prepareResultSet, prepareResultSet, prepareResultSet, prepareResultSet, prepareResultSets, prepareResultSets, prepareResultSets, prepareResultSets, prepareThrowsSQLException, prepareThrowsSQLException, prepareThrowsSQLException, prepareThrowsSQLException, prepareThrowsSQLException, prepareThrowsSQLException, prepareThrowsSQLException, prepareThrowsSQLException, prepareUpdateCount, prepareUpdateCount, prepareUpdateCount, prepareUpdateCount, prepareUpdateCounts, prepareUpdateCounts, prepareUpdateCounts, prepareUpdateCounts, removeGeneratedKeys, removeResultSet, removeThrowsSqlException, removeUpdateCount, setExactMatchParameter

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, 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

Constructor Detail

AbstractOutParameterResultSetHandler

public AbstractOutParameterResultSetHandler()

Method Detail

onPatternMatcherFactoryChanged

protected void onPatternMatcherFactoryChanged()

Overrides:

onPatternMatcherFactoryChanged in class AbstractResultSetHandler

setMustRegisterOutParameters

public void setMustRegisterOutParameters(boolean mustOutParameterBeRegistered)

Set if out parameters must be registered to be returned. The default is false, i.e. if there are matching out parameters prepared, they are returned even if the registerOutParameter methods of CallableStatement have not been called. If set to true, registerOutParameter must be called.

Parameters:

mustOutParameterBeRegistered - must out parameter be registered

getMustRegisterOutParameters

public boolean getMustRegisterOutParameters()

Get if out parameter must be registered to be returned.

Returns:

must out parameter be registered

getOutParameter

public MockParameterMap getOutParameter(String sql)

Returns the first out parameter Map 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).

Parameters:

sql - the SQL string

Returns:

the corresponding out parameter Map

getOutParameter

public MockParameterMap getOutParameter(String sql,
                                        MockParameterMap parameters)

Returns the first out parameter Map that matches the specified SQL string and the specified parameters. 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 AbstractParameterResultSetHandler.setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

parameters - the parameters

Returns:

the corresponding out parameter Map

clearOutParameter

public void clearOutParameter()

Clears the out parameters.

getGlobalOutParameter

public MockParameterMap getGlobalOutParameter()

Returns the global out parameter Map.

Returns:

the global out parameter Map

prepareGlobalOutParameter

public void prepareGlobalOutParameter(MockParameterMap outParameters)

Prepares the global out parameter Map.

Parameters:

outParameters - the global out parameter Map

prepareOutParameter

public void prepareOutParameter(String sql,
                                MockParameterMap outParameters)

Prepare an out parameter Map for a specified SQL string. 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

outParameters - the out parameter Map

prepareOutParameter

public void prepareOutParameter(String sql,
                                MockParameterMap outParameters,
                                Object[] parameters)

Prepare an out parameter Map 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 CallableStatement 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 AbstractParameterResultSetHandler.setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

outParameters - the corresponding out parameter Map

parameters - the parameters

prepareOutParameter

public void prepareOutParameter(String sql,
                                MockParameterMap outParameters,
                                List<Object> parameters)

Prepare an out parameter Map 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 CallableStatement 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 AbstractParameterResultSetHandler.setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

outParameters - the corresponding out parameter Map

parameters - the parameters

prepareOutParameter

public void prepareOutParameter(String sql,
                                MockParameterMap outParameters,
                                MockParameterMap parameters)

Prepare an out parameter Map for a specified SQL string and the specified parameters. The specified parameters Map must contain the parameters by mapping Integer or String objects to the corresponding parameter. An Integer object is the index of the parameter. A String is the name of the parameter. 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 AbstractParameterResultSetHandler.setExactMatchParameter(boolean).

Parameters:

sql - the SQL string

outParameters - the corresponding out parameter Map

parameters - the parameters

removeOutParameter

public void removeOutParameter(String sql)

removeOutParameter

public void removeOutParameter(String sql,
                               MockParameterMap parameters)