Интерфейс CallableStatement

Все суперинтерфейсы:: AutoCloseable, PreparedStatement, Statement, Wrapper

public interface CallableStatement extends PreparedStatement

Интерфейс, используемый для выполнения SQL хранимых процедур. API JDBC предоставляет синтаксис SQL для хранимых процедур, который позволяет вызывать хранимые процедуры стандартным способом для всех СУБД. Этот синтаксис имеет одну форму, которая включает параметр результата, и одну, которая не включает его. Если используется, параметр результата должен быть зарегистрирован как параметр ВЫХОД. Другие параметры могут использоваться для ввода, вывода или обоих. Параметры нумеруются последовательно, начиная с 1.

   {?= call <procedure-name>[(<arg1>,<arg2>, ...)]}
   {call <procedure-name>[(<arg1>,<arg2>, ...)]}

Значения параметров ВВОД устанавливаются с помощью методов set, унаследованных от PreparedStatement. Тип всех параметров ВЫВОД должен быть зарегистрирован перед выполнением хранимой процедуры; их значения извлекаются после выполнения с помощью методов get, предоставленных здесь.

Хранимая процедура может возвращать один объект ResultSet или несколько объектов ResultSet. Несколько объектов ResultSet обрабатываются с помощью операций, унаследованных от Statement.

Для максимальной переносимости объекты вызова ResultSet и счётчики обновлений должны быть обработаны перед получением значений параметров вывода.

С:

1.1

См. также:

Краткое описание полей

Поля, объявленные в интерфейсе java.sql.Statement

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`Array`	`getArray(int parameterIndex)`	Возвращает значение указанного параметра JDBC `ARRAY` в виде объекта `Array` в языке программирования Java.
`Array`	`getArray(String parameterName)`	Возвращает значение параметра JDBC `ARRAY` в виде объекта `Array` в языке программирования Java.
`BigDecimal`	`getBigDecimal(int parameterIndex)`	Возвращает значение указанного параметра JDBC `NUMERIC` в виде объекта `java.math.BigDecimal` с количеством знаков после запятой, соответствующим количеству знаков в значении.
`BigDecimal`	`getBigDecimal(int parameterIndex, int scale)`	Устарело. Используйте `getBigDecimal(int parameterIndex)` или `getBigDecimal(String parameterName)`
`BigDecimal`	`getBigDecimal(String parameterName)`	Возвращает значение параметра JDBC `NUMERIC` в виде объекта `java.math.BigDecimal` с количеством знаков после запятой, соответствующим количеству знаков в значении.
`Blob`	`getBlob(int parameterIndex)`	Возвращает значение указанного параметра JDBC `BLOB` в виде объекта `Blob` в языке программирования Java.
`Blob`	`getBlob(String parameterName)`	Возвращает значение параметра JDBC `BLOB` в виде объекта `Blob` в языке программирования Java.
`boolean`	`getBoolean(int parameterIndex)`	Возвращает значение указанного параметра JDBC `BIT` или `BOOLEAN` в виде объекта `boolean` в языке программирования Java.
`boolean`	`getBoolean(String parameterName)`	Возвращает значение параметра JDBC `BIT` или `BOOLEAN` в виде объекта `boolean` в языке программирования Java.
`byte`	`getByte(int parameterIndex)`	Возвращает значение указанного параметра JDBC `TINYINT` в виде объекта `byte` в языке программирования Java.
`byte`	`getByte(String parameterName)`	Возвращает значение параметра JDBC `TINYINT` в виде объекта `byte` в языке программирования Java.
`byte[]`	`getBytes(int parameterIndex)`	Возвращает значение указанного параметра JDBC `BINARY` или `VARBINARY` в виде массива значений `byte` в языке программирования Java.
`byte[]`	`getBytes(String parameterName)`	Возвращает значение параметра JDBC `BINARY` или `VARBINARY` в виде массива значений `byte` в языке программирования Java.
`Reader`	`getCharacterStream(int parameterIndex)`	Возвращает значение указанного параметра в виде объекта `java.io.Reader` в языке программирования Java.
`Reader`	`getCharacterStream(String parameterName)`	Возвращает значение указанного параметра в виде объекта `java.io.Reader` в языке программирования Java.
`Clob`	`getClob(int parameterIndex)`	Возвращает значение указанного параметра JDBC `CLOB` в виде объекта `java.sql.Clob` в языке программирования Java.
`Clob`	`getClob(String parameterName)`	Возвращает значение параметра JDBC `CLOB` в виде объекта `java.sql.Clob` в языке программирования Java.
`Date`	`getDate(int parameterIndex)`	Возвращает значение указанного параметра JDBC `DATE` в виде объекта `java.sql.Date`.
`Date`	`getDate(int parameterIndex, Calendar cal)`	Возвращает значение указанного параметра JDBC `DATE` в виде объекта `java.sql.Date`, используя заданный объект `Calendar` для создания даты.
`Date`	`getDate(String parameterName)`	Возвращает значение параметра JDBC `DATE` в виде объекта `java.sql.Date`.
`Date`	`getDate(String parameterName, Calendar cal)`	Возвращает значение параметра JDBC `DATE` в виде объекта `java.sql.Date`, используя заданный объект `Calendar` для создания даты.
`double`	`getDouble(int parameterIndex)`	Возвращает значение указанного параметра JDBC `DOUBLE` в виде `double` в языке программирования Java.
`double`	`getDouble(String parameterName)`	Возвращает значение параметра JDBC `DOUBLE` в виде `double` в языке программирования Java.
`float`	`getFloat(int parameterIndex)`	Возвращает значение указанного параметра JDBC `FLOAT` в виде `float` в языке программирования Java.
`float`	`getFloat(String parameterName)`	Возвращает значение параметра JDBC `FLOAT` в виде `float` в языке программирования Java.
`int`	`getInt(int parameterIndex)`	Возвращает значение указанного параметра JDBC `INTEGER` в виде `int` в языке программирования Java.
`int`	`getInt(String parameterName)`	Возвращает значение параметра JDBC `INTEGER` в виде `int` в языке программирования Java.
`long`	`getLong(int parameterIndex)`	Возвращает значение указанного параметра JDBC `BIGINT` в виде `long` в языке программирования Java.
`long`	`getLong(String parameterName)`	Возвращает значение параметра JDBC `BIGINT` в виде `long` в языке программирования Java.
`Reader`	`getNCharacterStream(int parameterIndex)`	Возвращает значение указанного параметра в виде объекта `java.io.Reader` в языке программирования Java.
`Reader`	`getNCharacterStream(String parameterName)`	Возвращает значение указанного параметра в виде объекта `java.io.Reader` в языке программирования Java.
`NClob`	`getNClob(int parameterIndex)`	Возвращает значение указанного параметра JDBC `NCLOB` в виде объекта `java.sql.NClob` в языке программирования Java.
`NClob`	`getNClob(String parameterName)`	Возвращает значение параметра JDBC `NCLOB` в виде объекта `java.sql.NClob` в языке программирования Java.
`String`	`getNString(int parameterIndex)`	Возвращает значение указанного параметра `NCHAR`, `NVARCHAR` или `LONGNVARCHAR` в виде `String` в языке программирования Java.
`String`	`getNString(String parameterName)`	Возвращает значение указанного параметра `NCHAR`, `NVARCHAR` или `LONGNVARCHAR` в виде `String` в языке программирования Java.
`Object`	`getObject(int parameterIndex)`	Возвращает объект, представляющий значение параметра OUT `parameterIndex`, и преобразует его из SQL типа в запрашиваемый тип Java, если преобразование поддерживается.
`Object`	`getObject(int parameterIndex, Map<String,Class<?>> map)`	Возвращает объект, представляющий значение параметра OUT `parameterIndex` и использует `map` для пользовательского отображения значения параметра.
`Object`	`getObject(String parameterName)`	Возвращает значение параметра в виде `Object` в языке программирования Java.
`<T> T`	`getObject(String parameterName, Class<T> type)`	Возвращает объект, представляющий значение параметра OUT `parameterName`, и преобразует его из SQL типа в запрашиваемый тип Java, если преобразование поддерживается.
`Object`	`getObject(String parameterName, Map<String,Class<?>> map)`	Возвращает объект, представляющий значение параметра OUT `parameterName` и использует `map` для пользовательского отображения значения параметра.
`Ref`	`getRef(int parameterIndex)`	Возвращает значение указанного параметра JDBC `REF(<structured-type>)` в виде объекта `Ref` в языке программирования Java.

