Интерфейс CallableStatement

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

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

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

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

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

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

С тех пор:
1.1
См. также:
Connection.prepareCall(java.lang.String), ResultSet

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

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

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

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

Модификатор и тип Метод Описание
Array getArray​(int parameterIndex)

Извлекает значение указанного параметра JDBC ARRAY в виде объекта Array на языке программирования Java.
Array getArray​(String parameterName)

Извлекает значение параметра JDBC ARRAY в виде объекта Array на языке программирования Java.
BigDecimal getBigDecimal​(int parameterIndex)

Извлекает значение указанного параметра JDBC NUMERIC в виде объекта java.math.BigDecimal со столькими знаками после десятичной точки, сколько их содержится в значении.
BigDecimal getBigDecimal​(int parameterIndex, int scale)

Устарело.

использовать getBigDecimal(int parameterIndex) или getBigDecimal(String parameterName)

BigDecimal getBigDecimal​(String parameterName)

Извлекает значение параметра JDBC NUMERIC в виде объекта java.math.BigDecimal со столькими знаками после десятичной точки, сколько их содержится в значении.
Blob getBlob​(int parameterIndex)

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

Извлекает значение параметра JDBC BLOB в виде объекта Blob на языке программирования Java.
boolean getBoolean​(int parameterIndex)

Извлекает значение указанного параметра JDBC BIT или BOOLEAN в виде boolean на языке программирования Java.
boolean getBoolean​(String parameterName)

Извлекает значение параметра JDBC BIT или BOOLEAN в виде boolean на языке программирования Java.
byte getByte​(int parameterIndex)

Извлекает значение указанного параметра JDBC TINYINT в виде byte на языке программирования Java.
byte getByte​(String parameterName)

Извлекает значение параметра JDBC TINYINT в виде byte на языке программирования Java.
byte[] getBytes​(int parameterIndex)

Извлекает значение указанного параметра JDBC BINARY или VARBINARY в виде массива значений byte на языке программирования Java.
byte[] getBytes​(String parameterName)

Извлекает значение параметра JDBC BINARY или VARBINARY в виде массива значений byte на языке программирования Java.
Reader getCharacterStream​(int parameterIndex)

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

Извлекает значение указанного параметра в виде объекта java.io.Reader на языке программирования Java.
Clob getClob​(int parameterIndex)

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

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

Извлекает значение указанного параметра JDBC DATE в виде объекта java.sql.Date.
Date getDate​(int parameterIndex, Calendar cal)

Извлекает значение указанного параметра JDBC DATE в виде объекта java.sql.Date, используя заданный объект Calendar для построения даты.
Date getDate​(String parameterName)

Извлекает значение параметра JDBC DATE в виде объекта java.sql.Date.
Date getDate​(String parameterName, Calendar cal)

Извлекает значение параметра JDBC DATE в виде объекта java.sql.Date, используя заданный объект Calendar для построения даты.
double getDouble​(int parameterIndex)

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

Извлекает значение параметра JDBC DOUBLE в виде double на языке программирования Java.
float getFloat​(int parameterIndex)

Извлекает значение указанного параметра JDBC FLOAT в виде float на языке программирования Java.
float getFloat​(String parameterName)

Извлекает значение параметра JDBC FLOAT в виде float на языке программирования Java.
int getInt​(int parameterIndex)

Извлекает значение указанного параметра JDBC INTEGER в виде int на языке программирования Java.
int getInt​(String parameterName)

Извлекает значение параметра JDBC INTEGER в виде int на языке программирования Java.
long getLong​(int parameterIndex)

Извлекает значение указанного параметра JDBC BIGINT в виде long на языке программирования Java.
long getLong​(String parameterName)

Извлекает значение параметра JDBC BIGINT в виде long на языке программирования Java.
Reader getNCharacterStream​(int parameterIndex)

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

Извлекает значение указанного параметра в виде объекта java.io.Reader на языке программирования Java.
NClob getNClob​(int parameterIndex)

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

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

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

Извлекает значение указанного параметра NCHAR, NVARCHAR или LONGNVARCHAR в виде String на языке программирования Java.
Object getObject​(int parameterIndex)

