Package org.firebirdsql.jdbc

Class AbstractCallableStatement

java.lang.Object

org.firebirdsql.jdbc.FBStatement

org.firebirdsql.jdbc.AbstractPreparedStatement

org.firebirdsql.jdbc.FBPreparedStatement

org.firebirdsql.jdbc.AbstractCallableStatement

All Implemented Interfaces:

AutoCloseable, CallableStatement, PreparedStatement, Statement, Wrapper, FirebirdCallableStatement, FirebirdPreparedStatement, FirebirdStatement, Synchronizable

Direct Known Subclasses:

FBCallableStatement

public abstract class AbstractCallableStatement
extends FBPreparedStatement
implements CallableStatement, FirebirdCallableStatement

Abstract implementation of CallableStatement.

Author:

David Jencks, Roman Rokytskyy, Steven Jardine, Mark Rotteveel

Nested Class Summary

Nested classes/interfaces inherited from class org.firebirdsql.jdbc.FBStatement

FBStatement.StatementResult

Field Summary

Fields

Modifier and Type	Field	Description
protected FBProcedureCall	procedureCall
protected boolean	selectableProcedure

Fields inherited from class org.firebirdsql.jdbc.AbstractPreparedStatement

batchList, METHOD_NOT_SUPPORTED

Fields inherited from class org.firebirdsql.jdbc.FBStatement

completed, connection, currentStatementResult, fbStatement, fetchSize, firstWarning, gdsHelper, isSingletonResult, jdbcVersionSupport, maxRows, specialResult, statementListener

Fields inherited from interface org.firebirdsql.jdbc.FirebirdPreparedStatement

TYPE_COMMIT, TYPE_DDL, TYPE_DELETE, TYPE_EXEC_PROCEDURE, TYPE_GET_SEGMENT, TYPE_INSERT, TYPE_PUT_SEGMENT, TYPE_ROLLBACK, TYPE_SELECT, TYPE_SELECT_FOR_UPDATE, TYPE_SET_GENERATOR, TYPE_START_TRANS, TYPE_UPDATE

Fields inherited from interface java.sql.Statement

CLOSE_ALL_RESULTS, CLOSE_CURRENT_RESULT, EXECUTE_FAILED, KEEP_CURRENT_RESULT, NO_GENERATED_KEYS, RETURN_GENERATED_KEYS, SUCCESS_NO_INFO

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractCallableStatement(GDSHelper c, String sql, int rsType, int rsConcurrency, int rsHoldability, StoredProcedureMetaData storedProcMetaData, FBObjectListener.StatementListener statementListener, FBObjectListener.BlobListener blobListener)

Method Summary