`Ref`	`getRef(String parameterName)`	Получает значение параметра JDBC `REF(<structured-type>)` в качестве объекта `Ref` в языке программирования Java.
`RowId`	`getRowId(int parameterIndex)`	Получает значение указанного параметра JDBC `ROWID` в качестве объекта `java.sql.RowId`.
`RowId`	`getRowId(String parameterName)`	Получает значение указанного параметра JDBC `ROWID` в качестве объекта `java.sql.RowId`.
`short`	`getShort(int parameterIndex)`	Получает значение указанного параметра JDBC `SMALLINT` в качестве объекта `short` в языке программирования Java.
`short`	`getShort(String parameterName)`	Получает значение параметра JDBC `SMALLINT` в качестве объекта `short` в языке программирования Java.
`SQLXML`	`getSQLXML(int parameterIndex)`	Получает значение указанного параметра `SQL XML` в качестве объекта `java.sql.SQLXML` в языке программирования Java.
`SQLXML`	`getSQLXML(String parameterName)`	Получает значение указанного параметра `SQL XML` в качестве объекта `java.sql.SQLXML` в языке программирования Java.
`String`	`getString(int parameterIndex)`	Получает значение указанного параметра JDBC `CHAR`, `VARCHAR` или `LONGVARCHAR` в качестве объекта `String` в языке программирования Java.
`String`	`getString(String parameterName)`	Получает значение параметра JDBC `CHAR`, `VARCHAR` или `LONGVARCHAR` в качестве объекта `String` в языке программирования Java.
`Time`	`getTime(int parameterIndex)`	Получает значение указанного параметра JDBC `TIME` в качестве объекта `java.sql.Time`.
`Time`	`getTime(int parameterIndex, Calendar cal)`	Получает значение указанного параметра JDBC `TIME` в качестве объекта `java.sql.Time`, используя предоставленный объект `Calendar` для построения времени.
`Time`	`getTime(String parameterName)`	Получает значение параметра JDBC `TIME` в качестве объекта `java.sql.Time`.
`Time`	`getTime(String parameterName, Calendar cal)`	Получает значение параметра JDBC `TIME` в качестве объекта `java.sql.Time`, используя предоставленный объект `Calendar` для построения времени.
`Timestamp`	`getTimestamp(int parameterIndex)`	Получает значение указанного параметра JDBC `TIMESTAMP` в качестве объекта `java.sql.Timestamp`.
`Timestamp`	`getTimestamp(int parameterIndex, Calendar cal)`	Получает значение указанного параметра JDBC `TIMESTAMP` в качестве объекта `java.sql.Timestamp`, используя предоставленный объект `Calendar` для построения объекта `Timestamp`.
`Timestamp`	`getTimestamp(String parameterName)`	Получает значение параметра JDBC `TIMESTAMP` в качестве объекта `java.sql.Timestamp`.
`Timestamp`	`getTimestamp(String parameterName, Calendar cal)`	Получает значение параметра JDBC `TIMESTAMP` в качестве объекта `java.sql.Timestamp`, используя предоставленный объект `Calendar` для построения объекта `Timestamp`.
`URL`	`getURL(int parameterIndex)`	Получает значение указанного параметра JDBC `DATALINK` в качестве объекта `java.net.URL`.
`URL`	`getURL(String parameterName)`	Получает значение параметра JDBC `DATALINK` в качестве объекта `java.net.URL`.
`void`	`registerOutParameter(int parameterIndex, int sqlType)`	Регистрирует параметр OUT в порядковом положении `parameterIndex` с типом JDBC `sqlType`.
`void`	`registerOutParameter(int parameterIndex, int sqlType, int scale)`	Регистрирует параметр в порядковом положении `parameterIndex` с типом JDBC `sqlType`.
`void`	`registerOutParameter(int parameterIndex, int sqlType, String typeName)`	Регистрирует указанный выходной параметр.
`default void`	`registerOutParameter(int parameterIndex, SQLType sqlType)`	Регистрирует параметр OUT в порядковом положении `parameterIndex` с типом JDBC `sqlType`.
`default void`	`registerOutParameter(int parameterIndex, SQLType sqlType, int scale)`	Регистрирует параметр в порядковом положении `parameterIndex` с типом JDBC `sqlType`.
`default void`	`registerOutParameter(int parameterIndex, SQLType sqlType, String typeName)`	Регистрирует указанный выходной параметр.
`void`	`registerOutParameter(String parameterName, int sqlType)`	Регистрирует параметр OUT с именем `parameterName` с типом JDBC `sqlType`.
`void`	`registerOutParameter(String parameterName, int sqlType, int scale)`	Регистрирует параметр с именем `parameterName` с типом JDBC `sqlType`.
`void`	`registerOutParameter(String parameterName, int sqlType, String typeName)`	Регистрирует указанный выходной параметр.
`default void`	`registerOutParameter(String parameterName, SQLType sqlType)`	Регистрирует параметр OUT с именем `parameterName` с типом JDBC `sqlType`.
`default void`	`registerOutParameter(String parameterName, SQLType sqlType, int scale)`	Регистрирует параметр с именем `parameterName` с типом JDBC `sqlType`.
`default void`	`registerOutParameter(String parameterName, SQLType sqlType, String typeName)`	Регистрирует указанный выходной параметр.
`void`	`setAsciiStream(String parameterName, InputStream x)`	Устанавливает указанный параметр в задаваемый входной поток.
`void`	`setAsciiStream(String parameterName, InputStream x, int length)`	Устанавливает указанный параметр в задаваемый входной поток, который будет иметь указанное количество байтов.
`void`	`setAsciiStream(String parameterName, InputStream x, long length)`	Устанавливает указанный параметр в задаваемый входной поток, который будет иметь указанное количество байтов.
`void`	`setBigDecimal(String parameterName, BigDecimal x)`	Устанавливает указанный параметр в задаваемое значение `java.math.BigDecimal`.
`void`	`setBinaryStream(String parameterName, InputStream x)`	Устанавливает указанный параметр в задаваемый входной поток.
`void`	`setBinaryStream(String parameterName, InputStream x, int length)`	Устанавливает указанный параметр в задаваемый входной поток, который будет иметь указанное количество байтов.
`void`	`setBinaryStream(String parameterName, InputStream x, long length)`	Устанавливает указанный параметр в задаваемый входной поток, который будет иметь указанное количество байтов.
`void`	`setBlob(String parameterName, InputStream inputStream)`	Устанавливает указанный параметр в объект `InputStream`.
`void`	`setBlob(String parameterName, InputStream inputStream, long length)`	Устанавливает указанный параметр в объект `InputStream`.
`void`	`setBlob(String parameterName, Blob x)`	Устанавливает указанный параметр в задаваемый объект `java.sql.Blob`.
`void`	`setBoolean(String parameterName, boolean x)`	Устанавливает указанный параметр в задаваемое значение Java `boolean`.
`void`	`setByte(String parameterName, byte x)`	Устанавливает указанный параметр в задаваемое значение Java `byte`.
`void`	`setBytes(String parameterName, byte[] x)`	Устанавливает указанный параметр в задаваемый массив байтов Java.
`void`	`setCharacterStream(String parameterName, Reader reader)`	Устанавливает указанный параметр в задаваемый объект `Reader`.
`void`	`setCharacterStream(String parameterName, Reader reader, int length)`	Устанавливает указанный параметр в задаваемый объект `Reader`, длина которого задается.
`void`	`setCharacterStream(String parameterName, Reader reader, long length)`	Устанавливает указанный параметр в задаваемый объект `Reader`, длина которого задается.
`void`	`setClob(String parameterName, Reader reader)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setClob(String parameterName, Reader reader, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setClob(String parameterName, Clob x)`	Устанавливает указанный параметр в задаваемый объект `java.sql.Clob`.

END_OF_DOCUMENT_MARKER

`void`	`setDate(String parameterName, Date x)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`, используя часовой пояс виртуальной машины, на которой выполняется приложение.
`void`	`setDate(String parameterName, Date x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`, используя заданный объект `Calendar`.
`void`	`setDouble(String parameterName, double x)`	Устанавливает указанный параметр в заданное значение Java `double`.
`void`	`setFloat(String parameterName, float x)`	Устанавливает указанный параметр в заданное значение Java `float`.
`void`	`setInt(String parameterName, int x)`	Устанавливает указанный параметр в заданное значение Java `int`.
`void`	`setLong(String parameterName, long x)`	Устанавливает указанный параметр в заданное значение Java `long`.
`void`	`setNCharacterStream(String parameterName, Reader value)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNCharacterStream(String parameterName, Reader value, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(String parameterName, Reader reader)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(String parameterName, Reader reader, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(String parameterName, NClob value)`	Устанавливает указанный параметр в объект `java.sql.NClob`.
`void`	`setNString(String parameterName, String value)`	Устанавливает указанный параметр в заданный объект `String`.
`void`	`setNull(String parameterName, int sqlType)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setNull(String parameterName, int sqlType, String typeName)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setObject(String parameterName, Object x)`	Устанавливает значение указанного параметра заданным объектом.
`void`	`setObject(String parameterName, Object x, int targetSqlType)`	Устанавливает значение указанного параметра заданным объектом.
`void`	`setObject(String parameterName, Object x, int targetSqlType, int scale)`	Устанавливает значение указанного параметра заданным объектом.
`default void`	`setObject(String parameterName, Object x, SQLType targetSqlType)`	Устанавливает значение указанного параметра заданным объектом.
`default void`	`setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength)`	Устанавливает значение указанного параметра заданным объектом.
`void`	`setRowId(String parameterName, RowId x)`	Устанавливает указанный параметр в заданный объект `java.sql.RowId`.
`void`	`setShort(String parameterName, short x)`	Устанавливает указанный параметр в заданное значение Java `short`.
`void`	`setSQLXML(String parameterName, SQLXML xmlObject)`	Устанавливает указанный параметр в заданный объект `java.sql.SQLXML`.
`void`	`setString(String parameterName, String x)`	Устанавливает указанный параметр в заданное значение Java `String`.
`void`	`setTime(String parameterName, Time x)`	Устанавливает указанный параметр в заданное значение `java.sql.Time`.
`void`	`setTime(String parameterName, Time x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Time`, используя заданный объект `Calendar`.
`void`	`setTimestamp(String parameterName, Timestamp x)`	Устанавливает указанный параметр в заданное значение `java.sql.Timestamp`.
`void`	`setTimestamp(String parameterName, Timestamp x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Timestamp`, используя заданный объект `Calendar`.
`void`	`setURL(String parameterName, URL val)`	Возвращает, имело ли значение последнего параметра OUT значение SQL `NULL`.