Извлекает значение указанного параметра в виде 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)

Регистрирует параметр OUT в позиционной позиции parameterIndex с типом JDBC sqlType.

void registerOutParameter​(int parameterIndex, int sqlType, int scale)

Регистрирует параметр в позиционной позиции parameterIndex с типом JDBC sqlType.

void registerOutParameter​(int parameterIndex, int sqlType, String typeName)

Регистрирует указанный выходной параметр.
default void registerOutParameter​(int parameterIndex, SQLType sqlType)

Регистрирует параметр OUT в позиционной позиции parameterIndex с типом JDBC sqlType.

default void registerOutParameter​(int parameterIndex, SQLType sqlType, int scale)

Регистрирует параметр в позиционной позиции parameterIndex с типом JDBC sqlType.

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

Регистрирует указанный выходной параметр.
void registerOutParameter​(String parameterName, int sqlType)

Регистрирует параметр OUT с именем parameterName с типом JDBC sqlType.

void registerOutParameter​(String parameterName, int sqlType, int scale)

Регистрирует параметр с именем parameterName с типом JDBC sqlType.

void registerOutParameter​(String parameterName, int sqlType, String typeName)

Регистрирует указанный выходной параметр.
default void registerOutParameter​(String parameterName, SQLType sqlType)

Регистрирует параметр OUT с именем parameterName с типом JDBC sqlType.

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

Регистрирует параметр с именем parameterName с типом JDBC sqlType.

default void registerOutParameter​(String parameterName, SQLType sqlType, String typeName)

Регистрирует указанный выходной параметр.
void setAsciiStream​(String parameterName, InputStream x)

Устанавливает указанный параметр в заданный поток ввода.
void setAsciiStream​(String parameterName, InputStream x, int length)

Устанавливает указанный параметр в заданный поток ввода, который будет содержать указанное количество байтов.
void setAsciiStream​(String parameterName, InputStream x, long length)

Устанавливает указанный параметр в заданный поток ввода, который будет содержать указанное количество байтов.
void setBigDecimal​(String parameterName, BigDecimal x)

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

void setBinaryStream​(String parameterName, InputStream x)

Устанавливает указанный параметр в заданный поток ввода.
void setBinaryStream​(String parameterName, InputStream x, int length)

Устанавливает указанный параметр в заданный поток ввода, который будет содержать указанное количество байтов.
void setBinaryStream​(String parameterName, InputStream x, long length)

Устанавливает указанный параметр в заданный поток ввода, который будет содержать указанное количество байтов.
void setBlob​(String parameterName, InputStream inputStream)

Устанавливает указанный параметр в объект InputStream.

void setBlob​(String parameterName, InputStream inputStream, long length)

Устанавливает указанный параметр в объект InputStream.

void setBlob​(String parameterName, Blob x)

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

void setBoolean​(String parameterName, boolean x)

Устанавливает указанный параметр в заданное значение Java boolean.

void setByte​(String parameterName, byte x)

Устанавливает указанный параметр в заданное значение Java byte.

void setBytes​(String parameterName, byte[] x)

Устанавливает указанный параметр в заданный массив байтов Java.
void setCharacterStream​(String parameterName, Reader reader)

Устанавливает указанный параметр в заданный объект Reader.

void setCharacterStream​(String parameterName, Reader reader, int length)

Устанавливает указанный параметр в заданный объект Reader, длина которого составляет заданное количество символов.
void setCharacterStream​(String parameterName, Reader reader, long length)

Устанавливает указанный параметр в заданный объект Reader, длина которого составляет заданное количество символов.
void setClob​(String parameterName, Reader reader)

Устанавливает указанный параметр в объект Reader.

void setClob​(String parameterName, Reader reader, long length)

Устанавливает указанный параметр в объект Reader.

void setClob​(String parameterName, Clob x)

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

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.

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

addBatch, clearParameters, execute, executeLargeUpdate, executeQuery, executeUpdate, getMetaData, getParameterMetaData, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setDate, setDate, setDouble, setFloat, setInt, setLong, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNString, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setRef, setRowId, setShort, setSQLXML, setString, setTime, setTime, setTimestamp, setTimestamp, setUnicodeStream, setURL

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

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

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

