Интерфейс CallableStatement

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

public interface CallableStatement extends PreparedStatement

Интерфейс для выполнения хранимых процедур SQL. API JDBC предоставляет синтаксис escape-последовательностей SQL для хранимых процедур, позволяющий вызывать их единообразным способом во всех СУБД. У этого синтаксиса есть одна форма с параметром результата и одна без него. Если используется параметр результата, его необходимо зарегистрировать как параметр OUT. Остальные параметры можно использовать для ввода, вывода или и того и другого. На параметры ссылаются последовательно по номерам, начиная с 1.

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

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

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

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

Начиная с версии:

1.1

См. также:

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

Поля, объявленные в интерфейсе 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)`	Возвращает значение указанного параметра в виде `Object` в языке программирования Java.
`<T> T`	`getObject(int parameterIndex, Class<T> type)`	Возвращает объект, представляющий значение выходного параметра `parameterIndex`, и преобразует тип SQL параметра в запрошенный тип данных Java, если такое преобразование поддерживается.
`Object`	`getObject(int parameterIndex, Map<String,Class<?>> map)`	Возвращает объект, представляющий значение выходного параметра `parameterIndex`, и использует `map` для пользовательского сопоставления значения параметра.
`Object`	`getObject(String parameterName)`	Возвращает значение параметра в виде `Object` в языке программирования Java.
`<T> T`	`getObject(String parameterName, Class<T> type)`	Возвращает объект, представляющий значение выходного параметра `parameterName`, и преобразует тип SQL параметра в запрошенный тип данных Java, если такое преобразование поддерживается.
`Object`	`getObject(String parameterName, Map<String,Class<?>> map)`	Возвращает объект, представляющий значение выходного параметра `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)`	Регистрирует выходной параметр с порядковым номером `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)`	Регистрирует выходной параметр с порядковым номером `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)`	Регистрирует выходной параметр с именем `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)`	Регистрирует выходной параметр с именем `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`.
`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)`	Устанавливает для указанного параметра переданный объект `java.net.URL`.
`boolean`	`wasNull()`	Возвращает сведения о том, имел ли последний прочитанный выходной параметр значение SQL `NULL`.

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

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

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

isWrapperFor, unwrap

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

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

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

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

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

Параметры:

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

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

Исключения:

SQLException — если parameterIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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. Все параметры OUT необходимо зарегистрировать до выполнения хранимой процедуры.

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

Параметры:

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

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

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

Исключения:

См. также:

wasNull

boolean wasNull() throws SQLException

Проверяет, имел ли последний прочитанный параметр OUT значение 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.

Исключения:

См. также:

getDouble

double getDouble(int parameterIndex) throws SQLException

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

Параметры:

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

Возвращает:

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

Исключения:

См. также:

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 типа CLOB в виде объекта 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 в виде объекта 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 типа DATE в виде объекта java.sql.Date, используя переданный объект Calendar для создания даты. С помощью объекта Calendar драйвер может вычислить дату с учетом пользовательского часового пояса и локали. Если объект Calendar не указан, драйвер использует часовой пояс и локаль по умолчанию.

Параметры:

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

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

Возвращает:

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

Исключения:

Начиная с версии:

1.2

См. также:

getTime

Time getTime(int parameterIndex, Calendar cal) throws SQLException

Извлекает значение указанного параметра JDBC типа TIME в виде объекта 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 типа TIMESTAMP в виде объекта 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 и именованные типы массивов.

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

Для пользовательского параметра также следует указать полное имя типа 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. Все параметры OUT должны быть зарегистрированы до выполнения хранимой процедуры.

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

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

Параметры:

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

Исключения:

С версии:

1.4

См. также:

registerOutParameter

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

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

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

Параметры:

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

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

scale — требуемое количество цифр после десятичной точки. Значение должно быть неотрицательным.

Исключения:

С версии:

1.4

См. также:

registerOutParameter

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

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

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

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

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

Параметры:

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

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

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

Исключения:

С версии:

1.4

См. также:

getURL

URL getURL(int parameterIndex) throws SQLException

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

Параметры:

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

Возвращает:

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

Исключения:

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

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

С версии:

1.4

См. также:

setURL

void setURL(String parameterName, URL val) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С версии:

1.4

См. также:

setNull

void setNull(String parameterName, int sqlType) throws SQLException

Устанавливает для указанного параметра значение SQL NULL.

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

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

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

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

Параметры:

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

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

Исключения:

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

С версии:

1.4

См. также:

setByte

void setByte(String parameterName, byte x) throws SQLException

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

Параметры:

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

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

Исключения:

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

С версии:

1.4

См. также:

setShort

void setShort(String parameterName, short x) throws SQLException

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

Параметры:

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

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

Исключения:

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

С версии:

1.4

См. также:

setInt

void setInt(String parameterName, int x) throws SQLException

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

Параметры:

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

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

Исключения:

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

С версии:

1.4

См. также:

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

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

Примечание: Объект потока может быть как стандартным объектом потока 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. Данные будут считываться из потока по мере необходимости до достижения конца файла.

Параметры:: 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. Для максимальной переносимости вместо setObject(String parameterName, Object x) следует использовать метод setNull или setObject(String parameterName, Object x, int sqlType).

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setCharacterStream

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

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

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

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

setDate

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

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

Параметры:

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

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setTime

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

Задает указанному параметру заданное значение java.sql.Time, используя заданный объект 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, который драйвер будет использовать для создания временной метки

Исключения:

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, заданное значение typeName игнорируется.

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

getString

String getString(String parameterName) throws SQLException

Получает значение параметра JDBC CHAR, VARCHAR или LONGVARCHAR в виде String в языке программирования 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 - имя параметра

Возвращает:

Объект java.lang.Object, содержащий значение параметра 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

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

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

Параметры:

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

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

Возвращает:

объект java.lang.Object, содержащий значение параметра 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

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.

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

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

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.

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

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

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

setNCharacterStream

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

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

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

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

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

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

setClob

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

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

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

setBlob

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

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

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

setNClob

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

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

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

getNClob

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

getNClob

NClob getNClob(String parameterName) throws SQLException

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

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

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

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

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

getSQLXML

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

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

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

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

Начиная с версии:

1.6

См. также:

getNString

String getNString(String parameterName) throws SQLException

Извлекает значение указанного параметра NCHAR, NVARCHAR или LONGNVARCHAR в виде String в языке программирования Java.

Параметры:

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, возвращаемое значение в языке программирования Java — null.
Выбрасывает:: SQLException — если parameterIndex недопустим; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого CallableStatement; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.6

getNCharacterStream

Reader getNCharacterStream(String parameterName) throws SQLException

Параметры:: parameterName — имя параметра
Возвращает:: объект java.io.Reader, содержащий значение параметра; если значение равно SQL NULL, возвращаемое значение в языке программирования Java — null
Выбрасывает:: 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, возвращаемое значение в языке программирования Java — null.
Выбрасывает:: SQLException — если parameterIndex недопустим; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого CallableStatement
Начиная с версии:: 1.6

getCharacterStream

Reader getCharacterStream(String parameterName) throws SQLException

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

Параметры:: parameterName — имя параметра
Возвращает:: объект java.io.Reader, содержащий значение параметра; если значение равно SQL NULL, возвращаемое значение в языке программирования Java — null
Выбрасывает:: 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

Устанавливает для указанного параметра заданный входной поток, содержащий указанное количество байтов. Если в параметр LONGVARCHAR передается очень большое значение ASCII, может быть практичнее передать его через 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. Данные будут считываться из потока по мере необходимости до достижения конца файла.

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

setCharacterStream

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

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

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

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

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

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

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

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

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

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

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

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

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

setClob

void setClob(String parameterName, Reader reader) throws SQLException

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

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

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

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException

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

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

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

setNClob

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

getObject

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

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

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

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

getObject

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

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

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

setObject

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 InputStream и Reader это длина данных в потоке или считывателе. Для всех остальных типов это значение игнорируется.

Исключения:

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

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

Начиная с версии:

1.8

См. также:

setObject

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

См. также:

registerOutParameter

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, принимающую значение масштаба.

Исключения:

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

Начиная с версии:

1.8

См. также:

registerOutParameter

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

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

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

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

Параметры:

parameterIndex — первому параметру соответствует 1, второму — 2 и т. д.

sqlType — код типа JDBC, определенный в SQLType, для регистрации выходного параметра.

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

Исключения:

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

Начиная с версии:

1.8

См. также:

registerOutParameter

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

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

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

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

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

Параметры:

parameterIndex — первому параметру соответствует 1, второму — 2 и т. д.

sqlType — код типа JDBC, определенный в SQLType, для регистрации выходного параметра.

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

Исключения:

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

Начиная с версии:

1.8

См. также:

registerOutParameter

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

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

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

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

Параметры:

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

Исключения:

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

Начиная с версии:

1.8

См. также:

registerOutParameter

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

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

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

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

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

Параметры:

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

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

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

Исключения:

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

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

С версии:

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 игнорируется.

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

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

Параметры:

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

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

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

Исключения:

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

С версии:

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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/CallableStatement.html