Modifier and Type	Method	Description
void	addBatch()
protected void	assertHasData(ResultSet rs)	Asserts if the current statement has data to return.
boolean	execute()
protected List<Long>	executeBatchInternal()
ResultSet	executeQuery()
int	executeUpdate()
protected int	findOutParameter(String paramName)	Helper method to identify the right result set column for the give OUT parameter name.
protected ResultSet	getAndAssertSingletonResultSet()	Returns the result set for the singleton row of the callable statement and asserts it has data.
Array	getArray(int parameterIndex)
Array	getArray(String colName)
BigDecimal	getBigDecimal(int parameterIndex)
BigDecimal	getBigDecimal(int parameterIndex, int scale)	Deprecated.
BigDecimal	getBigDecimal(String colName)
Blob	getBlob(int parameterIndex)
Blob	getBlob(String colName)
boolean	getBoolean(int parameterIndex)
boolean	getBoolean(String colName)
byte	getByte(int parameterIndex)
byte	getByte(String colName)
byte[]	getBytes(int parameterIndex)
byte[]	getBytes(String colName)
Reader	getCharacterStream(int parameterIndex)
Reader	getCharacterStream(String parameterName)
Clob	getClob(int parameterIndex)
Clob	getClob(String colName)
ResultSet	getCurrentResultSet()	Get current result set.
Date	getDate(int parameterIndex)
Date	getDate(int parameterIndex, Calendar cal)
Date	getDate(String colName)
Date	getDate(String colName, Calendar cal)
double	getDouble(int parameterIndex)
double	getDouble(String colName)
float	getFloat(int parameterIndex)
float	getFloat(String colName)
ResultSet	getGeneratedKeys()
int	getInt(int parameterIndex)
int	getInt(String colName)
long	getLong(int parameterIndex)
long	getLong(String colName)
ResultSetMetaData	getMetaData()
Reader	getNCharacterStream(int parameterIndex)
Reader	getNCharacterStream(String parameterName)
NClob	getNClob(int parameterIndex)
NClob	getNClob(String parameterName)
String	getNString(int parameterIndex)
String	getNString(String parameterName)
Object	getObject(int parameterIndex)
<T> T	getObject(int parameterIndex, Class<T> type)
Object	getObject(int parameterIndex, Map<String,Class<?>> map)
Object	getObject(String colName)
<T> T	getObject(String parameterName, Class<T> type)
Object	getObject(String colName, Map<String,Class<?>> map)
ParameterMetaData	getParameterMetaData()
Ref	getRef(int parameterIndex)
Ref	getRef(String colName)
ResultSet	getResultSet()
RowId	getRowId(int parameterIndex)
RowId	getRowId(String parameterName)
short	getShort(int parameterIndex)
short	getShort(String colName)
SQLXML	getSQLXML(int parameterIndex)
SQLXML	getSQLXML(String parameterName)
String	getString(int parameterIndex)
String	getString(String colName)
Time	getTime(int parameterIndex)
Time	getTime(int parameterIndex, Calendar cal)
Time	getTime(String colName)
Time	getTime(String colName, Calendar cal)
Timestamp	getTimestamp(int parameterIndex)
Timestamp	getTimestamp(int parameterIndex, Calendar cal)
Timestamp	getTimestamp(String colName)
Timestamp	getTimestamp(String colName, Calendar cal)
URL	getURL(int parameterIndex)
URL	getURL(String colName)
protected boolean	internalExecute(boolean sendOutParams)	Execute this statement.
boolean	isSelectableProcedure()	Retrieve if this callable statement has been marked as selectable.
protected void	prepareFixedStatement(String sql)	We allow multiple calls to this method without re-preparing the statement.
void	registerOutParameter(int parameterIndex, int sqlType)
void	registerOutParameter(int parameterIndex, int sqlType, int scale)
void	registerOutParameter(int parameterIndex, int sqlType, String typeName)
void	registerOutParameter(String param1, int param2)
void	registerOutParameter(String param1, int param2, int param3)
void	registerOutParameter(String param1, int param2, String param3)
void	setAsciiStream(String parameterName, InputStream x)
void	setAsciiStream(String param1, InputStream param2, int param3)
void	setAsciiStream(String parameterName, InputStream x, long length)
void	setBigDecimal(int parameterIndex, BigDecimal x)
void	setBigDecimal(String param1, BigDecimal param2)
void	setBinaryStream(int parameterIndex, InputStream inputStream)
void	setBinaryStream(int parameterIndex, InputStream inputStream, int length)
void	setBinaryStream(int parameterIndex, InputStream inputStream, long length)
void	setBinaryStream(String parameterName, InputStream x)
void	setBinaryStream(String param1, InputStream param2, int param3)
void	setBinaryStream(String parameterName, InputStream x, long length)
void	setBlob(int parameterIndex, InputStream inputStream)
void	setBlob(int parameterIndex, InputStream inputStream, long length)
void	setBlob(int parameterIndex, Blob blob)
void	setBlob(String parameterName, InputStream inputStream)
void	setBlob(String parameterName, InputStream inputStream, long length)
void	setBlob(String parameterName, Blob x)
void	setBoolean(int parameterIndex, boolean x)
void	setBoolean(String param1, boolean param2)
void	setByte(int parameterIndex, byte x)
void	setByte(String param1, byte param2)
void	setBytes(int parameterIndex, byte[] x)
void	setBytes(String param1, byte[] param2)
void	setCharacterStream(int parameterIndex, Reader reader)
void	setCharacterStream(int parameterIndex, Reader reader, int length)
void	setCharacterStream(int parameterIndex, Reader reader, long length)
void	setCharacterStream(String parameterName, Reader reader)
void	setCharacterStream(String param1, Reader param2, int param3)
void	setCharacterStream(String parameterName, Reader reader, long length)
void	setClob(int parameterIndex, Reader reader)
void	setClob(int parameterIndex, Reader reader, long length)
void	setClob(int parameterIndex, Clob x)
void	setClob(String parameterName, Reader reader)
void	setClob(String parameterName, Reader reader, long length)
void	setClob(String parameterName, Clob x)
void	setDate(int parameterIndex, Date x)
void	setDate(int parameterIndex, Date x, Calendar cal)
void	setDate(String param1, Date param2)
void	setDate(String param1, Date param2, Calendar param3)
void	setDouble(int parameterIndex, double x)
void	setDouble(String param1, double param2)
void	setFloat(int parameterIndex, float x)
void	setFloat(String param1, float param2)
void	setInt(int parameterIndex, int x)
void	setInt(String param1, int param2)
void	setLong(int parameterIndex, long x)
void	setLong(String param1, long param2)
void	setNCharacterStream(String parameterName, Reader value)
void	setNCharacterStream(String parameterName, Reader value, long length)
void	setNClob(String parameterName, Reader reader)
void	setNClob(String parameterName, Reader reader, long length)
void	setNClob(String parameterName, NClob value)
void	setNString(String parameterName, String value)
void	setNull(int parameterIndex, int sqlType)
void	setNull(int parameterIndex, int sqlType, String typeName)
void	setNull(String param1, int param2)
void	setNull(String param1, int param2, String param3)
void	setObject(int parameterIndex, Object x)
void	setObject(int parameterIndex, Object x, int targetSqlType)
void	setObject(int parameterIndex, Object x, int targetSqlType, int scale)
void	setObject(String param1, Object param2)
void	setObject(String param1, Object param2, int param3)
void	setObject(String param1, Object param2, int param3, int param4)
protected void	setRequiredTypes()	Set required types for output parameters.
void	setRowId(String parameterName, RowId x)
void	setSelectableProcedure(boolean selectableProcedure)	Mark this callable statement as a call of the selectable procedure.
void	setShort(int parameterIndex, short x)
void	setShort(String param1, short param2)
void	setSQLXML(String parameterName, SQLXML xmlObject)
void	setString(int parameterIndex, String x)
void	setString(String param1, String param2)
void	setTime(int parameterIndex, Time x)
void	setTime(int parameterIndex, Time x, Calendar cal)
void	setTime(String param1, Time param2)
void	setTime(String param1, Time param2, Calendar param3)
void	setTimestamp(int parameterIndex, Timestamp x)
void	setTimestamp(int parameterIndex, Timestamp x, Calendar cal)
void	setTimestamp(String param1, Timestamp param2)
void	setTimestamp(String param1, Timestamp param2, Calendar param3)
void	setURL(String param1, URL param2)
boolean	wasNull()

Methods inherited from class org.firebirdsql.jdbc.FBPreparedStatement

setObject, setObject

Methods inherited from class org.firebirdsql.jdbc.AbstractPreparedStatement

addBatch, clearBatch, clearParameters, completeStatement, execute, execute, execute, execute, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getExecutionPlan, getExplainedExecutionPlan, getField, getFirebirdParameterMetaData, getParameterDescriptor, getStatementType, isGeneratedKeyQuery, notifyStatementCompleted, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setRef, setRowId, setSQLXML, setStringForced, setUnicodeStream, setURL

Methods inherited from class org.firebirdsql.jdbc.FBStatement