isWrapperFor, unwrap

Методы

registerOutParameter

void registerOutParameter(int parameterIndex,
                          int sqlType)
                   throws SQLException

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

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

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
sqlType - код типа JDBC, определенный в java.sql.Types. Если параметр имеет тип JDBC NUMERIC или DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, и драйвер JDBC не поддерживает этот тип данных
См. также:
Types

registerOutParameter

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

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

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

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
sqlType - код SQL типа, определенный в java.sql.Types.
scale - желаемое количество знаков после запятой. Оно должно быть больше или равно нулю.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT, и драйвер JDBC не поддерживает этот тип данных
См. также:
Types

wasNull

boolean wasNull()
         throws SQLException

Возвращает значение true, если последнее прочитанное значение параметра 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.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setString(java.lang.String, java.lang.String)

getBoolean

boolean getBoolean(int parameterIndex)
            throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен false.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setBoolean(java.lang.String, boolean)

getByte

byte getByte(int parameterIndex)
      throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен 0.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setByte(java.lang.String, byte)

getShort

short getShort(int parameterIndex)
        throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен 0.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setShort(java.lang.String, short)

getInt

int getInt(int parameterIndex)
    throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен 0.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setInt(java.lang.String, int)

getLong

long getLong(int parameterIndex)
      throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен 0.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setLong(java.lang.String, long)

getFloat

float getFloat(int parameterIndex)
        throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен 0.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setFloat(java.lang.String, float)

getDouble

double getDouble(int parameterIndex)
          throws SQLException

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

Параметры:
parameterIndex - первый параметр имеет значение 1, второй - 2 и так далее
Возвращает:
значение параметра. Если значение равно SQL NULL, результат равен 0.
Исключения:
SQLException - если параметрIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
См. также:
setDouble(java.lang.String, double)

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.
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
См. также:
setBigDecimal(java.lang.String, java.math.BigDecimal)

getBytes

byte[] getBytes(int parameterIndex)
         throws SQLException

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
Возвращаемое значение:
значение параметра. Если значение является SQL NULL, результат — null.
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
См. также:
setBytes(java.lang.String, byte[])

getDate

Date getDate(int parameterIndex)
      throws SQLException

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
Возвращаемое значение:
значение параметра. Если значение является SQL NULL, результат — null.
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
См. также:
setDate(java.lang.String, java.sql.Date)

getTime

Time getTime(int parameterIndex)
      throws SQLException

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
Возвращаемое значение:
значение параметра. Если значение является SQL NULL, результат — null.
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
См. также:
setTime(java.lang.String, java.sql.Time)

getTimestamp

Timestamp getTimestamp(int parameterIndex)
                throws SQLException

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
Возвращаемое значение:
значение параметра. Если значение является SQL NULL, результат — null.
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
См. также:
setTimestamp(java.lang.String, java.sql.Timestamp)

getObject

Object getObject(int parameterIndex)
          throws SQLException

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

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
Возвращаемое значение:
Объект, содержащий значение параметра OUT
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
См. также:
Types, setObject(java.lang.String, java.lang.Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex)
                  throws SQLException

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
Возвращаемое значение:
значение параметра с полной точностью. Если значение является SQL NULL, результат — null.
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
С момента:
1.2
См. также:
setBigDecimal(java.lang.String, java.math.BigDecimal)

getObject

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

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

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

Параметры:
parameterIndex - первый параметр равен 1, второй — 2 и так далее
map - отображение имен типов SQL на классы Java
Возвращаемое значение:
объект, содержащий значение параметра OUT
Исключения:
SQLException - если параметр parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:
1.2
См. также:
setObject(java.lang.String, java.lang.Object, int, int)

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.
Исключения:
SQLException — если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
С момента:
1.2
См. также:
setDate(java.lang.String, java.sql.Date)

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.
Исключения:
SQLException — если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
С момента:
1.2
См. также:
setTime(java.lang.String, java.sql.Time)

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.
Исключения:
SQLException — если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
С момента:
1.2
См. также:
setTimestamp(java.lang.String, java.sql.Timestamp)

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-структурированного типа
Исключения:
SQLException - если parameterIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если sqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных
С момента:
1.2
См. также:
Types