Методы, объявленные в интерфейсе 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

Методы, объявленные в интерфейсе 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

Методы, объявленные в интерфейсе java.sql.Wrapper

isWrapperFor, unwrap

Подробности методов

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

Регистрирует параметр ВЫХОД parameterIndex с порядковым номером parameterIndex в типе JDBC sqlType. Все параметры ВЫХОД должны быть зарегистрированы перед выполнением хранимой процедуры.

Тип JDBC, заданный sqlType для параметра ВЫХОД, определяет тип Java, который должен использоваться в методе get для чтения значения этого параметра.

Если тип JDBC, ожидаемый в качестве возвращаемого значения для этого выходного параметра, специфичен для конкретной базы данных, то sqlType должен быть java.sql.Types.OTHER. Метод getObject(int) извлекает значение.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

sqlType - код типа JDBC, определённый в java.sql.Types. Если параметр имеет тип JDBC NUMERIC или DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.

Исключения:

SQLException - если индекс параметра некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, и драйвер JDBC не поддерживает этот тип данных

См. также:

registerOutParameter

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

Регистрирует параметр с порядковым номером parameterIndex в качестве параметра JDBC типа sqlType. Все параметры ВЫХОД должны быть зарегистрированы перед выполнением хранимой процедуры.

Эта версия registerOutParameter должна использоваться, когда параметр имеет тип JDBC NUMERIC или DECIMAL.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

sqlType - код типа SQL, определенный в java.sql.Types.

scale - требуемое количество цифр после запятой. Должно быть больше или равно нулю.

Исключения:

См. также:

wasNull

boolean wasNull() throws SQLException

Определяет, было ли значение последнего параметра ВЫХОД равно SQL NULL. Обратите внимание, что этот метод должен вызываться только после вызова метода-получателя; в противном случае нет значения для определения, является ли оно null или нет.

Возвращаемое значение:: true, если последнее прочитанное значение было SQL NULL; false в противном случае
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement

getString