addWarning, cancel, checkValidity, clearWarnings, close, closeOnCompletion, completeStatement, createStatementListener, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, equals, executeBatch, executeImpl, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, finalize, forgetResultSet, getConnection, getDeletedRowsCount, getFetchDirection, getFetchSize, getInsertedRowsCount, getLargeMaxRows, getLargeUpdateCount, getLastExecutionPlan, getLastExplainedExecutionPlan, getLocalStatementId, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getSynchronizationObject, getUpdateCount, getUpdatedRowsCount, getWarnings, hashCode, hasOpenResultSet, internalExecute, isClosed, isCloseOnCompletion, isExecuteProcedureStatement, isPoolable, isSimpleIdentifier, isValid, isWrapperFor, nativeSQL, notifyStatementCompleted, notifyStatementStarted, notifyStatementStarted, requireStatement, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout, toArray, toLargeArray, unwrap

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.sql.CallableStatement

registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, setObject, setObject

Methods inherited from interface org.firebirdsql.jdbc.FirebirdPreparedStatement

getExecutionPlan, getExplainedExecutionPlan, getStatementType

Methods inherited from interface org.firebirdsql.jdbc.FirebirdStatement

getDeletedRowsCount, getInsertedRowsCount, getLastExecutionPlan, getLastExplainedExecutionPlan, getLocalStatementId, getUpdatedRowsCount, hasOpenResultSet, isValid

Methods inherited from interface java.sql.PreparedStatement

clearParameters, executeLargeUpdate, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setObject, setObject, setRef, setRowId, setSQLXML, setUnicodeStream, setURL

Methods inherited from interface java.sql.Statement

addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, enquoteIdentifier, enquoteLiteral, enquoteNCharLiteral, execute, execute, execute, execute, executeBatch, executeLargeBatch, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeLargeUpdate, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, getConnection, getFetchDirection, getFetchSize, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getWarnings, isClosed, isCloseOnCompletion, isPoolable, isSimpleIdentifier, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Field Details

selectableProcedure

protected boolean selectableProcedure

procedureCall

protected FBProcedureCall procedureCall

Constructor Details

AbstractCallableStatement

protected AbstractCallableStatement(GDSHelper c,
 String sql,
 int rsType,
 int rsConcurrency,
 int rsHoldability,
 StoredProcedureMetaData storedProcMetaData,
 FBObjectListener.StatementListener statementListener,
 FBObjectListener.BlobListener blobListener)
                             throws SQLException

Throws:

SQLException

Method Details

getParameterMetaData

public ParameterMetaData getParameterMetaData()
                                       throws SQLException

Specified by:

getParameterMetaData in interface PreparedStatement

Overrides:

getParameterMetaData in class AbstractPreparedStatement

Throws:

SQLException

addBatch

public void addBatch()
              throws SQLException

Specified by:

addBatch in interface PreparedStatement

Overrides:

addBatch in class AbstractPreparedStatement

Throws:

SQLException

executeBatchInternal

protected List<Long> executeBatchInternal()
                                   throws SQLException

Overrides:

executeBatchInternal in class AbstractPreparedStatement

Throws:

SQLException

setSelectableProcedure

public void setSelectableProcedure(boolean selectableProcedure)

Description copied from interface: FirebirdCallableStatement

Mark this callable statement as a call of the selectable procedure. By default callable statement uses "EXECUTE PROCEDURE" SQL statement to invoke stored procedures that return single row of output parameters or a result set. In former case it retrieves only the first row of the result set.

Specified by:

setSelectableProcedure in interface FirebirdCallableStatement

Parameters:

selectableProcedure - true if the called procedure is selectable.

See Also:

• FirebirdCallableStatement.isSelectableProcedure()

isSelectableProcedure

public boolean isSelectableProcedure()

Description copied from interface: FirebirdCallableStatement

Retrieve if this callable statement has been marked as selectable. Starting from Firebird 2.1, this value is set automatically from metadata stored in the database. Prior to Firebird 2.1, it must be set manually.

Specified by:

isSelectableProcedure in interface FirebirdCallableStatement

Returns:

true if the called procedure is selectable, false otherwise

See Also:

• FirebirdCallableStatement.setSelectableProcedure(boolean)

setRequiredTypes

protected void setRequiredTypes()
                         throws SQLException

Set required types for output parameters.

Throws:

SQLException - if something went wrong.

prepareFixedStatement

protected void prepareFixedStatement(String sql)
                              throws SQLException

We allow multiple calls to this method without re-preparing the statement. This is an workaround to the issue that the statement is actually prepared only after all OUT parameters are registered.

Overrides:

prepareFixedStatement in class AbstractPreparedStatement

Throws:

SQLException

getMetaData

public ResultSetMetaData getMetaData()
                              throws SQLException

Since we deferred the statement preparation until all OUT params are registered, we ensure that the statement is prepared before the meta data for the callable statement is obtained.

Specified by:

getMetaData in interface PreparedStatement

Overrides:

getMetaData in class AbstractPreparedStatement

Throws:

SQLException

execute

public boolean execute()
                throws SQLException

Specified by:

execute in interface PreparedStatement

Overrides:

execute in class AbstractPreparedStatement

Throws:

SQLException

executeQuery

public ResultSet executeQuery()
                       throws SQLException

Specified by:

executeQuery in interface PreparedStatement

Overrides:

executeQuery in class AbstractPreparedStatement

Throws:

SQLException

executeUpdate

public int executeUpdate()
                  throws SQLException

Specified by:

executeUpdate in interface PreparedStatement

Overrides:

executeUpdate in class AbstractPreparedStatement

Throws:

SQLException

internalExecute

protected boolean internalExecute(boolean sendOutParams)
                           throws SQLException

Description copied from class: AbstractPreparedStatement

Execute this statement. Method checks whether all parameters are set, flushes all "flushable" fields that might contain cached data and executes the statement.

Overrides:

internalExecute in class AbstractPreparedStatement

Parameters:

sendOutParams - Determines if the XSQLDA structure should be sent to the database

Returns:

true if the statement has more result sets.

Throws:

SQLException

registerOutParameter

public void registerOutParameter(int parameterIndex,
 int sqlType)
                          throws SQLException

Specified by:

registerOutParameter in interface CallableStatement

Throws:

SQLException

registerOutParameter

public void registerOutParameter(int parameterIndex,
 int sqlType,
 int scale)
                          throws SQLException

Implementation note: This method will behave the same as calling registerOutParameter(int, int).

Specified by:

registerOutParameter in interface CallableStatement

Throws:

SQLException

wasNull

public boolean wasNull()
                throws SQLException

Specified by:

wasNull in interface CallableStatement

Throws:

SQLException

getString

public String getString(int parameterIndex)
                 throws SQLException

Specified by:

getString in interface CallableStatement

Throws:

SQLException

getBoolean

public boolean getBoolean(int parameterIndex)
                   throws SQLException

Specified by:

getBoolean in interface CallableStatement

Throws:

SQLException

getByte

public byte getByte(int parameterIndex)
             throws SQLException

Specified by:

getByte in interface CallableStatement

Throws:

SQLException

getShort

public short getShort(int parameterIndex)
               throws SQLException

Specified by:

getShort in interface CallableStatement

Throws:

SQLException

getInt

public int getInt(int parameterIndex)
           throws SQLException

Specified by:

getInt in interface CallableStatement

Throws:

SQLException

getLong

public long getLong(int parameterIndex)
             throws SQLException

Specified by:

getLong in interface CallableStatement

Throws:

SQLException

getFloat

public float getFloat(int parameterIndex)
               throws SQLException

Specified by:

getFloat in interface CallableStatement

Throws:

SQLException

getDouble

public double getDouble(int parameterIndex)
                 throws SQLException

Specified by:

getDouble in interface CallableStatement

Throws:

SQLException

getBigDecimal

@Deprecated
public BigDecimal getBigDecimal(int parameterIndex,
 int scale)
                         throws SQLException

Deprecated.

Specified by:

getBigDecimal in interface CallableStatement

Throws:

SQLException

getBytes

public byte[] getBytes(int parameterIndex)
                throws SQLException

Specified by:

getBytes in interface CallableStatement

Throws:

SQLException

getDate

public Date getDate(int parameterIndex)
             throws SQLException

Specified by:

getDate in interface CallableStatement

Throws:

SQLException

getTime

public Time getTime(int parameterIndex)
             throws SQLException

Specified by:

getTime in interface CallableStatement

Throws:

SQLException

getTimestamp

public Timestamp getTimestamp(int parameterIndex)
                       throws SQLException

Specified by:

getTimestamp in interface CallableStatement

Throws:

SQLException

getObject

public Object getObject(int parameterIndex)
                 throws SQLException

Implementation note: the registered type is ignored, and the type derived from the actual datatype will be used.

Specified by:

getObject in interface CallableStatement

Throws:

SQLException

getObject

public Object getObject(String colName)
                 throws SQLException

Implementation note: the registered type is ignored, and the type derived from the actual datatype will be used.

Specified by:

getObject in interface CallableStatement

Throws:

SQLException

getObject

public Object getObject(int parameterIndex,
 Map<String,Class<?>> map)
                 throws SQLException

Implementation note: the registered type is ignored, and the type derived from the actual datatype will be used.

Specified by:

getObject in interface CallableStatement

Throws:

SQLException

getObject

public Object getObject(String colName,
 Map<String,Class<?>> map)
                 throws SQLException

Implementation note: the registered type is ignored, and the type derived from the actual datatype will be used.

Specified by:

getObject in interface CallableStatement

Throws:

SQLException

getObject

public <T> T getObject(int parameterIndex,
 Class<T> type)
                throws SQLException

Specified by:

getObject in interface CallableStatement

Throws:

SQLException

getObject

public <T> T getObject(String parameterName,
 Class<T> type)
                throws SQLException

Specified by:

getObject in interface CallableStatement

Throws:

SQLException

getBigDecimal

public BigDecimal getBigDecimal(int parameterIndex)
                         throws SQLException

Specified by:

getBigDecimal in interface CallableStatement

Throws:

SQLException

getRef

public Ref getRef(int parameterIndex)
           throws SQLException

Specified by:

getRef in interface CallableStatement

Throws:

SQLException

getBlob

public Blob getBlob(int parameterIndex)
             throws SQLException

Specified by:

getBlob in interface CallableStatement

Throws:

SQLException

getClob

public Clob getClob(int parameterIndex)
             throws SQLException

Specified by:

getClob in interface CallableStatement

Throws:

SQLException

getArray

public Array getArray(int parameterIndex)
               throws SQLException

Specified by:

getArray in interface CallableStatement

Throws:

SQLException

getDate

public Date getDate(int parameterIndex,
 Calendar cal)
             throws SQLException

Specified by:

getDate in interface CallableStatement

Throws:

SQLException

getTime

public Time getTime(int parameterIndex,
 Calendar cal)
             throws SQLException

Specified by:

getTime in interface CallableStatement

Throws:

SQLException

getTimestamp

public Timestamp getTimestamp(int parameterIndex,
 Calendar cal)
                       throws SQLException

Specified by:

getTimestamp in interface CallableStatement

Throws:

SQLException

getURL

public URL getURL(int parameterIndex)
           throws SQLException

Specified by:

getURL in interface CallableStatement

Throws:

SQLException

getString

public String getString(String colName)
                 throws SQLException

Specified by:

getString in interface CallableStatement

Throws:

SQLException

getBoolean

public boolean getBoolean(String colName)
                   throws SQLException

Specified by:

getBoolean in interface CallableStatement

Throws:

SQLException

getByte

public byte getByte(String colName)
             throws SQLException