registerOutParameter

void registerOutParameter(String parameterName,
                          int sqlType)
                   throws SQLException

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

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

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

Параметры:
parameterName - имя параметра
sqlType - код JDBC-типа, определённый в java.sql.Types. Если параметр имеет JDBC-тип NUMERIC или DECIMAL, следует использовать версию registerOutParameter, принимающую значение масштаба.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если sqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных или если драйвер JDBC не поддерживает этот метод
С момента:
1.4
См. также:
Types

registerOutParameter

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

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

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

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

Параметры:
parameterName - имя параметра
sqlType - код SQL-типа, определённый в java.sql.Types.
scale - желаемое количество цифр после десятичной точки. Должно быть больше или равно нулю.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если sqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных или если драйвер JDBC не поддерживает этот метод
С момента:
1.4
См. также:
Types

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

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

Параметры:
parameterName - имя параметра
sqlType - значение из Types
typeName - полное имя структурированного типа SQL
Исключения:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если sqlType является типом данных ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных, или если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
Types

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(java.lang.String, java.net.URL)

setURL

void setURL(String parameterName,
            URL val)
     throws SQLException

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

Параметры:
parameterName - имя параметра
val - значение параметра
Исключения:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных; этот метод был вызван для закрытого CallableStatement или URL некорректен
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
getURL(int)

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 - значение параметра
Исключения:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Начиная с:
1.4
См. также:
getBoolean(int)

setByte

void setByte(String parameterName,
             byte x)
      throws SQLException

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

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

setShort

void setShort(String parameterName,
              short x)
       throws SQLException

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

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

setInt

void setInt(String parameterName,
            int x)
     throws SQLException

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

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

setLong

void setLong(String parameterName,
             long x)
      throws SQLException

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

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

setFloat

void setFloat(String parameterName,
              float x)
       throws SQLException

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

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

setDouble

void setDouble(String parameterName,
               double x)
        throws SQLException

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

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

setBigDecimal

void setBigDecimal(String parameterName,
                   BigDecimal x)
            throws SQLException

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

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

setString

void setString(String parameterName,
               String x)
        throws SQLException

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

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

setBytes

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

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

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

setDate

void setDate(String parameterName,
             Date x)
      throws SQLException

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

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

setTime

void setTime(String parameterName,
             Time x)
      throws SQLException

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

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

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x)
           throws SQLException

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

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

setAsciiStream

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

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

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

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

setBinaryStream

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

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

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

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

setObject

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

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

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

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

Параметры:
parameterName - имя параметра
x - объект, содержащий значение входного параметра
targetSqlType - тип SQL (как определено в java.sql.Types), который будет отправлен в базу данных. Аргумент scale может дополнительно квалифицировать этот тип.
scale - для типов java.sql.Types.DECIMAL или java.sql.Types.NUMERIC, это количество цифр после десятичной точки. Для всех других типов это значение будет проигнорировано.
Исключения:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный targetSqlType
С версии:
1.4
См. также:
Types, getObject(int)

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), который будет отправлен в базу данных
Исключения:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный targetSqlType
С версии:
1.4
См. также:
getObject(int)

setObject

void setObject(String parameterName,
               Object x)
        throws SQLException

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

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

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

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

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

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

setCharacterStream

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

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

Примечание: Этот объект потока может быть стандартным объектом потока 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
См. также:
getDate(int)

setTime

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

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

Параметры:
parameterName - имя параметра
x - значение параметра
cal - объект Calendar, который драйвер будет использовать для построения времени
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
getTime(int)

setTimestamp

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

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

Параметры:
parameterName - имя параметра
x - значение параметра
cal - объект Calendar, который драйвер будет использовать для построения временной метки
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
getTimestamp(int)

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.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
setString(java.lang.String, java.lang.String)

