Interface ISQLServerCallableStatement
-
- All Superinterfaces:
AutoCloseable,CallableStatement,ISQLServerPreparedStatement,ISQLServerStatement,PreparedStatement,Serializable,Statement,Wrapper
- All Known Implementing Classes:
SQLServerCallableStatement
public interface ISQLServerCallableStatement extends CallableStatement, ISQLServerPreparedStatement
Provides an interface to theSQLServerCallableStatementclass.
-
-
Field Summary
-
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
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description InputStreamgetAsciiStream(int parameterIndex)Returns the value of the designated column in the current row of thisResultSetobject as a stream of ASCII characters.InputStreamgetAsciiStream(String parameterName)Returns the value of the designated column in the current row of thisResultSetobject as a stream of ASCII characters.BigDecimalgetBigDecimal(String parameterName, int scale)Deprecated.InputStreamgetBinaryStream(int parameterIndex)Returns the value of the designated column in the current row of thisResultSetobject as a stream of uninterpreted bytes.InputStreamgetBinaryStream(String parameterName)Returns the value of the designated column in the current row of thisResultSetobject as a stream of uninterpretedbytes.TimestampgetDateTime(int index)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.TimestampgetDateTime(int index, Calendar cal)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.TimestampgetDateTime(String parameterName)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.TimestampgetDateTime(String name, Calendar cal)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.DateTimeOffsetgetDateTimeOffset(int parameterIndex)Returns the DateTimeOffset value of parameter with index parameterIndex.DateTimeOffsetgetDateTimeOffset(String parameterName)Returns the DateTimeOffset value of parameter with name parameterName.BigDecimalgetMoney(int parameterIndex)Returns the value of the column specified as a java.math.BigDecimal object.BigDecimalgetMoney(String parameterName)Returns the value of the column specified as a java.math.BigDecimal object.TimestampgetSmallDateTime(int index)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.TimestampgetSmallDateTime(int index, Calendar cal)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.TimestampgetSmallDateTime(String parameterName)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.TimestampgetSmallDateTime(String name, Calendar cal)Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.BigDecimalgetSmallMoney(int parameterIndex)Returns the value of the column specified as a java.math.BigDecimal object.BigDecimalgetSmallMoney(String parameterName)Returns the value of the column specified as a java.math.BigDecimal object.voidregisterOutParameter(int parameterIndex, int sqlType, int precision, int scale)Registers the parameter in ordinal position index to be of JDBC type sqlType.voidregisterOutParameter(int parameterIndex, SQLType sqlType, int precision, int scale)Registers the parameter in ordinal position index to be of JDBC type sqlType.voidregisterOutParameter(String parameterName, int sqlType, int precision, int scale)Registers the parameter in ordinal position index to be of JDBC type sqlType.voidregisterOutParameter(String parameterName, SQLType sqlType, int precision, int scale)Registers the parameter in ordinal position index to be of JDBC type sqlType.voidsetBigDecimal(String parameterName, BigDecimal value, int precision, int scale)Sets the designated parameter to the givenjava.math.BigDecimalvalue.voidsetBigDecimal(String parameterName, BigDecimal value, int precision, int scale, boolean forceEncrypt)Sets the designated parameter to the givenjava.math.BigDecimalvalue.voidsetBoolean(String parameterName, boolean value, boolean forceEncrypt)Sets the designated parameter to the given Javabooleanvalue.voidsetByte(String parameterName, byte value, boolean forceEncrypt)Sets the designated parameter to the given Javabytevalue.voidsetBytes(String parameterName, byte[] value, boolean forceEncrypt)Sets the designated parameter to the given Java array of bytes.voidsetDate(String parameterName, Date value, Calendar calendar, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Datevalue, using the givenCalendarobject.voidsetDateTime(String parameterName, Timestamp value)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetDateTime(String parameterName, Timestamp value, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetDateTimeOffset(String parameterName, DateTimeOffset value)Sets parameter parameterName to DateTimeOffset value.voidsetDateTimeOffset(String parameterName, DateTimeOffset value, int scale)Sets parameter parameterName to DateTimeOffset value.voidsetDateTimeOffset(String parameterName, DateTimeOffset value, int scale, boolean forceEncrypt)Sets parameter parameterName to DateTimeOffset value.voidsetDouble(String parameterName, double value, boolean forceEncrypt)Sets the designated parameter to the given Javadoublevalue.voidsetFloat(String parameterName, float value, boolean forceEncrypt)Sets the designated parameter to the given Javafloatvalue.voidsetInt(String parameterName, int value, boolean forceEncrypt)Sets the designated parameter to the given Javaintvalue.voidsetLong(String parameterName, long value, boolean forceEncrypt)Sets the designated parameter to the given Javalongvalue.voidsetMoney(String parameterName, BigDecimal value)Sets the designated parameter to the given Javajava.math.BigDecimalvalue.voidsetMoney(String parameterName, BigDecimal value, boolean forceEncrypt)Sets the designated parameter to the given Javajava.math.BigDecimalvalue.voidsetNString(String parameterName, String value, boolean forceEncrypt)Sets the designated parameter to the givenStringobject.voidsetObject(String parameterName, Object value, int sqlType, int decimals, boolean forceEncrypt)Sets the value of the designated parameter with the given object.voidsetObject(String parameterName, Object value, int targetSqlType, Integer precision, int scale)Sets the value of the designated parameter with the given object.voidsetObject(String parameterName, Object value, SQLType jdbcType, int scale, boolean forceEncrypt)Sets the value of the designated parameter with the given object.voidsetShort(String parameterName, short value, boolean forceEncrypt)Sets the designated parameter to the given Javashortvalue.voidsetSmallDateTime(String parameterName, Timestamp value)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetSmallDateTime(String parameterName, Timestamp value, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetSmallMoney(String parameterName, BigDecimal value)Sets the designated parameter to the given Javajava.math.BigDecimalvalue.voidsetSmallMoney(String parameterName, BigDecimal value, boolean forceEncrypt)Sets the designated parameter to the given Javajava.math.BigDecimalvalue.voidsetString(String parameterName, String value, boolean forceEncrypt)Sets the designated parameter to the given JavaStringvalue.voidsetStructured(String parameterName, String tvpName, ISQLServerDataRecord tvpDataRecord)Populates a table valued parameter passed to a stored procedure with an ISQLServerDataRecord object.voidsetStructured(String parameterName, String tvpName, SQLServerDataTable tvpDataTable)Populates a table valued parameter passed to a stored procedure with a data table.voidsetStructured(String parameterName, String tvpName, ResultSet tvpResultSet)Populates a table valued parameter passed to a stored procedure with a ResultSet retrieved from another tablevoidsetTime(String parameterName, Time value, int scale)Sets the designated parameter to the givenjava.sql.Timevalue.voidsetTime(String parameterName, Time value, int scale, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Timevalue.voidsetTime(String parameterName, Time value, Calendar calendar, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Timevalue, using the givenCalendarobject.voidsetTimestamp(String parameterName, Timestamp value, int scale)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetTimestamp(String parameterName, Timestamp value, int scale, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetTimestamp(String parameterName, Timestamp value, Calendar calendar, boolean forceEncrypt)Sets the designated parameter to the givenjava.sql.Timestampvalue.voidsetUniqueIdentifier(String parameterName, String guid)Sets the designated parameter to the givenStringvalue.voidsetUniqueIdentifier(String parameterName, String guid, boolean forceEncrypt)Sets the designated parameter to the givenStringvalue.-
Methods inherited from interface java.sql.CallableStatement
getArray, getArray, getBigDecimal, getBigDecimal, getBigDecimal, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getDate, getDate, getDate, getDate, getDouble, getDouble, getFloat, getFloat, getInt, getInt, getLong, getLong, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getObject, getObject, getRef, getRef, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getURL, getURL, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, registerOutParameter, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setURL, wasNull
-
Methods inherited from interface com.microsoft.sqlserver.jdbc.ISQLServerPreparedStatement
getParameterMetaData, getPreparedStatementHandle, getUseFmtOnly, setBigDecimal, setBigDecimal, setBoolean, setByte, setBytes, setDate, setDateTime, setDateTime, setDateTimeOffset, setDateTimeOffset, setDateTimeOffset, setDouble, setFloat, setGeography, setGeometry, setInt, setLong, setMoney, setMoney, setNString, setObject, setObject, setObject, setObject, setShort, setSmallDateTime, setSmallDateTime, setSmallMoney, setSmallMoney, setString, setStructured, setStructured, setStructured, setTime, setTime, setTime, setTimestamp, setTimestamp, setTimestamp, setUniqueIdentifier, setUniqueIdentifier, setUseFmtOnly
-
Methods inherited from interface com.microsoft.sqlserver.jdbc.ISQLServerStatement
getCancelQueryTimeout, getResponseBuffering, setCancelQueryTimeout, setResponseBuffering
-
Methods inherited from interface java.sql.PreparedStatement
addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, 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, getGeneratedKeys, getLargeMaxRows, getLargeUpdateCount, getMaxFieldSize, getMaxRows, getMoreResults, getMoreResults, getQueryTimeout, getResultSet, 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
-
-
-
-
Method Detail
-
getBigDecimal
@Deprecated(since="6.5.4") BigDecimal getBigDecimal(String parameterName, int scale) throws SQLServerException
Deprecated.Returns the value of the designated column in the current row of this ResultSet object as a java.sql.BigDecimal object in the Java programming language.- Parameters:
parameterName- the label for the columnscale- the scale of the BigDecimal- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getDateTime
Timestamp getDateTime(int index) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.- Parameters:
index- the first column is 1, the second is 2, ...- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getDateTime
Timestamp getDateTime(String parameterName) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.- Parameters:
parameterName- the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getDateTime
Timestamp getDateTime(int index, Calendar cal) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the timestamp if the underlying database does not store timezone information.- Parameters:
index- the first column is 1, the second is 2, ...cal- the java.util.Calendar object to use in constructing the dateTime- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getDateTime
Timestamp getDateTime(String name, Calendar cal) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language. This method uses the given calendar to construct an appropriate millisecond value for the timestamp if the underlying database does not store timezone information.- Parameters:
name- the name of the columncal- the java.util.Calendar object to use in constructing the dateTime- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getSmallDateTime
Timestamp getSmallDateTime(int index) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.- Parameters:
index- the first column is 1, the second is 2, ...- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getSmallDateTime
Timestamp getSmallDateTime(String parameterName) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.- Parameters:
parameterName- The name of a column.- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getSmallDateTime
Timestamp getSmallDateTime(int index, Calendar cal) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.- Parameters:
index- the first column is 1, the second is 2, ...cal- the java.util.Calendar object to use in constructing the smalldateTime- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getSmallDateTime
Timestamp getSmallDateTime(String name, Calendar cal) throws SQLServerException
Returns the value of the designated column in the current row of this ResultSet object as a java.sql.Timestamp object in the Java programming language.- Parameters:
name- The name of a columncal- the java.util.Calendar object to use in constructing the smalldateTime- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getDateTimeOffset
DateTimeOffset getDateTimeOffset(int parameterIndex) throws SQLServerException
Returns the DateTimeOffset value of parameter with index parameterIndex.- Parameters:
parameterIndex- the first parameter is 1, the second is 2, and so on- Returns:
- DateTimeOffset value if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- if parameterIndex is out of range; if a database access error occurs or this method is called on a closedCallableStatement
-
getDateTimeOffset
DateTimeOffset getDateTimeOffset(String parameterName) throws SQLServerException
Returns the DateTimeOffset value of parameter with name parameterName.- Parameters:
parameterName- the name of the parameter- Returns:
- DateTimeOffset value if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
getAsciiStream
InputStream getAsciiStream(int parameterIndex) throws SQLServerException
Returns the value of the designated column in the current row of thisResultSetobject as a stream of ASCII characters. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will do any necessary conversion from the database format into ASCII.Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return
0when the methodInputStream.availableis called whether there is data available or not.- Parameters:
parameterIndex- the first column is 1, the second is 2, ...- Returns:
- a Java input stream that delivers the database column value as a stream of one-byte ASCII characters; if
the value is SQL
NULL, the value returned isnull - Throws:
SQLServerException- if the columnIndex is not valid; if a database access error occurs or this method is called on a closed result set
-
getAsciiStream
InputStream getAsciiStream(String parameterName) throws SQLServerException
Returns the value of the designated column in the current row of thisResultSetobject as a stream of ASCII characters. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will do any necessary conversion from the database format into ASCII.Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return
0when the methodavailableis called whether there is data available or not.- Parameters:
parameterName- the name of the parameter- Returns:
- a Java input stream that delivers the database column value as a stream of one-byte ASCII characters. If
the value is SQL
NULL, the value returned isnull. - Throws:
SQLServerException- if the columnLabel is not valid; if a database access error occurs or this method is called on a closed result set
-
getMoney
BigDecimal getMoney(int parameterIndex) throws SQLServerException
Returns the value of the column specified as a java.math.BigDecimal object.- Parameters:
parameterIndex- The zero-based ordinal of a column.- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getMoney
BigDecimal getMoney(String parameterName) throws SQLServerException
Returns the value of the column specified as a java.math.BigDecimal object.- Parameters:
parameterName- The name of a column.- Returns:
- the column value; if the value is SQL NULL, the value returned is null.
- Throws:
SQLServerException- when an error occurs
-
getSmallMoney
BigDecimal getSmallMoney(int parameterIndex) throws SQLServerException
Returns the value of the column specified as a java.math.BigDecimal object.- Parameters:
parameterIndex- The zero-based ordinal of a column.- Returns:
- the column value; if the value is SQL NULL, the value returned is null
- Throws:
SQLServerException- when an error occurs
-
getSmallMoney
BigDecimal getSmallMoney(String parameterName) throws SQLServerException
Returns the value of the column specified as a java.math.BigDecimal object.- Parameters:
parameterName- The name of a column.- Returns:
- the column value; if the value is SQL NULL, the value returned is null.
- Throws:
SQLServerException- when an error occurs
-
getBinaryStream
InputStream getBinaryStream(int parameterIndex) throws SQLServerException
Returns the value of the designated column in the current row of thisResultSetobject as a stream of uninterpreted bytes. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving largeLONGVARBINARYvalues.Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return
0when the methodInputStream.availableis called whether there is data available or not.- Parameters:
parameterIndex- the first column is 1, the second is 2, ...- Returns:
- a Java input stream that delivers the database column value as a stream of uninterpreted bytes; if the
value is SQL
NULL, the value returned isnull - Throws:
SQLServerException- if the columnIndex is not valid; if a database access error occurs or this method is called on a closed result set
-
getBinaryStream
InputStream getBinaryStream(String parameterName) throws SQLServerException
Returns the value of the designated column in the current row of thisResultSetobject as a stream of uninterpretedbytes. The value can then be read in chunks from the stream. This method is particularly suitable for retrieving largeLONGVARBINARYvalues.Note: All the data in the returned stream must be read prior to getting the value of any other column. The next call to a getter method implicitly closes the stream. Also, a stream may return
0when the methodavailableis called whether there is data available or not.- Parameters:
parameterName- the name of the parameter- Returns:
- a Java input stream that delivers the database column value as a stream of uninterpreted bytes; if the
value is SQL
NULL, the result isnull - Throws:
SQLServerException- if the columnLabel is not valid; if a database access error occurs or this method is called on a closed result set
-
setTimestamp
void setTimestamp(String parameterName, Timestamp value, Calendar calendar, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLTIMESTAMPvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valuecalendar- a java.util.CalendarforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getTimestamp(int)
-
setTime
void setTime(String parameterName, Time value, Calendar calendar, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timevalue, using the givenCalendarobject. The driver uses theCalendarobject to construct an SQLTIMEvalue, which the driver then sends to the database. With a aCalendarobject, the driver can calculate the time taking into account a custom timezone. If noCalendarobject is specified, the driver uses the default timezone, which is that of the virtual machine running the application.- Parameters:
parameterName- the name of the parametervalue- the parameter valuecalendar- theCalendarobject the driver will use to construct the timeforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getTime(int)
-
setDate
void setDate(String parameterName, Date value, Calendar calendar, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Datevalue, using the givenCalendarobject. The driver uses theCalendarobject to construct an SQLDATEvalue, which the driver then sends to the database. With a aCalendarobject, the driver can calculate the date taking into account a custom timezone. If noCalendarobject is specified, the driver uses the default timezone, which is that of the virtual machine running the application.- Parameters:
parameterName- the name of the parametervalue- the parameter valuecalendar- theCalendarobject the driver will use to construct the dateforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getDate(int)
-
setNString
void setNString(String parameterName, String value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenStringobject. The driver converts this to a SQLNCHARorNVARCHARorLONGNVARCHAR- Parameters:
parameterName- the name of the parameter to be setvalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if the driver does not support national character sets; if the driver can detect that a data conversion error could occur; if a database access error occurs or this method is called on a closedCallableStatement
-
setObject
void setObject(String parameterName, Object value, int sqlType, int decimals, boolean forceEncrypt) throws SQLServerException
Sets the value of the designated parameter with the given object.The given Java object will be converted to the given targetSqlType before being sent to the database. If the object has a custom mapping (is of a class implementing the interface
SQLData), the JDBC driver should call the methodSQLData.writeSQLto write it to the SQL data stream. If, on the other hand, the object is of a class implementingRef,Blob,Clob,NClob,Struct,java.net.URL, orArray, the driver should pass it to the database as a value of the corresponding SQL type.Note that this method may be used to pass database- specific abstract data types.
- Parameters:
parameterName- the name of the parametervalue- the object containing the input parameter valuesqlType- the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.decimals- for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, this is the number of digits after the decimal point. For all other types, this value will be ignored.forceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
Types,CallableStatement.getObject(int)
-
setObject
void setObject(String parameterName, Object value, int targetSqlType, Integer precision, int scale) throws SQLServerException
Sets the value of the designated parameter with the given object.The given Java object will be converted to the given targetSqlType before being sent to the database. If the object has a custom mapping (is of a class implementing the interface
SQLData), the JDBC driver should call the methodSQLData.writeSQLto write it to the SQL data stream. If, on the other hand, the object is of a class implementingRef,Blob,Clob,NClob,Struct,java.net.URL, orArray, the driver should pass it to the database as a value of the corresponding SQL type.Note that this method may be used to pass datatabase- specific abstract data types.
- Parameters:
parameterName- the name of the parametervalue- the object containing the input parameter valuetargetSqlType- the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.precision- the precision of the column.scale- the scale of the column.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
Types,CallableStatement.getObject(int)
-
setTimestamp
void setTimestamp(String parameterName, Timestamp value, int scale) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLTIMESTAMPvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valuescale- the scale of the parameter- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getTimestamp(int)
-
setTimestamp
void setTimestamp(String parameterName, Timestamp value, int scale, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLTIMESTAMPvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valuescale- the scale of the parameterforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getTimestamp(int)
-
setDateTimeOffset
void setDateTimeOffset(String parameterName, DateTimeOffset value) throws SQLServerException
Sets parameter parameterName to DateTimeOffset value.- Parameters:
parameterName- the name of the parametervalue- DateTimeOffset value- Throws:
SQLServerException- if an error occurs
-
setDateTimeOffset
void setDateTimeOffset(String parameterName, DateTimeOffset value, int scale) throws SQLServerException
Sets parameter parameterName to DateTimeOffset value.- Parameters:
parameterName- the name of the parametervalue- DateTimeOffset valuescale- the scale of the parameter- Throws:
SQLServerException- if an error occurs
-
setDateTimeOffset
void setDateTimeOffset(String parameterName, DateTimeOffset value, int scale, boolean forceEncrypt) throws SQLServerException
Sets parameter parameterName to DateTimeOffset value.- Parameters:
parameterName- the name of the parametervalue- DateTimeOffset valuescale- the scale of the parameterforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if an error occurs
-
setTime
void setTime(String parameterName, Time value, int scale) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timevalue. The driver converts this to an SQLTIMEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valuescale- the scale of the column- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getTime(int)
-
setTime
void setTime(String parameterName, Time value, int scale, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timevalue. The driver converts this to an SQLTIMEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valuescale- the scale of the columnforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
CallableStatement.getTime(int)
-
setDateTime
void setDateTime(String parameterName, Timestamp value) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLDATETIMEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter value- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setDateTime
void setDateTime(String parameterName, Timestamp value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLDATETIMEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setSmallDateTime
void setSmallDateTime(String parameterName, Timestamp value) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLSMALLDATETIMEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter value- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setSmallDateTime
void setSmallDateTime(String parameterName, Timestamp value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.sql.Timestampvalue. The driver converts this to an SQLSMALLDATETIMEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setUniqueIdentifier
void setUniqueIdentifier(String parameterName, String guid) throws SQLServerException
Sets the designated parameter to the givenStringvalue. The driver converts this to an SQLuniqueIdentifiervalue when it sends it to the database.- Parameters:
parameterName- the name of the parameterguid- the parameter value- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setUniqueIdentifier
void setUniqueIdentifier(String parameterName, String guid, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenStringvalue. The driver converts this to an SQLuniqueIdentifiervalue when it sends it to the database.- Parameters:
parameterName- the name of the parameterguid- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setBytes
void setBytes(String parameterName, byte[] value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Java array of bytes. The driver converts this to an SQLVARBINARYorLONGVARBINARY(depending on the argument's size relative to the driver's limits onVARBINARYvalues) when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setByte
void setByte(String parameterName, byte value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javabytevalue. The driver converts this to an SQLTINYINTvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setString
void setString(String parameterName, String value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given JavaStringvalue. The driver converts this to an SQLVARCHARorLONGVARCHARvalue (depending on the argument's size relative to the driver's limits onVARCHARvalues) when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setMoney
void setMoney(String parameterName, BigDecimal value) throws SQLServerException
Sets the designated parameter to the given Javajava.math.BigDecimalvalue. The driver converts this to an SQLMoneyvalue.- Parameters:
parameterName- the name of the parametervalue- the parameter value- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setMoney
void setMoney(String parameterName, BigDecimal value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javajava.math.BigDecimalvalue. The driver converts this to an SQLMoneyvalue.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setSmallMoney
void setSmallMoney(String parameterName, BigDecimal value) throws SQLServerException
Sets the designated parameter to the given Javajava.math.BigDecimalvalue. The driver converts this to an SQLsmallMoneyvalue.- Parameters:
parameterName- the name of the parametervalue- the parameter value- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setSmallMoney
void setSmallMoney(String parameterName, BigDecimal value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javajava.math.BigDecimalvalue. The driver converts this to an SQLsmallMoneyvalue.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal value, int precision, int scale) throws SQLServerException
Sets the designated parameter to the givenjava.math.BigDecimalvalue. The driver converts this to an SQLNUMERICvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueprecision- the precision of the columnscale- the scale of the column- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal value, int precision, int scale, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the givenjava.math.BigDecimalvalue. The driver converts this to an SQLNUMERICvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueprecision- the precision of the columnscale- the scale of the columnforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setDouble
void setDouble(String parameterName, double value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javadoublevalue. The driver converts this to an SQLDOUBLEvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setFloat
void setFloat(String parameterName, float value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javafloatvalue. The driver converts this to an SQLFLOATvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setInt
void setInt(String parameterName, int value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javaintvalue. The driver converts this to an SQLINTEGERvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setLong
void setLong(String parameterName, long value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javalongvalue. The driver converts this to an SQLBIGINTvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setShort
void setShort(String parameterName, short value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javashortvalue. The driver converts this to an SQLSMALLINTvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setBoolean
void setBoolean(String parameterName, boolean value, boolean forceEncrypt) throws SQLServerException
Sets the designated parameter to the given Javabooleanvalue. The driver converts this to an SQLBITorBOOLEANvalue when it sends it to the database.- Parameters:
parameterName- the name of the parametervalue- the parameter valueforceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement
-
setStructured
void setStructured(String parameterName, String tvpName, SQLServerDataTable tvpDataTable) throws SQLServerException
Populates a table valued parameter passed to a stored procedure with a data table.- Parameters:
parameterName- the name of the parametertvpName- the name of the type TVPtvpDataTable- the data table object- Throws:
SQLServerException- when an error occurs
-
setStructured
void setStructured(String parameterName, String tvpName, ResultSet tvpResultSet) throws SQLServerException
Populates a table valued parameter passed to a stored procedure with a ResultSet retrieved from another table- Parameters:
parameterName- the name of the parametertvpName- the name of the type TVPtvpResultSet- the source result set object- Throws:
SQLServerException- when an error occurs
-
setStructured
void setStructured(String parameterName, String tvpName, ISQLServerDataRecord tvpDataRecord) throws SQLServerException
Populates a table valued parameter passed to a stored procedure with an ISQLServerDataRecord object.- Parameters:
parameterName- the name of the parametertvpName- the name of the type TVPtvpDataRecord- ISQLServerDataRecord is used for streaming data and the user decides how to use it. tvpDataRecord is an ISQLServerDataRecord object.the source result set object- Throws:
SQLServerException- when an error occurs
-
registerOutParameter
void registerOutParameter(String parameterName, SQLType sqlType, int precision, int scale) throws SQLServerException
Registers the parameter in ordinal position index to be of JDBC type sqlType. All OUT parameters must be registered before a stored procedure is executed.The JDBC type specified by sqlType for an OUT parameter determines the Java type that must be used in the get method to read the value of that parameter.
- Parameters:
parameterName- the name of the parametersqlType- the JDBC type code defined by SQLType to use to register the OUT Parameter.precision- the sum of the desired number of digits to the left and right of the decimal point. It must be greater than or equal to zero.scale- the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLServerException- If any errors occur.
-
registerOutParameter
void registerOutParameter(int parameterIndex, SQLType sqlType, int precision, int scale) throws SQLServerExceptionRegisters the parameter in ordinal position index to be of JDBC type sqlType. All OUT parameters must be registered before a stored procedure is executed.The JDBC type specified by sqlType for an OUT parameter determines the Java type that must be used in the get method to read the value of that parameter.
- Parameters:
parameterIndex- the first column is 1, the second is 2, ...sqlType- the JDBC type code defined by SQLType to use to register the OUT Parameter.precision- the sum of the desired number of digits to the left and right of the decimal point. It must be greater than or equal to zero.scale- the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLServerException- If any errors occur.
-
registerOutParameter
void registerOutParameter(int parameterIndex, int sqlType, int precision, int scale) throws SQLServerExceptionRegisters the parameter in ordinal position index to be of JDBC type sqlType. All OUT parameters must be registered before a stored procedure is executed.The JDBC type specified by sqlType for an OUT parameter determines the Java type that must be used in the get method to read the value of that parameter.
- Parameters:
parameterIndex- the first column is 1, the second is 2, ...sqlType- the JDBC type code defined by SQLType to use to register the OUT Parameter.precision- the sum of the desired number of digits to the left and right of the decimal point. It must be greater than or equal to zero.scale- the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLServerException- If any errors occur.
-
registerOutParameter
void registerOutParameter(String parameterName, int sqlType, int precision, int scale) throws SQLServerException
Registers the parameter in ordinal position index to be of JDBC type sqlType. All OUT parameters must be registered before a stored procedure is executed.The JDBC type specified by sqlType for an OUT parameter determines the Java type that must be used in the get method to read the value of that parameter.
- Parameters:
parameterName- the name of the parametersqlType- the JDBC type code defined by SQLType to use to register the OUT Parameter.precision- the sum of the desired number of digits to the left and right of the decimal point. It must be greater than or equal to zero.scale- the desired number of digits to the right of the decimal point. It must be greater than or equal to zero.- Throws:
SQLServerException- If any errors occur.
-
setObject
void setObject(String parameterName, Object value, SQLType jdbcType, int scale, boolean forceEncrypt) throws SQLServerException
Sets the value of the designated parameter with the given object.The given Java object will be converted to the given targetSqlType before being sent to the database. If the object has a custom mapping (is of a class implementing the interface
SQLData), the JDBC driver should call the methodSQLData.writeSQLto write it to the SQL data stream. If, on the other hand, the object is of a class implementingRef,Blob,Clob,NClob,Struct,java.net.URL, orArray, the driver should pass it to the database as a value of the corresponding SQL type.Note that this method may be used to pass datatabase- specific abstract data types.
- Parameters:
parameterName- the name of the parametervalue- the object containing the input parameter valuejdbcType- the SQL type (as defined in java.sql.Types) to be sent to the database. The scale argument may further qualify this type.scale- the scale of the column.forceEncrypt- If the boolean forceEncrypt is set to true, the query parameter will only be set if the designation column is encrypted and Always Encrypted is enabled on the connection or on the statement. If the boolean forceEncrypt is set to false, the driver will not force encryption on parameters.- Throws:
SQLServerException- if parameterName does not correspond to a named parameter; if a database access error occurs or this method is called on a closedCallableStatement- See Also:
Types,CallableStatement.getObject(int)
-
-