String getString(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра CHAR, VARCHAR или LONGVARCHAR в качестве строки String на языке программирования Java.

Для фиксированного типа JDBC CHAR, возвращаемый объект String имеет ровно такое же значение, как и SQL CHAR значение в базе данных, включая любые добавления заполнения, добавленные базой данных.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - null.

Исключения:

См. также:

getBoolean

boolean getBoolean(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра BIT или BOOLEAN в качестве булевого значения boolean на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - false.

Исключения:

См. также:

getByte

byte getByte(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра TINYINT в качестве байта byte на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - 0.

Исключения:

См. также:

getShort

short getShort(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра SMALLINT в качестве короткого целого short на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - 0.

Исключения:

См. также:

getInt

int getInt(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра INTEGER в качестве целого числа int на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - 0.

Исключения:

См. также:

getLong

long getLong(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра BIGINT в качестве длинного целого long на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - 0.

Исключения:

См. также:

getFloat

float getFloat(int parameterIndex) throws SQLException

Возвращает значение заданного JDBC параметра FLOAT в качестве числа с плавающей точкой float на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

Возвращаемое значение:

значение параметра. Если значение равно SQL NULL, результат - 0.

Исключения:

См. также:

END_OF_DOCUMENT_MARKER

getDouble

double getDouble(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC DOUBLE в виде значения типа double на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

значение параметра. Если значение является SQL NULL, результат — 0.

Изначает:

SQLException - если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом CallableStatement

См. также:

getBigDecimal

@Deprecated(since="1.2") BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException

Устаревший.

используйте getBigDecimal(int parameterIndex) или getBigDecimal(String parameterName)

Извлекает значение указанного параметра JDBC NUMERIC в виде объекта java.math.BigDecimal с scale знаками после десятичной точки.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

scale - количество знаков после десятичной точки

Возвращает:

значение параметра. Если значение является SQL NULL, результат — null.

Изначает:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

См. также:

getBytes

byte[] getBytes(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC BINARY или VARBINARY в виде массива значений типа byte на языке программирования Java.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

значение параметра. Если значение является SQL NULL, результат — null.

Изначает:

См. также:

getDate

Date getDate(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC DATE в виде объекта типа java.sql.Date.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

значение параметра. Если значение является SQL NULL, результат — null.

Изначает:

См. также:

getTime

Time getTime(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC TIME в виде объекта типа java.sql.Time.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

значение параметра. Если значение является SQL NULL, результат — null.

Изначает:

См. также:

getTimestamp

Timestamp getTimestamp(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC TIMESTAMP в виде объекта типа java.sql.Timestamp.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

значение параметра. Если значение является SQL NULL, результат — null.

Изначает:

См. также:

getObject

Object getObject(int parameterIndex) throws SQLException

Извлекает значение указанного параметра в виде Object на языке программирования Java. Если значение является SQL NULL, драйвер возвращает Java null.

Этот метод возвращает объект Java, тип которого соответствует типу JDBC, зарегистрированному для этого параметра с помощью метода registerOutParameter. Регистрируя целевой тип JDBC как java.sql.Types.OTHER, этот метод можно использовать для чтения абстрактных типов данных, специфичных для базы данных.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

Объект java.lang.Object, содержащий значение параметра OUT

Изначает:

См. также:

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC NUMERIC в виде объекта java.math.BigDecimal с количеством знаков после запятой, соответствующим значению.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

Возвращает:

значение параметра с полной точностью. Если значение является SQL NULL, результат — null.

Изначает:

С:

1.2

См. также:

getObject

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

Возвращает объект, представляющий значение параметра OUT parameterIndex, и использует map для пользовательского сопоставления значения параметра.

Параметры:

parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее

map - сопоставление имен SQL типов с классами Java

Возвращает:

объект java.lang.Object, содержащий значение параметра OUT

Изначает:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.2

См. также:

getRef

Ref getRef(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC REF(<structured-type>) в виде объекта Ref на языке программирования Java.

Параметры:: parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее
Возвращает:: значение параметра в виде объекта Ref на языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Изначает:: SQLException - если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.2

getBlob

Blob getBlob(int parameterIndex) throws SQLException

Извлекает значение указанного параметра JDBC BLOB в виде объекта Blob на языке программирования Java.

Параметры:: parameterIndex - первый параметр имеет значение 1, второй — 2 и так далее
Возвращает:: значение параметра в виде объекта Blob на языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Изначает:: SQLException - если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.2

getClob

Clob getClob(int parameterIndex) throws SQLException

Извлекает значение указанного JDBC параметра как объект java.sql.Clob языка программирования Java.

Параметры:: parameterIndex - первый параметр — 1, второй — 2 и так далее
Возвращает:: значение параметра как объект Clob языка программирования Java. Если значение было SQL NULL, возвращается значение null.
Выбрасывает:: SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С момента:: 1.2

getArray

Array getArray(int parameterIndex) throws SQLException

Извлекает значение указанного JDBC параметра как объект Array языка программирования Java.

Параметры:: parameterIndex - первый параметр — 1, второй — 2 и так далее
Возвращает:: значение параметра как объект Array языка программирования Java. Если значение было SQL NULL, возвращается значение null.
Выбрасывает:: SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С момента:: 1.2

getDate

Date getDate(int parameterIndex, Calendar cal) throws SQLException

Извлекает значение указанного JDBC параметра как объект java.sql.Date, используя предоставленный объект Calendar для построения даты. С объектом Calendar драйвер может рассчитать дату с учётом пользовательской временной зоны и локали. Если объект Calendar не указан, драйвер использует стандартную временную зону и локаль.

Параметры:

parameterIndex - первый параметр — 1, второй — 2 и так далее

cal - объект Calendar, который драйвер будет использовать для построения даты

Возвращает:

значение параметра. Если значение SQL NULL, результатом является null.

Выбрасывает:

SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

С момента:

1.2

См. также:

getTime

Time getTime(int parameterIndex, Calendar cal) throws SQLException

Извлекает значение указанного JDBC параметра как объект java.sql.Time, используя предоставленный объект Calendar для построения времени. С объектом Calendar драйвер может рассчитать время с учётом пользовательской временной зоны и локали. Если объект Calendar не указан, драйвер использует стандартную временную зону и локаль.

Параметры:

parameterIndex - первый параметр — 1, второй — 2 и так далее

cal - объект Calendar, который драйвер будет использовать для построения времени

Возвращает:

значение параметра; если значение SQL NULL, результатом является null.

Выбрасывает:

С момента:

1.2

См. также:

getTimestamp

Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException

Извлекает значение указанного JDBC параметра как объект java.sql.Timestamp, используя предоставленный объект Calendar для построения объекта Timestamp. С объектом Calendar драйвер может рассчитать метку времени с учётом пользовательской временной зоны и локали. Если объект Calendar не указан, драйвер использует стандартную временную зону и локаль.

Параметры:

parameterIndex - первый параметр — 1, второй — 2 и так далее

cal - объект Calendar, который драйвер будет использовать для построения метки времени

Возвращает:

значение параметра. Если значение SQL NULL, результатом является null.

Выбрасывает:

С момента:

1.2

См. также:

registerOutParameter

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

Регистрирует указанный параметр вывода. Этот вариант метода registerOutParameter следует использовать для параметра вывода пользовательского или REF типа. Примеры пользовательских типов включают: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Все параметры ВЫВОДА должны быть зарегистрированы перед выполнением хранимой процедуры.

Для параметра пользовательского типа также должно быть указано полное квалифицированное имя SQL типа параметра, а для параметра REF - полное квалифицированное имя типа, на который он ссылается. JDBC драйвер, которому не нужна информация о коде типа и имени типа, может ее игнорировать. Однако для обеспечения переносимости приложения всегда должны предоставлять эти значения для параметров пользовательского и REF типов. Хотя он предназначен для параметров пользовательского и REF типов, этот метод может использоваться для регистрации параметра любого JDBC типа. Если параметр не имеет пользовательского или REF типа, параметр typeName игнорируется.

Примечание: При чтении значения параметра вывода необходимо использовать метод получения, соответствующий Java типу зарегистрированного SQL типа параметра.

Параметры:

parameterIndex - первый параметр — 1, второй — 2,...

sqlType - значение из Types

typeName - полное квалифицированное имя SQL структурированного типа

Выбрасывает:

SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, и JDBC драйвер не поддерживает этот тип данных

С момента:

1.2

См. также:

registerOutParameter

void registerOutParameter(String parameterName, int sqlType) throws SQLException

Регистрирует параметр ВЫВОДА с именем parameterName JDBC типа sqlType. Все параметры ВЫВОДА должны быть зарегистрированы перед выполнением хранимой процедуры.

JDBC тип, заданный sqlType для параметра ВЫВОДА, определяет Java тип, который должен использоваться в методе get для чтения значения этого параметра.

Если ожидаемый JDBC тип, возвращаемый этому параметру вывода, специфичен для данной базы данных, sqlType должен быть java.sql.Types.OTHER. Метод getObject(int) извлекает значение.

Параметры:

parameterName - имя параметра

sqlType - код JDBC типа, определенный java.sql.Types. Если параметр имеет JDBC тип NUMERIC или DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.

Выбрасывает:

SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, и JDBC драйвер не поддерживает этот тип данных, или если JDBC драйвер не поддерживает этот метод

С момента:

1.4

См. также:

registerOutParameter

void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException

Регистрирует параметр с именем parameterName как параметр JDBC типа sqlType. Все выходные параметры должны быть зарегистрированы перед выполнением хранимой процедуры.

Тип JDBC, указанный в sqlType для выходного параметра, определяет тип Java, который должен использоваться в методе get для чтения значения этого параметра.

Эта версия registerOutParameter должна использоваться, когда параметр имеет тип JDBC NUMERIC или DECIMAL.

Parameters:

parameterName - имя параметра

sqlType - код типа SQL, определённый в java.sql.Types.

scale - желаемое количество знаков после запятой. Оно должно быть больше или равно нулю.

Throws:

SQLFeatureNotSupportedException - если sqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных, или если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

registerOutParameter

void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException

Регистрирует указанный выходной параметр. Эта версия метода registerOutParameter должна использоваться для выходного параметра с пользовательским именем или REF. Примеры типов с пользовательским именем: STRUCT, DISTINCT, JAVA_OBJECT и именованные массивы.

Все выходные параметры должны быть зарегистрированы перед выполнением хранимой процедуры.

Для параметра с пользовательским именем должно быть указано полное квалифицированное имя типа SQL параметра, а для параметра REF - полное квалифицированное имя типа ссылаемого типа. Драйвер JDBC, не нуждающийся в информации о коде типа и имени типа, может ее проигнорировать. Однако для обеспечения переносимости приложения должны всегда предоставлять эти значения для параметров с пользовательским именем и REF. Хотя она предназначена для параметров с пользовательским именем и REF, этот метод может использоваться для регистрации параметра любого типа JDBC. Если параметр не имеет типа с пользовательским именем или REF, параметр typeName игнорируется.

Примечание: При чтении значения выходного параметра необходимо использовать метод getXXX, тип Java XXX которого соответствует зарегистрированному типу SQL параметра.

Parameters:

parameterName - имя параметра

sqlType - значение из Types

typeName - полное квалифицированное имя структурированного типа SQL

Throws:

Since:

1.4

See Also:

getURL

URL getURL(int parameterIndex) throws SQLException

Возвращает значение указанного параметра JDBC DATALINK как объект java.net.URL.

Parameters:

parameterIndex - первый параметр - 1, второй - 2,...

Returns:

объект java.net.URL, представляющий значение JDBC DATALINK, используемое в качестве указанного параметра

Throws:

SQLException - если parameterIndex некорректен; если произошла ошибка доступа к базе данных, этот метод вызван для закрытого CallableStatement или если возвращаемый URL не является допустимым URL на платформе Java

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

setURL

void setURL(String parameterName, URL val) throws SQLException

Устанавливает указанный параметр в объект java.net.URL. Драйвер преобразует его в значение SQL DATALINK при отправке в базу данных.

Parameters:

parameterName - имя параметра

val - значение параметра

Throws:

SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого CallableStatement или если URL некорректен

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

setNull

void setNull(String parameterName, int sqlType) throws SQLException

Устанавливает указанный параметр в SQL NULL.

Примечание: Необходимо указать тип SQL параметра.

Parameters:: parameterName - имя параметра; sqlType - код типа SQL, определённый в java.sql.Types
Throws:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.4

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

Устанавливает указанный параметр в заданное значение Java boolean. Драйвер преобразует его в значение SQL BIT или BOOLEAN при отправке в базу данных.

Parameters:

parameterName - имя параметра

x - значение параметра

Throws:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

setByte

void setByte(String parameterName, byte x) throws SQLException

Устанавливает указанный параметр в заданное значение Java byte. Драйвер преобразует его в значение SQL TINYINT при отправке в базу данных.

Parameters:

parameterName - имя параметра

x - значение параметра

Throws:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

setShort

void setShort(String parameterName, short x) throws SQLException

Устанавливает указанный параметр в заданное значение Java short. Драйвер преобразует его в значение SQL SMALLINT при отправке в базу данных.

Parameters:

parameterName - имя параметра

x - значение параметра

Throws:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

setInt

void setInt(String parameterName, int x) throws SQLException

Устанавливает указанный параметр в заданное значение Java int. Драйвер преобразует его в значение SQL INTEGER при отправке в базу данных.

Parameters:

parameterName - имя параметра

x - значение параметра

Throws:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

Since:

1.4

See Also:

setLong

void setLong(String parameterName, long x) throws SQLException

Устанавливает указанный параметр в заданное значение Java long. Драйвер преобразует его в значение SQL BIGINT при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setFloat

void setFloat(String parameterName, float x) throws SQLException

Устанавливает указанный параметр в заданное значение Java float. Драйвер преобразует его в значение SQL FLOAT при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setDouble

void setDouble(String parameterName, double x) throws SQLException

Устанавливает указанный параметр в заданное значение Java double. Драйвер преобразует его в значение SQL DOUBLE при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

Устанавливает указанный параметр в заданное значение java.math.BigDecimal. Драйвер преобразует его в значение SQL NUMERIC при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setString

void setString(String parameterName, String x) throws SQLException

Устанавливает указанный параметр в заданное значение Java String. Драйвер преобразует его в значение SQL VARCHAR или LONGVARCHAR (в зависимости от размера аргумента по отношению к ограничениям драйвера на VARCHAR значения) при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setBytes

void setBytes(String parameterName, byte[] x) throws SQLException

Устанавливает указанный параметр в заданный массив байтов Java. Драйвер преобразует его в значение SQL VARBINARY или LONGVARBINARY (в зависимости от размера аргумента относительно ограничений драйвера на VARBINARY значения) при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setDate

void setDate(String parameterName, Date x) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Date, используя по умолчанию часовой пояс виртуальной машины, на которой выполняется приложение. Драйвер преобразует его в значение SQL DATE при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setTime

void setTime(String parameterName, Time x) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Time. Драйвер преобразует его в значение SQL TIME при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Timestamp. Драйвер преобразует его в значение SQL TIMESTAMP при отправке в базу данных.

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

setAsciiStream

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

Устанавливает указанный параметр в заданный входной поток, который будет иметь указанное количество байтов. При вводе очень большого ASCII значения в параметр LONGVARCHAR, может быть более практичным отправить его через java.io.InputStream. Данные будут читаться из потока по мере необходимости до достижения конца файла. JDBC драйвер выполнит необходимое преобразование из ASCII в формат char базы данных.

Примечание: Этот объект потока может быть стандартным объектом Java потока или собственным подклассом, реализующим стандартный интерфейс.

Параметры:: parameterName - имя параметра; x - входной поток Java, содержащий значение ASCII параметра; length - количество байтов в потоке
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4

setBinaryStream

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

Устанавливает указанный параметр в указанный входной поток, который будет иметь указанное количество байтов. При вводе очень большого двоичного значения в параметр LONGVARBINARY, может быть более практичным отправить его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим собственным подклассом, реализующим стандартный интерфейс.

Параметры:: parameterName - имя параметра; x - поток ввода Java, содержащий двоичное значение параметра; length - количество байтов в потоке
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.4

setObject

void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта.

Данный объект Java будет преобразован в заданный targetSqlType перед отправкой в базу данных. Если объект имеет пользовательское отображение (является классом, реализующим интерфейс SQLData), JDBC-драйвер должен вызвать метод SQLData.writeSQL для записи в поток данных SQL. Если, с другой стороны, объект является классом, реализующим интерфейсы Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных в качестве значения соответствующего типа SQL.

Обратите внимание, что этот метод может использоваться для передачи абстрактных типов данных, специфичных для базы данных.

Параметры:

parameterName - имя параметра

x - объект, содержащий значение входного параметра

targetSqlType - тип SQL (как определено в java.sql.Types), который будет отправлен в базу данных. Аргумент scale может дополнительно уточнить этот тип.

scale - для типов java.sql.Types.DECIMAL или java.sql.Types.NUMERIC это количество цифр после запятой. Для всех других типов это значение будет проигнорировано.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType

С:

1.4

См. также:

setObject

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта. Этот метод похож на setObject(String parameterName, Object x, int targetSqlType, int scaleOrLength), за исключением того, что он предполагает масштаб ноль.

Параметры:

parameterName - имя параметра

x - объект, содержащий значение входного параметра

targetSqlType - тип SQL (как определено в java.sql.Types), который будет отправлен в базу данных

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType

С:

1.4

См. также:

setObject

void setObject(String parameterName, Object x) throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта.

Спецификация JDBC определяет стандартное отображение типов Java Object в типы SQL. Переданный аргумент будет преобразован в соответствующий тип SQL перед отправкой в базу данных.

Обратите внимание, что этот метод может использоваться для передачи абстрактных типов данных, специфичных для базы данных, используя тип Java, специфичный для драйвера. Если объект является классом, реализующим интерфейс SQLData, JDBC-драйвер должен вызвать метод SQLData.writeSQL для записи в поток данных SQL. Если, с другой стороны, объект является классом, реализующим интерфейсы Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных в качестве значения соответствующего типа SQL.

Этот метод генерирует исключение, если существует неоднозначность, например, если объект является классом, реализующим более одного из упомянутых выше интерфейсов.

Примечание: Не все базы данных позволяют отправлять нетипизированный Null на бэкенд. Для максимальной переносимости следует использовать метод setNull или setObject(String parameterName, Object x, int sqlType) вместо setObject(String parameterName, Object x).

Параметры:

parameterName - имя параметра

x - объект, содержащий значение входного параметра

Исключения:

SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных, этот метод вызван для закрытого CallableStatement или если заданный Object параметр неоднозначен

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

setCharacterStream

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

Устанавливает указанный параметр в указанный объект потока символов, длина которого равна указанному количеству символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более практичным отправить его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. JDBC-драйвер произведет необходимый перевод из UNICODE в формат символов базы данных.

Параметры:: parameterName - имя параметра; reader - объект потока символов, содержащий данные UNICODE, используемые в качестве указанного параметра; length - количество символов в потоке
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.4

setDate

void setDate(String parameterName, Date x, Calendar cal) throws SQLException

Устанавливает указанный параметр в указанное значение даты, используя указанный объект Calendar. Драйвер использует объект Calendar для построения значения SQL DATE, которое затем отправляет в базу данных. С объектом Calendar драйвер может рассчитать дату с учетом пользовательской часовой зоны. Если объект Calendar не указан, драйвер использует по умолчанию часовую зону виртуальной машины, на которой выполняется приложение.

Параметры:

parameterName - имя параметра

x - значение параметра

cal - объект Calendar, который драйвер будет использовать для построения даты

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

setTime

void setTime(String parameterName, Time x, Calendar cal) throws SQLException

Устанавливает указанный параметр в указанное значение времени, используя указанный объект Calendar. Драйвер использует объект Calendar для построения значения SQL TIME, которое затем отправляет в базу данных. С объектом Calendar драйвер может рассчитать время с учетом пользовательской часовой зоны. Если объект Calendar не указан, драйвер использует по умолчанию часовую зону виртуальной машины, на которой выполняется приложение.

Параметры:

parameterName - имя параметра

x - значение параметра

cal - объект Calendar, который драйвер будет использовать для построения времени

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

setTimestamp

void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException

Устанавливает указанный параметр в заданное значение java.sql.Timestamp, используя заданный объект Calendar. Драйвер использует объект Calendar для построения значения SQL TIMESTAMP, которое затем передаётся в базу данных. С помощью объекта Calendar драйвер может вычислить метку времени с учётом пользовательской временной зоны. Если объект Calendar не указан, драйвер использует временную зону по умолчанию, которая соответствует виртуальной машине, на которой выполняется приложение.

Параметры:

parameterName - имя параметра

x - значение параметра

cal - объект Calendar, который драйвер будет использовать для построения метки времени

Исключения:

SQLException - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

setNull

void setNull(String parameterName, int sqlType, String typeName) throws SQLException

Устанавливает указанный параметр в значение SQL NULL. Этот метод setNull предназначен для типов, определённых пользователем, и параметров типа REF. Примерами типов, определённых пользователем, являются: STRUCT, DISTINCT, JAVA_OBJECT и именованные массивы типов.

Примечание: Для обеспечения портативности приложения должны указывать код SQL-типа и полное имя SQL-типа при указании параметра NULL пользовательского типа или типа REF. В случае типа, определённого пользователем, имя — это само имя типа параметра. Для параметра REF имя — это имя типа, на который ссылается параметр.

Хотя этот метод предназначен для параметров пользовательского типа и REF, его можно использовать для установки нулевого параметра любого типа JDBC. Если параметр не имеет типа, определённого пользователем, или типа REF, заданное имя типа игнорируется.

Параметры:: parameterName - имя параметра; sqlType - значение из java.sql.Types; typeName - полное имя SQL-типа, определённого пользователем; игнорируется, если параметр не является типом, определённым пользователем, или значением SQL REF
Исключения:: SQLException - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.4

getString

String getString(String parameterName) throws SQLException

Извлекает значение параметра JDBC CHAR, VARCHAR или LONGVARCHAR в качестве строки в языке программирования Java.

Для фиксированного типа JDBC CHAR возвращаемый объект String имеет точно такое же значение, какое имело значение SQL CHAR в базе данных, включая любые отступы, добавленные базой данных.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — null.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getBoolean

boolean getBoolean(String parameterName) throws SQLException

Извлекает значение параметра JDBC BIT или BOOLEAN в качестве значения типа boolean в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — false.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getByte

byte getByte(String parameterName) throws SQLException

Извлекает значение параметра JDBC TINYINT в качестве значения типа byte в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — 0.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getShort

short getShort(String parameterName) throws SQLException

Извлекает значение параметра JDBC SMALLINT в качестве значения типа short в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — 0.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getInt

int getInt(String parameterName) throws SQLException

Извлекает значение параметра JDBC INTEGER в качестве значения типа int в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — 0.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getLong

long getLong(String parameterName) throws SQLException

Извлекает значение параметра JDBC BIGINT в качестве значения типа long в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — 0.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getFloat

float getFloat(String parameterName) throws SQLException

Извлекает значение параметра JDBC FLOAT в качестве значения типа float в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение — SQL NULL, результат — 0.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.4

См. также:

getDouble

double getDouble(String parameterName) throws SQLException

Возвращает значение параметра JDBC DOUBLE в качестве double в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение является SQL NULL, результатом является 0.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getBytes

byte[] getBytes(String parameterName) throws SQLException

Возвращает значение параметра JDBC BINARY или VARBINARY в виде массива значений byte в языке программирования Java.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение является SQL NULL, результатом является null.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getDate

Date getDate(String parameterName) throws SQLException

Возвращает значение параметра JDBC DATE в виде объекта java.sql.Date.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение является SQL NULL, результатом является null.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getTime

Time getTime(String parameterName) throws SQLException

Возвращает значение параметра JDBC TIME в виде объекта java.sql.Time.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение является SQL NULL, результатом является null.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getTimestamp

Timestamp getTimestamp(String parameterName) throws SQLException

Возвращает значение параметра JDBC TIMESTAMP в виде объекта java.sql.Timestamp.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра. Если значение является SQL NULL, результатом является null.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getObject

Object getObject(String parameterName) throws SQLException

Возвращает значение параметра в виде Object в языке программирования Java. Если значение является SQL NULL, драйвер возвращает Java null.

Этот метод возвращает объект Java, тип которого соответствует типу JDBC, зарегистрированному для этого параметра с помощью метода registerOutParameter. Зарегистрировав целевой тип JDBC как java.sql.Types.OTHER, этот метод можно использовать для чтения типов данных абстрактных данных, специфичных для базы данных.

Параметры:

parameterName - имя параметра

Возвращает:

Объект, содержащий значение параметра OUT.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getBigDecimal

BigDecimal getBigDecimal(String parameterName) throws SQLException

Возвращает значение параметра JDBC NUMERIC в виде объекта java.math.BigDecimal с количеством цифр справа от десятичной точки, соответствующим значению.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра с полной точностью. Если значение является SQL NULL, результатом является null.

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getObject

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

Возвращает объект, представляющий значение параметра OUT parameterName и использует map для пользовательского сопоставления значения параметра.

Параметры:

parameterName - имя параметра

map - сопоставление имен типов SQL с классами Java

Возвращает:

объект, содержащий значение параметра OUT

Исключения:

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

См. также:

getRef

Ref getRef(String parameterName) throws SQLException

Возвращает значение параметра JDBC REF(<structured-type>) в виде объекта Ref в языке программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: значение параметра в виде объекта Ref в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.4

getBlob

Blob getBlob(String parameterName) throws SQLException

Возвращает значение параметра JDBC BLOB в виде объекта Blob в языке программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: значение параметра в виде объекта Blob в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:: 1.4

END_OF_DOCUMENT_MARKER

getClob

Clob getClob(String parameterName) throws SQLException

Извлекает значение параметра JDBC CLOB в виде объекта java.sql.Clob на языке программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: значение параметра в виде объекта Clob на языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4

getArray

Array getArray(String parameterName) throws SQLException

Извлекает значение параметра JDBC ARRAY в виде объекта Array на языке программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: значение параметра в виде объекта Array на языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4

getDate

Date getDate(String parameterName, Calendar cal) throws SQLException

Извлекает значение параметра JDBC DATE в виде объекта java.sql.Date, используя заданный объект Calendar для построения даты. С объектом Calendar драйвер может рассчитать дату, учитывая пользовательскую часовую зону и локаль. Если объект Calendar не указан, драйвер использует стандартную часовую зону и локаль.

Параметры:

parameterName - имя параметра

cal - объект Calendar, который драйвер будет использовать для построения даты

Возвращает:

значение параметра. Если значение — SQL NULL, результат — null.

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

getTime

Time getTime(String parameterName, Calendar cal) throws SQLException

Извлекает значение параметра JDBC TIME в виде объекта java.sql.Time, используя заданный объект Calendar для построения времени. С объектом Calendar драйвер может рассчитать время, учитывая пользовательскую часовую зону и локаль. Если объект Calendar не указан, драйвер использует стандартную часовую зону и локаль.

Параметры:

parameterName - имя параметра

cal - объект Calendar, который драйвер будет использовать для построения времени

Возвращает:

значение параметра; если значение — SQL NULL, результат — null.

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

getTimestamp

Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException

Извлекает значение параметра JDBC TIMESTAMP в виде объекта java.sql.Timestamp, используя заданный объект Calendar для построения объекта Timestamp. С объектом Calendar драйвер может рассчитать метку времени, учитывая пользовательскую часовую зону и локаль. Если объект Calendar не указан, драйвер использует стандартную часовую зону и локаль.

Параметры:

parameterName - имя параметра

cal - объект Calendar, который драйвер будет использовать для построения метки времени

Возвращает:

значение параметра. Если значение — SQL NULL, результат — null.

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

getURL

URL getURL(String parameterName) throws SQLException

Извлекает значение параметра JDBC DATALINK в виде объекта java.net.URL.

Параметры:

parameterName - имя параметра

Возвращает:

значение параметра в виде объекта java.net.URL на языке программирования Java. Если значение было SQL NULL, возвращается значение null.

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

С:

1.4

См. также:

getRowId

RowId getRowId(int parameterIndex) throws SQLException

Извлекает значение обозначенного параметра JDBC ROWID в виде объекта java.sql.RowId.

Параметры:: parameterIndex - первый параметр — 1, второй — 2,...
Возвращает:: объект RowId, представляющий значение JDBC ROWID, используемое в качестве обозначенного параметра. Если параметр содержит SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.6

getRowId

RowId getRowId(String parameterName) throws SQLException

Извлекает значение обозначенного параметра JDBC ROWID в виде объекта java.sql.RowId.

Параметры:: parameterName - имя параметра
Возвращает:: объект RowId, представляющий значение JDBC ROWID, используемое в качестве обозначенного параметра. Если параметр содержит SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.6

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

Устанавливает обозначенный параметр в указанный объект java.sql.RowId. Драйвер преобразует его в SQL ROWID при отправке в базу данных.

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.6

setNString

void setNString(String parameterName, String value) throws SQLException

Устанавливает обозначенный параметр в заданный объект String. Драйвер преобразует его в SQL NCHAR или NVARCHAR или LONGNVARCHAR

Параметры:: parameterName - имя параметра для установки; value - значение параметра
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.6

УстановитьПотокСимволов

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

Устанавливает указанный параметр в объект типа Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из формата символов Java в национальный кодировочный набор базы данных.

Параметры:: parameterName - имя параметра, который нужно установить; value - значение параметра; length - количество символов в данных параметра.
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если драйвер не поддерживает национальные кодировочные наборы; если драйвер обнаруживает, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

УстановитьNClob

void setNClob(String parameterName, NClob value) throws SQLException

Устанавливает указанный параметр в объект типа java.sql.NClob. Объект реализует интерфейс java.sql.NClob. Этот объект NClob соответствует SQL-типу NCLOB.

Параметры:: parameterName - имя параметра, который нужно установить; value - значение параметра
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если драйвер не поддерживает национальные кодировочные наборы; если драйвер обнаруживает, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

УстановитьClob

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

Устанавливает указанный параметр в объект типа Reader. Объект reader должен содержать количество символов, указанное в length, в противном случае при выполнении CallableStatement будет сгенерирована ошибка. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как CLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARCHAR или CLOB.

Параметры:: parameterName - имя параметра, который нужно установить; reader - Объект, содержащий данные для установки значения параметра.; length - количество символов в данных параметра.
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если заданная длина меньше нуля; произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

УстановитьBlob

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

Устанавливает указанный параметр в объект типа InputStream. Объект Inputstream должен содержать количество байтов, указанное в length, в противном случае при выполнении CallableStatement будет сгенерирована ошибка. Этот метод отличается от метода setBinaryStream (int, InputStream, int) тем, что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARBINARY или BLOB.

Параметры:: parameterName - имя параметра, который нужно установить (первый - 1, второй - 2, и т.д.); inputStream - Объект, содержащий данные для установки значения параметра.; length - количество байтов в данных параметра.
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если заданная длина меньше нуля; если количество байтов в InputStream не соответствует заданной длине; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

УстановитьNClob

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

Устанавливает указанный параметр в объект типа Reader. Объект reader должен содержать количество символов, указанное в length, в противном случае при выполнении CallableStatement будет сгенерирована ошибка. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как NCLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или NCLOB.

Параметры:: parameterName - имя параметра, который нужно установить; reader - Объект, содержащий данные для установки значения параметра.; length - количество символов в данных параметра.
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если заданная длина меньше нуля; если драйвер не поддерживает национальные кодировочные наборы; если драйвер обнаруживает, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

ПолучитьNClob

NClob getNClob(int parameterIndex) throws SQLException

Возвращает значение параметра JDBC NCLOB как объект типа java.sql.NClob в языке программирования Java.

Параметры:: parameterIndex - индекс первого параметра - 1, второго - 2 и т.д.
Возвращает:: значение параметра как объект типа NClob в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:: SQLException - если parameterIndex некорректен; если драйвер не поддерживает национальные кодировочные наборы; если драйвер обнаруживает, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

ПолучитьNClob

NClob getNClob(String parameterName) throws SQLException

Возвращает значение параметра JDBC NCLOB как объект типа java.sql.NClob в языке программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: значение параметра как объект типа NClob в языке программирования Java. Если значение было SQL NULL, возвращается значение null.
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если драйвер не поддерживает национальные кодировочные наборы; если драйвер обнаруживает, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

УстановитьSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

Устанавливает указанный параметр в объект java.sql.SQLXML. Драйвер преобразует его в значение SQL XML при отправке в базу данных.

Параметры:: parameterName - имя параметра; xmlObject - объект SQLXML, отображающий значение SQL XML
Исключения:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных; если метод вызван для закрытого CallableStatement или java.xml.transform.Result, Writer или OutputStream не были закрыты для объекта SQLXML; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

ПолучитьSQLXML

SQLXML getSQLXML(int parameterIndex) throws SQLException

Возвращает значение параметра SQL XML как объект java.sql.SQLXML в языке программирования Java.

Параметры:: parameterIndex - индекс первого параметра - 1, второго - 2 и т.д.
Возвращает:: объект SQLXML, отображающий значение SQL XML
Исключения:: SQLException - если parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

getSQLXML

SQLXML getSQLXML(String parameterName) throws SQLException

Возвращает значение заданного параметра SQL XML в качестве объекта java.sql.SQLXML языка программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: объект SQLXML, отображающий значение SQL XML
Исключения:: SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

getNString

String getNString(int parameterIndex) throws SQLException

Возвращает значение заданного параметра NCHAR, NVARCHAR или LONGNVARCHAR в качестве объекта String языка программирования Java.

Для типа JDBC NCHAR с фиксированной длиной возвращаемый объект String имеет ровно такое же значение, как у SQL-значения NCHAR в базе данных, включая любые добавленные базой данных пробелы.

Параметры:

parameterIndex - индекс первого параметра равен 1, второго - 2 и т. д.

Возвращает:

объект String, отображающий значение NCHAR, NVARCHAR или LONGNVARCHAR

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.6

См. также:

getNString

String getNString(String parameterName) throws SQLException

Параметры:

parameterName - имя параметра

Возвращает:

объект String, отображающий значение NCHAR, NVARCHAR или LONGNVARCHAR

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

С:

1.6

См. также:

getNCharacterStream

Reader getNCharacterStream(int parameterIndex) throws SQLException

Возвращает значение заданного параметра в качестве объекта java.io.Reader языка программирования Java. Предназначено для доступа к параметрам NCHAR,NVARCHAR и LONGNVARCHAR.

Параметры:: parameterIndex - первый параметр - 1, второй - 2 и т. д.
Возвращает:: объект java.io.Reader, содержащий значение параметра; если значение является SQL NULL, возвращаемое значение - null на языке программирования Java.
Исключения:: SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

getNCharacterStream

Reader getNCharacterStream(String parameterName) throws SQLException

Параметры:: parameterName - имя параметра
Возвращает:: объект java.io.Reader, содержащий значение параметра; если значение является SQL NULL, возвращаемое значение - null на языке программирования Java
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

getCharacterStream

Reader getCharacterStream(int parameterIndex) throws SQLException

Возвращает значение заданного параметра в качестве объекта java.io.Reader языка программирования Java.

Параметры:: parameterIndex - первый параметр - 1, второй - 2 и т. д.
Возвращает:: объект java.io.Reader, содержащий значение параметра; если значение является SQL NULL, возвращаемое значение - null на языке программирования Java.
Исключения:: SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
С:: 1.6

getCharacterStream

Reader getCharacterStream(String parameterName) throws SQLException

Возвращает значение заданного параметра в качестве объекта java.io.Reader языка программирования Java.

Параметры:: parameterName - имя параметра
Возвращает:: объект java.io.Reader, содержащий значение параметра; если значение является SQL NULL, возвращаемое значение - null на языке программирования Java
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

Устанавливает заданный параметр в указанный объект java.sql.Blob. Драйвер преобразует его в значение SQL BLOB при отправке в базу данных.

Параметры:: parameterName - имя параметра; x - объект Blob, отображающий значение SQL BLOB
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

setClob

void setClob(String parameterName, Clob x) throws SQLException

Устанавливает заданный параметр в указанный объект java.sql.Clob. Драйвер преобразует его в значение SQL CLOB при отправке в базу данных.

Параметры:: parameterName - имя параметра; x - объект Clob, отображающий значение SQL CLOB
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

setAsciiStream

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

Устанавливает заданный параметр в указанный поток ввода с заданным количеством байтов. Когда очень большое значение ASCII вводится в параметр LONGVARCHAR, может быть практичнее отправить его через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. JDBC-драйвер выполнит необходимый перевод из ASCII в формат символов базы данных.

Примечание: Этот объект потока может быть стандартным объектом потока Java или собственным подклассом, реализующим стандартный интерфейс.

Параметры:: parameterName - имя параметра; x - поток ввода Java, содержащий значение параметра ASCII; length - количество байтов в потоке
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.6

setBinaryStream

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

Устанавливает указанный параметр в заданный поток ввода, который будет содержать указанное количество байтов. Когда очень большое двоичное значение вводится в параметр LONGVARBINARY, может быть более практичным отправить его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

Примечание: Этот объект потока может быть стандартным объектом Java-потока или вашим собственным подклассом, реализующим стандартный интерфейс.

Parameters:: parameterName - имя параметра; x - поток ввода Java, содержащий двоичное значение параметра; length - количество байтов в потоке
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setCharacterStream

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

Устанавливает указанный параметр в заданный объект Reader, который имеет указанное количество символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может быть более практичным отправить его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.

Parameters:: parameterName - имя параметра; reader - объект java.io.Reader, содержащий данные UNICODE, используемые в качестве указанного параметра; length - количество символов в потоке
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

Устанавливает указанный параметр в заданный поток ввода. Когда очень большое значение ASCII вводится в параметр LONGVARCHAR, может быть более практичным отправить его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из ASCII в формат символов базы данных.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setAsciiStream, которая принимает параметр длины, быть более эффективным.

Parameters:: parameterName - имя параметра; x - поток ввода Java, содержащий значение параметра ASCII
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

Устанавливает указанный параметр в заданный поток ввода. Когда очень большое двоичное значение вводится в параметр LONGVARBINARY, может быть более практичным отправить его через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setBinaryStream, которая принимает параметр длины, быть более эффективным.

Parameters:: parameterName - имя параметра; x - поток ввода Java, содержащий двоичное значение параметра
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

Устанавливает указанный параметр в заданный объект Reader. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может быть более практичным отправить его через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setCharacterStream, которая принимает параметр длины, быть более эффективным.

Parameters:: parameterName - имя параметра; reader - объект java.io.Reader, содержащий данные Unicode
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

Устанавливает указанный параметр в объект Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимые преобразования из формата символов Java в национальный набор символов базы данных.

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setNCharacterStream, которая принимает параметр длины, быть более эффективным.

Parameters:: parameterName - имя параметра; value - значение параметра
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить ошибку преобразования данных; если произошла ошибка доступа к базе данных; или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setClob

void setClob(String parameterName, Reader reader) throws SQLException

Устанавливает указанный параметр в объект Reader. Этот метод отличается от метода setCharacterStream (int, Reader), поскольку он сообщает драйверу, что значение параметра должно быть отправлено на сервер в качестве CLOB. Когда используется метод setCharacterStream, драйвер может выполнить дополнительные операции, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARCHAR или CLOB

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setClob, которая принимает параметр длины, быть более эффективным.

Parameters:: parameterName - имя параметра; reader - объект, содержащий данные для установки значения параметра.
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException

Устанавливает указанный параметр в объект InputStream. Этот метод отличается от метода setBinaryStream (int, InputStream), поскольку он сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. Когда используется метод setBinaryStream, драйвер может выполнить дополнительные операции, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARBINARY или BLOB

Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии setBlob, которая принимает параметр длины, быть более эффективным.

Parameters:: parameterName - имя параметра; inputStream - объект, содержащий данные для установки значения параметра.
Throws:: SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:: 1.6

УстановитьNClob

void setNClob(String parameterName, Reader reader) throws SQLException

Устанавливает указанный параметр в объект Reader. Этот метод отличается от метода setCharacterStream (int, Reader), потому что он информирует драйвер о том, что значение параметра должно быть отправлено на сервер как NCLOB. Когда используется метод setCharacterStream, драйверу может потребоваться дополнительная работа для определения, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или как NCLOB

Примечание: Обратитесь к документации вашего JDBC-драйвера, чтобы определить, не будет ли использование версии setNClob, которая принимает параметр длины, более эффективным.

Параметры:: parameterName - имя параметра; reader - Объект, содержащий данные для установки значения параметра.
Исключения:: SQLException - если parameterName не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

ПолучитьОбъект

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

Возвращает объект, представляющий значение параметра ВЫХОД parameterIndex, и преобразует его из SQL-типа параметра в запрашиваемый тип данных Java, если преобразование поддерживается. Если преобразование не поддерживается или для типа указан null, выбрасывается SQLException.

По меньшей мере, реализация должна поддерживать преобразования, определённые в Приложении B, Таблица B-3, и преобразование соответствующих типов SQL, определённых пользователем, в тип Java, который реализует SQLData или Struct. Дополнительные преобразования могут быть поддержаны и определены поставщиком.

Параметры Типов:: T - тип класса, моделируемого этим объектом класса
Параметры:: parameterIndex - первый параметр равен 1, второй равен 2 и так далее; type - класс, представляющий тип данных Java, в который следует преобразовать указанный параметр.
Возвращает:: экземпляр type, содержащий значение параметра ВЫХОД
Исключения:: SQLException - если преобразование не поддерживается, тип null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.7

ПолучитьОбъект

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

Возвращает объект, представляющий значение параметра ВЫХОД parameterName, и преобразует его из SQL-типа параметра в запрашиваемый тип данных Java, если преобразование поддерживается. Если преобразование не поддерживается или для типа указан null, выбрасывается SQLException.

Параметры Типов:: T - тип класса, моделируемого этим объектом класса
Параметры:: parameterName - имя параметра; type - класс, представляющий тип данных Java, в который следует преобразовать указанный параметр.
Возвращает:: экземпляр type, содержащий значение параметра ВЫХОД
Исключения:: SQLException - если преобразование не поддерживается, тип null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.7

УстановитьОбъект

default void setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException

Устанавливает значение указанного параметра с заданным объектом. Если второй аргумент является InputStream, то поток должен содержать количество байтов, указанное параметром scaleOrLength. Если второй аргумент является Reader, то читатель должен содержать количество символов, указанное параметром scaleOrLength. Если эти условия не выполнены, драйвер сгенерирует SQLException при выполнении подготовленного оператора.

Заданный объект Java будет преобразован в указанный targetSqlType перед отправкой в базу данных. Если объект имеет пользовательское отображение (является классом, реализующим интерфейс SQLData), JDBC-драйвер должен вызвать метод SQLData.writeSQL для записи его в SQL-поток данных. Если, с другой стороны, объект является классом, реализующим Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего SQL-типа.

Реализация по умолчанию сгенерирует SQLFeatureNotSupportedException

Параметры:

parameterName - имя параметра

x - объект, содержащий входное значение параметра

targetSqlType - SQL-тип, который должен быть отправлен в базу данных. Параметр scale может дополнительно квалифицировать этот тип.

scaleOrLength - для java.sql.JDBCType.DECIMAL или java.sql.JDBCType.NUMERIC types, это количество цифр после десятичной точки. Для типов Java Object InputStream и Reader, это длина данных в потоке или читателе. Для всех остальных типов это значение будет проигнорировано.

Исключения:

SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement или если Java-объект, указанный x, является объектом InputStream или Reader, а значение параметра scale меньше нуля

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType

С тех пор:

1.8

См. также:

УстановитьОбъект

default void setObject(String parameterName, Object x, SQLType targetSqlType) throws SQLException

Устанавливает значение указанного параметра с заданным объектом. Этот метод похож на setObject(String parameterName, Object x, SQLType targetSqlType, int scaleOrLength), за исключением того, что он предполагает масштаб ноль.

Реализация по умолчанию сгенерирует SQLFeatureNotSupportedException

Параметры:

parameterName - имя параметра

x - объект, содержащий входное значение параметра

targetSqlType - SQL-тип, который должен быть отправлен в базу данных

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный targetSqlType

С тех пор:

1.8

См. также:

ЗарегистрироватьПараметрВыход

default void registerOutParameter(int parameterIndex, SQLType sqlType) throws SQLException

Регистрирует параметр ВЫХОД с порядковым номером parameterIndex для JDBC-типа sqlType. Все параметры ВЫХОД должны быть зарегистрированы перед выполнением хранимой процедуры.

JDBC-тип, указанный в sqlType для параметра ВЫХОД, определяет тип Java, который должен быть использован в методе get для чтения значения этого параметра.

Если JDBC-тип, ожидаемый в качестве возвращаемого значения этого выходного параметра, специфичен для данной базы данных, sqlType может быть JDBCType.OTHER или SQLType, поддерживаемым JDBC-драйвером. Метод getObject(int) извлекает значение.

Реализация по умолчанию сгенерирует SQLFeatureNotSupportedException

Параметры:

parameterIndex - первый параметр равен 1, второй равен 2 и так далее

sqlType - код JDBC-типа, определенный SQLType, который необходимо использовать для регистрации параметра ВЫХОД. Если параметр имеет JDBC-тип JDBCType.NUMERIC или JDBCType.DECIMAL, необходимо использовать версию registerOutParameter, принимающую значение scale.

Исключения:

SQLException - если parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный sqlType

С тех пор:

1.8

См. также:

registerOutParameter

default void registerOutParameter(int parameterIndex, SQLType sqlType, int scale) throws SQLException

Регистрирует параметр в порядковом положении parameterIndex в качестве типа JDBC sqlType. Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

Тип JDBC, указанный в sqlType для параметра OUT, определяет тип Java, который должен использоваться в методе get для чтения значения этого параметра.

Этот вариант registerOutParameter следует использовать, когда параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее

sqlType - код типа JDBC, определенный в SQLType, используемый для регистрации параметра OUT.

scale - желаемое количество знаков после запятой. Должно быть больше или равно нулю.

Исключения:

SQLException - если параметрIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный sqlType

С:

1.8

См. также:

registerOutParameter

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

Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

Для параметра пользовательского типа также должно быть указано полное имя SQL-типа параметра, в то время как для параметра REF необходимо указать полное имя типа, на который он ссылается. JDBC-драйвер, которому не нужна информация о коде типа и имени типа, может ее проигнорировать. Однако для обеспечения портативности приложения всегда должны предоставлять эти значения для параметров пользовательского и REF типа. Несмотря на то, что этот метод предназначен для параметров пользовательского и REF типа, он может использоваться для регистрации параметра любого типа JDBC. Если параметр не имеет пользовательского или REF типа, параметр typeName игнорируется.

Примечание: При чтении значения параметра out необходимо использовать метод-получатель, тип Java которого соответствует зарегистрированному типу SQL параметра.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

Параметры:

parameterIndex - первый параметр имеет индекс 1, второй - 2, и так далее

sqlType - код типа JDBC, определенный в SQLType, используемый для регистрации параметра OUT.

typeName - полное имя SQL-структурированного типа.

Исключения:

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный sqlType

С:

1.8

См. также:

registerOutParameter

default void registerOutParameter(String parameterName, SQLType sqlType) throws SQLException

Регистрирует параметр OUT с именем parameterName как тип JDBC sqlType. Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

Если ожидаемый тип JDBC, возвращаемый в этот параметр вывода, специфичен для данной базы данных, sqlType должен быть JDBCType.OTHER или SQLType, поддерживаемый JDBC-драйвером. Метод getObject(int) извлекает значение.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

Параметры:

parameterName - имя параметра

sqlType - код типа JDBC, определенный в SQLType, используемый для регистрации параметра OUT. Если параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.

Исключения:

SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный sqlType или если JDBC-драйвер не поддерживает этот метод

С:

1.8

См. также:

registerOutParameter

default void registerOutParameter(String parameterName, SQLType sqlType, int scale) throws SQLException

Регистрирует параметр с именем parameterName в качестве типа JDBC sqlType. Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

Этот вариант registerOutParameter следует использовать, когда параметр имеет тип JDBC JDBCType.NUMERIC или JDBCType.DECIMAL.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

Параметры:

parameterName - имя параметра

sqlType - код типа JDBC, определенный в SQLType, используемый для регистрации параметра OUT.

scale - желаемое количество знаков после запятой. Должно быть больше или равно нулю.

Исключения:

С:

1.8

См. также:

registerOutParameter

default void registerOutParameter(String parameterName, SQLType sqlType, String typeName) throws SQLException

Регистрирует указанный параметр вывода. Этот вариант метода registerOutParameter следует использовать для параметра вывода с пользовательским именем или REF. Примеры пользовательских имен типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

Для параметра с пользовательским именем должно быть указано полное имя SQL-типа параметра, а для параметра REF — полное имя типа, на который он ссылается. JDBC-драйвер, которому не нужна информация о коде типа и имени типа, может ее проигнорировать. Однако для обеспечения портативности приложения всегда должны предоставлять эти значения для параметров с пользовательским именем и REF. Несмотря на то, что этот метод предназначен для параметров с пользовательским именем и REF, он может использоваться для регистрации параметра любого типа JDBC. Если параметр не имеет пользовательского имени или типа REF, параметр typeName игнорируется.

Примечание: При чтении значения параметра out необходимо использовать метод-получатель getXXX, тип Java которого соответствует зарегистрированному типу SQL параметра.

По умолчанию реализация будет выбрасывать SQLFeatureNotSupportedException

Параметры:

parameterName - имя параметра

sqlType - код типа JDBC, определенный в SQLType, используемый для регистрации параметра OUT.

typeName - полное имя SQL-структурированного типа.

Исключения:

С:

1.8

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/CallableStatement.html