getBoolean

boolean getBoolean(String parameterName)
            throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — false.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
setBoolean(java.lang.String, boolean)

getByte

byte getByte(String parameterName)
      throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — 0.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
setByte(java.lang.String, byte)

getShort

short getShort(String parameterName)
        throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — 0.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
setShort(java.lang.String, short)

getInt

int getInt(String parameterName)
    throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — 0.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С тех пор:
1.4
См. также:
setInt(java.lang.String, int)

getLong

long getLong(String parameterName)
      throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — 0.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setLong(java.lang.String, long)

getFloat

float getFloat(String parameterName)
        throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — 0.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setFloat(java.lang.String, float)

getDouble

double getDouble(String parameterName)
          throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — 0.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setDouble(java.lang.String, double)

getBytes

byte[] getBytes(String parameterName)
         throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setBytes(java.lang.String, byte[])

getDate

Date getDate(String parameterName)
      throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setDate(java.lang.String, java.sql.Date)

getTime

Time getTime(String parameterName)
      throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setTime(java.lang.String, java.sql.Time)

getTimestamp

Timestamp getTimestamp(String parameterName)
                throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение является SQL NULL, результат — null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setTimestamp(java.lang.String, java.sql.Timestamp)

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.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
Types, setObject(java.lang.String, java.lang.Object, int, int)

getBigDecimal

BigDecimal getBigDecimal(String parameterName)
                  throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра в полной точности. Если значение является SQL NULL, результат — null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setBigDecimal(java.lang.String, java.math.BigDecimal)

getObject

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

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

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

Параметры:
parameterName - имя параметра
map - отображение имен типов SQL на классы Java
Возвращает:
java.lang.Object, содержащий значение параметра OUT
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setObject(java.lang.String, java.lang.Object, int, int)

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
См. также:
setDate(java.lang.String, java.sql.Date)

getTime

Time getTime(String parameterName,
             Calendar cal)
      throws SQLException

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

Параметры:
parameterName - имя параметра
cal - объект Calendar, который драйвер будет использовать для построения времени
Возвращает:
значение параметра; если значение было SQL NULL, результат null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setTime(java.lang.String, java.sql.Time)

getTimestamp

Timestamp getTimestamp(String parameterName,
                       Calendar cal)
                throws SQLException

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

Параметры:
parameterName - имя параметра
cal - объект Calendar, который драйвер будет использовать для построения отметки времени
Возвращает:
значение параметра. Если значение было SQL NULL, результат null.
Выбрасывает:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.4
См. также:
setTimestamp(java.lang.String, java.sql.Timestamp)

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
См. также:
setURL(java.lang.String, java.net.URL)

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 - если имя параметра не соответствует названному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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 - если имя параметра не соответствует названному параметру; если указанная длина меньше нуля; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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 - имя параметра, который нужно установить; первый - 1, второй - 2, и так далее.
inputStream - объект, содержащий данные для установки значения параметра.
length - количество байтов в данных параметра.
Исключения:
SQLException - если имя параметра не соответствует названному параметру; если указанная длина меньше нуля; если количество байтов в 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 - если имя параметра не соответствует названному параметру; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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 - если параметрIndex недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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 - если имя параметра не соответствует названному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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 - если имя параметра не соответствует названному параметру; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого 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 - если параметрIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:
1.6

getSQLXML

SQLXML getSQLXML(String parameterName)
          throws SQLException

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

Параметры:
parameterName - имя параметра
Возвращает:
объект SQLXML, который отображает значение SQL XML
Исключения:
SQLException - если имя параметра не соответствует названному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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 - если параметрIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:
1.6
См. также:
setNString(java.lang.String, java.lang.String)

getNString

String getNString(String parameterName)
           throws SQLException

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

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

Параметры:
parameterName - имя параметра
Возвращает:
объект String, который отображает значение NCHAR, NVARCHAR или LONGNVARCHAR
Имеет исключения:
SQLException - если параметр parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:
1.6
См. также:
setNString(java.lang.String, java.lang.String)

getNCharacterStream