Specified by:

getByte in interface CallableStatement

Throws:

SQLException

getShort

public short getShort(String colName)
               throws SQLException

Specified by:

getShort in interface CallableStatement

Throws:

SQLException

getInt

public int getInt(String colName)
           throws SQLException

Specified by:

getInt in interface CallableStatement

Throws:

SQLException

getLong

public long getLong(String colName)
             throws SQLException

Specified by:

getLong in interface CallableStatement

Throws:

SQLException

getFloat

public float getFloat(String colName)
               throws SQLException

Specified by:

getFloat in interface CallableStatement

Throws:

SQLException

getDouble

public double getDouble(String colName)
                 throws SQLException

Specified by:

getDouble in interface CallableStatement

Throws:

SQLException

getBytes

public byte[] getBytes(String colName)
                throws SQLException

Specified by:

getBytes in interface CallableStatement

Throws:

SQLException

getDate

public Date getDate(String colName)
             throws SQLException

Specified by:

getDate in interface CallableStatement

Throws:

SQLException

getTime

public Time getTime(String colName)
             throws SQLException

Specified by:

getTime in interface CallableStatement

Throws:

SQLException

getTimestamp

public Timestamp getTimestamp(String colName)
                       throws SQLException

Specified by:

getTimestamp in interface CallableStatement

Throws:

SQLException

getBigDecimal

public BigDecimal getBigDecimal(String colName)
                         throws SQLException

Specified by:

getBigDecimal in interface CallableStatement

Throws:

SQLException

getRef

public Ref getRef(String colName)
           throws SQLException

Specified by:

getRef in interface CallableStatement

Throws:

SQLException

getBlob

public Blob getBlob(String colName)
             throws SQLException

Specified by:

getBlob in interface CallableStatement

Throws:

SQLException

getClob

public Clob getClob(String colName)
             throws SQLException

Specified by:

getClob in interface CallableStatement

Throws:

SQLException

getArray

public Array getArray(String colName)
               throws SQLException

Specified by:

getArray in interface CallableStatement

Throws:

SQLException

getDate

public Date getDate(String colName,
 Calendar cal)
             throws SQLException

Specified by:

getDate in interface CallableStatement

Throws:

SQLException

getTime

public Time getTime(String colName,
 Calendar cal)
             throws SQLException

Specified by:

getTime in interface CallableStatement

Throws:

SQLException

getTimestamp

public Timestamp getTimestamp(String colName,
 Calendar cal)
                       throws SQLException

Specified by:

getTimestamp in interface CallableStatement

Throws:

SQLException

getURL

public URL getURL(String colName)
           throws SQLException

Specified by:

getURL in interface CallableStatement

Throws:

SQLException

getCharacterStream

public Reader getCharacterStream(int parameterIndex)
                          throws SQLException

Specified by:

getCharacterStream in interface CallableStatement

Throws:

SQLException

getCharacterStream

public Reader getCharacterStream(String parameterName)
                          throws SQLException

Specified by:

getCharacterStream in interface CallableStatement

Throws:

SQLException

getNCharacterStream

public Reader getNCharacterStream(int parameterIndex)
                           throws SQLException

Implementation note: This method behaves exactly the same as getCharacterStream(int).

Specified by:

getNCharacterStream in interface CallableStatement

Throws:

SQLException

getNCharacterStream

public Reader getNCharacterStream(String parameterName)
                           throws SQLException

Implementation note: This method behaves exactly the same as getCharacterStream(String) .

Specified by:

getNCharacterStream in interface CallableStatement

Throws:

SQLException

getNString

public String getNString(int parameterIndex)
                  throws SQLException

Implementation note: This method behaves exactly the same as getString(int).

Specified by:

getNString in interface CallableStatement

Throws:

SQLException

getNString

public String getNString(String parameterName)
                  throws SQLException

Implementation note: This method behaves exactly the same as getString(String).

Specified by:

getNString in interface CallableStatement

Throws:

SQLException

setAsciiStream

public void setAsciiStream(String parameterName,
 InputStream x,
 long length)
                    throws SQLException

Specified by:

setAsciiStream in interface CallableStatement

Throws:

SQLException

setAsciiStream

public void setAsciiStream(String parameterName,
 InputStream x)
                    throws SQLException

Specified by:

setAsciiStream in interface CallableStatement

Throws:

SQLException

setBinaryStream

public void setBinaryStream(String parameterName,
 InputStream x,
 long length)
                     throws SQLException

Specified by:

setBinaryStream in interface CallableStatement

Throws:

SQLException

setBinaryStream

public void setBinaryStream(String parameterName,
 InputStream x)
                     throws SQLException

Specified by:

setBinaryStream in interface CallableStatement

Throws:

SQLException

setBlob

public void setBlob(String parameterName,
 Blob x)
             throws SQLException

Specified by:

setBlob in interface CallableStatement

Throws:

SQLException

setBlob

public void setBlob(String parameterName,
 InputStream inputStream,
 long length)
             throws SQLException

Specified by:

setBlob in interface CallableStatement

Throws:

SQLException

setBlob

public void setBlob(String parameterName,
 InputStream inputStream)
             throws SQLException

Specified by:

setBlob in interface CallableStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(String parameterName,
 Reader reader,
 long length)
                        throws SQLException

Specified by:

setCharacterStream in interface CallableStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(String parameterName,
 Reader reader)
                        throws SQLException

Specified by:

setCharacterStream in interface CallableStatement

Throws:

SQLException

setClob

public void setClob(String parameterName,
 Clob x)
             throws SQLException

Specified by:

setClob in interface CallableStatement

Throws:

SQLException

setClob

public void setClob(String parameterName,
 Reader reader,
 long length)
             throws SQLException

Specified by:

setClob in interface CallableStatement

Throws:

SQLException

setClob

public void setClob(String parameterName,
 Reader reader)
             throws SQLException

Specified by:

setClob in interface CallableStatement

Throws:

SQLException

setNCharacterStream

public void setNCharacterStream(String parameterName,
 Reader value,
 long length)
                         throws SQLException

Implementation note: This method behaves exactly the same as setCharacterStream(String, Reader, long).

Specified by:

setNCharacterStream in interface CallableStatement

Throws:

SQLException

setNCharacterStream

public void setNCharacterStream(String parameterName,
 Reader value)
                         throws SQLException

Implementation note: This method behaves exactly the same as setCharacterStream(String, Reader).

Specified by:

setNCharacterStream in interface CallableStatement

Throws:

SQLException

setNClob

public void setNClob(String parameterName,
 Reader reader,
 long length)
              throws SQLException

Implementation note: This method behaves exactly the same as setClob(String, Reader, long).

Specified by:

setNClob in interface CallableStatement

Throws:

SQLException

setNClob

public void setNClob(String parameterName,
 Reader reader)
              throws SQLException

Implementation note: This method behaves exactly the same as setClob(String, Reader).

Specified by:

setNClob in interface CallableStatement

Throws:

SQLException

setNString

public void setNString(String parameterName,
 String value)
                throws SQLException

Implementation note: This method behaves exactly the same as setString(String, String).

Specified by:

setNString in interface CallableStatement

Throws:

SQLException

registerOutParameter

public void registerOutParameter(String param1,
 int param2)
                          throws SQLException

Specified by:

registerOutParameter in interface CallableStatement

Throws:

SQLException

registerOutParameter

public void registerOutParameter(String param1,
 int param2,
 int param3)
                          throws SQLException

Specified by:

registerOutParameter in interface CallableStatement

Throws:

SQLException

registerOutParameter

public void registerOutParameter(String param1,
 int param2,
 String param3)
                          throws SQLException

Specified by:

registerOutParameter in interface CallableStatement

Throws:

SQLException

setURL

public void setURL(String param1,
 URL param2)
            throws SQLException

Specified by:

setURL in interface CallableStatement

Throws:

SQLException

setNull

public void setNull(String param1,
 int param2)
             throws SQLException

Specified by:

setNull in interface CallableStatement

Throws:

SQLException

setBoolean

public void setBoolean(String param1,
 boolean param2)
                throws SQLException

Specified by:

setBoolean in interface CallableStatement

Throws:

SQLException

setByte

public void setByte(String param1,
 byte param2)
             throws SQLException

Specified by:

setByte in interface CallableStatement

Throws:

SQLException

setShort

public void setShort(String param1,
 short param2)
              throws SQLException

Specified by:

setShort in interface CallableStatement

Throws:

SQLException

setInt

public void setInt(String param1,
 int param2)
            throws SQLException

Specified by:

setInt in interface CallableStatement

Throws:

SQLException

setLong

public void setLong(String param1,
 long param2)
             throws SQLException

Specified by:

setLong in interface CallableStatement

Throws:

SQLException

setFloat

public void setFloat(String param1,
 float param2)
              throws SQLException

Specified by:

setFloat in interface CallableStatement

Throws:

SQLException

setDouble

public void setDouble(String param1,
 double param2)
               throws SQLException

Specified by:

setDouble in interface CallableStatement

Throws:

SQLException

setBigDecimal

public void setBigDecimal(String param1,
 BigDecimal param2)
                   throws SQLException

Specified by:

setBigDecimal in interface CallableStatement

Throws:

SQLException

setString

public void setString(String param1,
 String param2)
               throws SQLException

Specified by:

setString in interface CallableStatement

Throws:

SQLException

setBytes

public void setBytes(String param1,
 byte[] param2)
              throws SQLException

Specified by:

setBytes in interface CallableStatement

Throws:

SQLException

setDate

public void setDate(String param1,
 Date param2)
             throws SQLException

Specified by:

setDate in interface CallableStatement

Throws:

SQLException

setTime

public void setTime(String param1,
 Time param2)
             throws SQLException

Specified by:

setTime in interface CallableStatement

Throws:

SQLException

setTimestamp

public void setTimestamp(String param1,
 Timestamp param2)
                  throws SQLException

Specified by:

setTimestamp in interface CallableStatement

Throws:

SQLException

setAsciiStream

public void setAsciiStream(String param1,
 InputStream param2,
 int param3)
                    throws SQLException

Specified by:

setAsciiStream in interface CallableStatement

Throws:

SQLException

setBinaryStream

public void setBinaryStream(String param1,
 InputStream param2,
 int param3)
                     throws SQLException

Specified by:

setBinaryStream in interface CallableStatement

Throws:

SQLException

setObject

public void setObject(String param1,
 Object param2,
 int param3,
 int param4)
               throws SQLException

Specified by:

setObject in interface CallableStatement

Throws:

SQLException

setObject

public void setObject(String param1,
 Object param2,
 int param3)
               throws SQLException

Specified by:

setObject in interface CallableStatement

Throws:

SQLException

setObject

public void setObject(String param1,
 Object param2)
               throws SQLException

Specified by:

setObject in interface CallableStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(String param1,
 Reader param2,
 int param3)
                        throws SQLException

Specified by:

setCharacterStream in interface CallableStatement

Throws:

SQLException

setDate

public void setDate(String param1,
 Date param2,
 Calendar param3)
             throws SQLException

Specified by:

setDate in interface CallableStatement

Throws:

SQLException

setTime

public void setTime(String param1,
 Time param2,
 Calendar param3)
             throws SQLException

Specified by:

setTime in interface CallableStatement

Throws:

SQLException

setTimestamp

public void setTimestamp(String param1,
 Timestamp param2,
 Calendar param3)
                  throws SQLException

Specified by:

setTimestamp in interface CallableStatement

Throws:

SQLException

setNull

public void setNull(String param1,
 int param2,
 String param3)
             throws SQLException

Specified by:

setNull in interface CallableStatement

Throws:

SQLException