Reader getNCharacterStream(int parameterIndex)
                    throws SQLException

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

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

getNCharacterStream

Reader getNCharacterStream(String parameterName)
                    throws SQLException

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

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

getCharacterStream

Reader getCharacterStream(int parameterIndex)
                   throws SQLException

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

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

getCharacterStream

Reader getCharacterStream(String parameterName)
                   throws SQLException

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

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

setBlob

void setBlob(String parameterName,
             Blob x)
      throws SQLException

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

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

setClob

void setClob(String parameterName,
             Clob x)
      throws SQLException

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

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

setAsciiStream

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

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

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

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

setBinaryStream

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

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

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

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

setCharacterStream

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

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

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

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

setAsciiStream

void setAsciiStream(String parameterName,
                    InputStream x)
             throws SQLException

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

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

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

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

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x)
              throws SQLException

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

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

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

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

setCharacterStream

void setCharacterStream(String parameterName,
                        Reader reader)
                 throws SQLException

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

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

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

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

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value)
                  throws SQLException

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

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

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

Параметры:
parameterName - имя параметра
value - значение параметра
Исключения:
SQLException - если имя параметра не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого 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 - если имя параметра не соответствует именованному параметру; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого 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 - если преобразование не поддерживается, тип null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С момента:
1.7

getObject

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

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

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

Параметры типа:
T - тип класса, моделируемого этим объектом Class
Параметры:
parameterName - имя параметра
type - Класс, представляющий тип данных Java, в который преобразовать указанный параметр.
Возвращает:
экземпляр type, содержащий значение параметра ВЫХОД
Исключения:
SQLException - если преобразование не поддерживается, тип 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
См. также:
JDBCType, SQLType

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 тип, который будет отправлен в базу данных
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный targetSqlType
С:
1.8
См. также:
JDBCType, SQLType

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, которая принимает значение масштаба.
Исключения:
SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный sqlType
С:
1.8
См. также:
JDBCType, SQLType

registerOutParameter

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

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

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

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

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

Параметры:
parameterIndex - первый параметр - 1, второй - 2 и так далее
sqlType - код типа JDBC, определенный SQLType, который используется для регистрации параметра ВЫХОД.
scale - требуемое количество цифр справа от десятичной точки. Должно быть больше или равно нулю.
Исключения:
SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный sqlType
С:
1.8
См. также:
JDBCType, SQLType

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

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

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

Параметры:
parameterIndex - первый параметр - 1, второй - 2,...
sqlType - код типа JDBC, определенный SQLType, используемый для регистрации параметра ВЫХОД.
typeName - полное квалифицированное имя SQL структурированного типа
Исключения:
SQLException - если parameterIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный sqlType
С:
1.8
См. также:
JDBCType, SQLType

registerOutParameter

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

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

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

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

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

Параметры:
parameterName - имя параметра
sqlType - код типа JDBC, определенный SQLType, который используется для регистрации параметра ВЫХОД. Если параметр имеет JDBC тип JDBCType.NUMERIC или JDBCType.DECIMAL, следует использовать версию registerOutParameter, которая принимает значение масштаба.
Исключения:
SQLException - если parameterName не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает указанный sqlType или если драйвер JDBC не поддерживает этот метод
С:
1.8
См. также:
JDBCType, SQLType

registerOutParameter

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

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

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

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

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

Параметры:
parameterName - имя параметра
sqlType - код типа JDBC, определенный SQLType, для регистрации параметра OUT.
scale - желаемое количество цифр после запятой. Оно должно быть больше или равно нулю.
Исключения:
SQLException - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает указанный sqlType или если JDBC драйвер не поддерживает этот метод
С тех пор:
1.8
См. также:
JDBCType, SQLType

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 структурированного типа
Исключения:
SQLException - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом CallableStatement
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает указанный sqlType или если JDBC драйвер не поддерживает этот метод
С тех пор:
1.8
См. также:
JDBCType, SQLType

© 1993, 2020, 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/11/docs/api/java.sql/java/sql/CallableStatement.html

Spec-Zone .ru
спецификации, руководства, описания, API