registerOutParameter

public void registerOutParameter(int parameterIndex,
 int sqlType,
 String typeName)
                          throws SQLException

Specified by:

registerOutParameter in interface CallableStatement

Throws:

SQLException

getGeneratedKeys

public ResultSet getGeneratedKeys()
                           throws SQLException

Specified by:

getGeneratedKeys in interface Statement

Overrides:

getGeneratedKeys in class FBStatement

Throws:

SQLException

assertHasData

protected void assertHasData(ResultSet rs)
                      throws SQLException

Asserts if the current statement has data to return. It checks if the result set has a row with data.

Parameters:

rs - result set to test

Throws:

SQLException - when the result set has no data.

getCurrentResultSet

public ResultSet getCurrentResultSet()
                              throws SQLException

Description copied from interface: FirebirdStatement

Get current result set. Behaviour of this method is similar to the behavior of the Statement.getResultSet(), except that this method can be called as much as you like.

Specified by:

getCurrentResultSet in interface FirebirdStatement

Overrides:

getCurrentResultSet in class FBStatement

Returns:

instance of ResultSet representing current result set or null if it is not available.

Throws:

SQLException - if database access error happened.

getAndAssertSingletonResultSet

protected ResultSet getAndAssertSingletonResultSet()
                                            throws SQLException

Returns the result set for the singleton row of the callable statement and asserts it has data. If this is a selectable procedure, or there is no singleton row, it will return the normal result set.

This should fix the problem described in JDBC-350 in most circumstances.

Returns:

Either the singleton result set, or the current result set as described above

Throws:

SQLException - For database access errors

getResultSet

public ResultSet getResultSet()
                       throws SQLException

Calling this method twice with autocommit on and used will probably throw an inappropriate or uninformative exception.

Specified by:

getResultSet in interface Statement

Overrides:

getResultSet in class FBStatement

Throws:

SQLException

setBigDecimal

public void setBigDecimal(int parameterIndex,
 BigDecimal x)
                   throws SQLException

Specified by:

setBigDecimal in interface PreparedStatement

Overrides:

setBigDecimal in class AbstractPreparedStatement

Throws:

SQLException

setBinaryStream

public void setBinaryStream(int parameterIndex,
 InputStream inputStream,
 int length)
                     throws SQLException

Specified by:

setBinaryStream in interface PreparedStatement

Overrides:

setBinaryStream in class AbstractPreparedStatement

Throws:

SQLException

setBinaryStream

public void setBinaryStream(int parameterIndex,
 InputStream inputStream,
 long length)
                     throws SQLException

Specified by:

setBinaryStream in interface PreparedStatement

Overrides:

setBinaryStream in class AbstractPreparedStatement

Throws:

SQLException

setBinaryStream

public void setBinaryStream(int parameterIndex,
 InputStream inputStream)
                     throws SQLException

Specified by:

setBinaryStream in interface PreparedStatement

Overrides:

setBinaryStream in class AbstractPreparedStatement

Throws:

SQLException

setBlob

public void setBlob(int parameterIndex,
 Blob blob)
             throws SQLException

Specified by:

setBlob in interface PreparedStatement

Overrides:

setBlob in class AbstractPreparedStatement

Throws:

SQLException

setBlob

public void setBlob(int parameterIndex,
 InputStream inputStream,
 long length)
             throws SQLException

Specified by:

setBlob in interface PreparedStatement

Overrides:

setBlob in class AbstractPreparedStatement

Throws:

SQLException

setBlob

public void setBlob(int parameterIndex,
 InputStream inputStream)
             throws SQLException

Specified by:

setBlob in interface PreparedStatement

Overrides:

setBlob in class AbstractPreparedStatement

Throws:

SQLException

setBoolean

public void setBoolean(int parameterIndex,
 boolean x)
                throws SQLException

Specified by:

setBoolean in interface PreparedStatement

Overrides:

setBoolean in class AbstractPreparedStatement

Throws:

SQLException

setByte

public void setByte(int parameterIndex,
 byte x)
             throws SQLException

Specified by:

setByte in interface PreparedStatement

Overrides:

setByte in class AbstractPreparedStatement

Throws:

SQLException

setBytes

public void setBytes(int parameterIndex,
 byte[] x)
              throws SQLException

Specified by:

setBytes in interface PreparedStatement

Overrides:

setBytes in class AbstractPreparedStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(int parameterIndex,
 Reader reader,
 int length)
                        throws SQLException

Specified by:

setCharacterStream in interface PreparedStatement

Overrides:

setCharacterStream in class AbstractPreparedStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(int parameterIndex,
 Reader reader,
 long length)
                        throws SQLException

Specified by:

setCharacterStream in interface PreparedStatement

Overrides:

setCharacterStream in class AbstractPreparedStatement

Throws:

SQLException

setCharacterStream

public void setCharacterStream(int parameterIndex,
 Reader reader)
                        throws SQLException

Specified by:

setCharacterStream in interface PreparedStatement

Overrides:

setCharacterStream in class AbstractPreparedStatement

Throws:

SQLException

setClob

public void setClob(int parameterIndex,
 Clob x)
             throws SQLException

Specified by:

setClob in interface PreparedStatement

Overrides:

setClob in class AbstractPreparedStatement

Throws:

SQLException

setClob

public void setClob(int parameterIndex,
 Reader reader,
 long length)
             throws SQLException

Specified by:

setClob in interface PreparedStatement

Overrides:

setClob in class AbstractPreparedStatement

Throws:

SQLException

setClob

public void setClob(int parameterIndex,
 Reader reader)
             throws SQLException

Specified by:

setClob in interface PreparedStatement

Overrides:

setClob in class AbstractPreparedStatement

Throws:

SQLException

setDate

public void setDate(int parameterIndex,
 Date x,
 Calendar cal)
             throws SQLException

Specified by:

setDate in interface PreparedStatement

Overrides:

setDate in class AbstractPreparedStatement

Throws:

SQLException

setDate

public void setDate(int parameterIndex,
 Date x)
             throws SQLException

Specified by:

setDate in interface PreparedStatement

Overrides:

setDate in class AbstractPreparedStatement

Throws:

SQLException

setDouble

public void setDouble(int parameterIndex,
 double x)
               throws SQLException

Specified by:

setDouble in interface PreparedStatement

Overrides:

setDouble in class AbstractPreparedStatement

Throws:

SQLException

setFloat

public void setFloat(int parameterIndex,
 float x)
              throws SQLException

Specified by:

setFloat in interface PreparedStatement

Overrides:

setFloat in class AbstractPreparedStatement

Throws:

SQLException

setInt

public void setInt(int parameterIndex,
 int x)
            throws SQLException

Specified by:

setInt in interface PreparedStatement

Overrides:

setInt in class AbstractPreparedStatement

Throws:

SQLException

setLong

public void setLong(int parameterIndex,
 long x)
             throws SQLException

Specified by:

setLong in interface PreparedStatement

Overrides:

setLong in class AbstractPreparedStatement

Throws:

SQLException

setNull

public void setNull(int parameterIndex,
 int sqlType,
 String typeName)
             throws SQLException

Specified by:

setNull in interface PreparedStatement

Overrides:

setNull in class AbstractPreparedStatement

Throws:

SQLException

setNull

public void setNull(int parameterIndex,
 int sqlType)
             throws SQLException

Specified by:

setNull in interface PreparedStatement

Overrides:

setNull in class AbstractPreparedStatement

Throws:

SQLException

setObject

public void setObject(int parameterIndex,
 Object x,
 int targetSqlType,
 int scale)
               throws SQLException

Description copied from class: AbstractPreparedStatement

Implementation note: ignores scale and targetSqlType and works as AbstractPreparedStatement.setObject(int, Object).

Specified by:

setObject in interface PreparedStatement

Overrides:

setObject in class AbstractPreparedStatement

Throws:

SQLException

setObject

public void setObject(int parameterIndex,
 Object x,
 int targetSqlType)
               throws SQLException

Description copied from class: AbstractPreparedStatement

Implementation note: ignores targetSqlType and works as AbstractPreparedStatement.setObject(int, Object).

Specified by:

setObject in interface PreparedStatement

Overrides:

setObject in class AbstractPreparedStatement

Throws:

SQLException

setObject

public void setObject(int parameterIndex,
 Object x)
               throws SQLException

Specified by:

setObject in interface PreparedStatement

Overrides:

setObject in class AbstractPreparedStatement

Throws:

SQLException

setShort

public void setShort(int parameterIndex,
 short x)
              throws SQLException

Specified by:

setShort in interface PreparedStatement

Overrides:

setShort in class AbstractPreparedStatement

Throws:

SQLException

setString

public void setString(int parameterIndex,
 String x)
               throws SQLException

Specified by:

setString in interface PreparedStatement

Overrides:

setString in class AbstractPreparedStatement

Throws:

SQLException

setTime

public void setTime(int parameterIndex,
 Time x,
 Calendar cal)
             throws SQLException

Specified by:

setTime in interface PreparedStatement

Overrides:

setTime in class AbstractPreparedStatement

Throws:

SQLException

setTime

public void setTime(int parameterIndex,
 Time x)
             throws SQLException

Specified by:

setTime in interface PreparedStatement

Overrides:

setTime in class AbstractPreparedStatement

Throws:

SQLException

setTimestamp

public void setTimestamp(int parameterIndex,
 Timestamp x,
 Calendar cal)
                  throws SQLException

Specified by:

setTimestamp in interface PreparedStatement

Overrides:

setTimestamp in class AbstractPreparedStatement

Throws:

SQLException

setTimestamp

public void setTimestamp(int parameterIndex,
 Timestamp x)
                  throws SQLException

Specified by:

setTimestamp in interface PreparedStatement

Overrides:

setTimestamp in class AbstractPreparedStatement

Throws:

SQLException

findOutParameter

protected int findOutParameter(String paramName)
                        throws SQLException

Helper method to identify the right result set column for the give OUT parameter name.

Parameters:

paramName - Name of the OUT parameter

Throws:

SQLException

getNClob

public NClob getNClob(int parameterIndex)
               throws SQLException

Implementation note: This method behaves exactly the same as getClob(int).

Specified by:

getNClob in interface CallableStatement

Throws:

SQLException

getNClob

public NClob getNClob(String parameterName)
               throws SQLException

Implementation note: This method behaves exactly the same as getClob(String).

Specified by:

getNClob in interface CallableStatement

Throws:

SQLException

getRowId

public RowId getRowId(int parameterIndex)
               throws SQLException

Specified by:

getRowId in interface CallableStatement

Throws:

SQLException

getRowId

public RowId getRowId(String parameterName)
               throws SQLException

Specified by:

getRowId in interface CallableStatement

Throws:

SQLException

getSQLXML

public SQLXML getSQLXML(int parameterIndex)
                 throws SQLException

Specified by:

getSQLXML in interface CallableStatement

Throws:

SQLException

getSQLXML

public SQLXML getSQLXML(String parameterName)
                 throws SQLException

Specified by:

getSQLXML in interface CallableStatement

Throws:

SQLException

setNClob

public void setNClob(String parameterName,
 NClob value)
              throws SQLException

Implementation note: This method behaves exactly the same as setClob(String, Clob).

Specified by:

setNClob in interface CallableStatement

Throws:

SQLException

setRowId

public void setRowId(String parameterName,
 RowId x)
              throws SQLException

Specified by:

setRowId in interface CallableStatement

Throws:

SQLException

setSQLXML

public void setSQLXML(String parameterName,
 SQLXML xmlObject)
               throws SQLException

Specified by:

setSQLXML in interface CallableStatement

Throws:

SQLException