Spec-Zone.ru › OpenJDK 8

Интерфейс CallableStatement

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

public interface CallableStatement
extends PreparedStatement

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

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

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

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

См. также:
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)

Регистрирует параметр ВЫХОД parameterIndex с типом JDBC sqlType.
void registerOutParameter(int parameterIndex, int sqlType, int scale)

Регистрирует параметр в позиционном порядке parameterIndex с типом JDBC sqlType.
void registerOutParameter(int parameterIndex, int sqlType, String typeName)

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

Регистрирует параметр ВЫХОД parameterIndex с типом JDBC sqlType.
default void registerOutParameter(int parameterIndex, SQLType sqlType, int scale)

Регистрирует параметр в позиционном порядке parameterIndex с типом JDBC sqlType.
default void registerOutParameter(int parameterIndex, SQLType sqlType, String typeName)

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

Регистрирует параметр ВЫХОД с именем parameterName с типом JDBC sqlType.
void registerOutParameter(String parameterName, int sqlType, int scale)

Регистрирует параметр с именем parameterName с типом JDBC sqlType.
void registerOutParameter(String parameterName, int sqlType, String typeName)

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

Регистрирует параметр ВЫХОД с именем parameterName с типом JDBC sqlType.
default void registerOutParameter(String parameterName, SQLType sqlType, int scale)

Регистрирует параметр с именем parameterName с типом JDBC sqlType.
default void registerOutParameter(String parameterName, SQLType sqlType, String typeName)

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

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

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

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

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

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

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

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

Устанавливает указанный параметр в заданный объект java.sql.Blob.
void setBlob(String parameterName, InputStream inputStream)

Устанавливает указанный параметр в объект InputStream.
void setBlob(String parameterName, InputStream inputStream, long length)

Устанавливает указанный параметр в объект InputStream.
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, Clob x)

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

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

Устанавливает указанный параметр в объект Reader.
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, NClob value)

Устанавливает указанный параметр в объект java.sql.NClob.
void setNClob(String parameterName, Reader reader)

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

Устанавливает указанный параметр в объект Reader.
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()

Возвращает, имело ли последнее считываемое значение параметра OUT значение SQL NULL.

Методы, унаследованные от интерфейса java.sql.PreparedStatement

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

Методы, унаследованные от интерфейса java.sql.Statement

addBatch, cancel, clearBatch, clearWarnings, close, closeOnCompletion, 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, setCursorName, setEscapeProcessing, setFetchDirection, setFetchSize, setLargeMaxRows, setMaxFieldSize, setMaxRows, setPoolable, setQueryTimeout

Методы, унаследованные от интерфейса java.sql.Wrapper

isWrapperFor, unwrap

Методы

registerOutParameter

void registerOutParameter(int parameterIndex,
                          int sqlType)
                   throws SQLException

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

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

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

Параметры:
parameterIndex - первый параметр имеет номер 1, второй - 2 и так далее
sqlType - код типа JDBC, определённый в java.sql.Types. Если параметр имеет тип JDBC NUMERIC или DECIMAL, следует использовать версию registerOutParameter, которая принимает значение масштаба.
Исключения:
SQLException - если параметр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. Все параметры ВЫХОД должны быть зарегистрированы перед выполнением хранимой процедуры.

Тип JDBC, указанный значением sqlType для параметра ВЫХОД, определяет тип 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

Возвращает значение, указывающее, содержал ли последний параметр ВЫХОД значение 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
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 и так далее
Возвращает:
объект java.lang.Object, содержащий значение параметра 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
Возвращает:
объект java.lang.Object, содержащий значение параметра 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, и именованные массивы.

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

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

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

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

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

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

registerOutParameter

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

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

Тип JDBC, указанный в sqlType для выходного параметра, определяет тип 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 и именованные массивы.

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

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

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

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

setBoolean

void setBoolean(String parameterName,
                boolean x)
         throws SQLException

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

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

setByte

void setByte(String parameterName,
             byte x)
      throws SQLException

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

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

setShort

void setShort(String parameterName,
              short x)
       throws SQLException

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

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

setInt

void setInt(String parameterName,
            int x)
     throws SQLException

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

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

setLong

void setLong(String parameterName,
             long x)
      throws SQLException

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

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

setFloat

void setFloat(String parameterName,
              float x)
       throws SQLException

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

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

setDouble

void setDouble(String parameterName,
               double x)
        throws SQLException

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

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

setBigDecimal

void setBigDecimal(String parameterName,
                   BigDecimal x)
            throws SQLException

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

Параметры:
parameterName - имя параметра
x - значение параметра
Исключения:
SQLException - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом 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 - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом 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 в формат символов базы данных.

Примечание: Этот объект потока может быть стандартным объектом потока 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 Object в типы SQL. Указанный аргумент будет преобразован в соответствующий тип SQL перед отправкой в базу данных.

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

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

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

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

setCharacterStream

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

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

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

Параметры:
parameterName - имя параметра
reader - объект java.io.Reader, содержащий данные UNICODE, используемые в качестве указанного параметра
length - количество символов в потоке
Исключения:
SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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, этот метод может быть использован для установки параметра NULL любого JDBC типа. Если параметр не имеет пользовательского или REF типа, заданное значение typeName игнорируется.

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

getString

String getString(String parameterName)
          throws SQLException

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

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

Параметры:
parameterName - имя параметра
Возвращает:
значение параметра. Если значение – SQL NULL, результат – null.
Исключения:
SQLException - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - если имя параметра не соответствует именованному параметру; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта 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 - имя параметра
Возвращает:
Объект, содержащий значение параметра 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
Возвращает:
объект, содержащий значение параметра 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 - если имя параметра не соответствует имени параметра; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого 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, в противном случае будет сгенерирована ошибка SQLException, когда CallableStatement будет выполнен. Этот метод отличается от метода 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, в противном случае будет сгенерирована ошибка SQLException, когда CallableStatement будет выполнен. Этот метод отличается от метода setBinaryStream (int, InputStream, int), потому что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. Когда используется метод setBinaryStream, драйверу может потребоваться выполнить дополнительные действия для определения, следует ли отправлять данные параметра на сервер как LONGVARBINARY или BLOB

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

setNClob

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

Устанавливает указанный параметр в объект Reader. reader должен содержать количество символов, указанное в length, в противном случае будет сгенерирована ошибка SQLException, когда CallableStatement будет выполнен. Этот метод отличается от метода 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 - если параметр parameterIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом 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 в формат символов базы данных.

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

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

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

setBinaryStream

void setBinaryStream(String parameterName,
                     InputStream x)
              throws SQLException

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

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

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

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

setNCharacterStream

void setNCharacterStream(String parameterName,
                         Reader value)
                  throws SQLException

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

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

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

setClob

void setClob(String parameterName,
             Reader reader)
      throws SQLException

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

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

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

setBlob

void setBlob(String parameterName,
             InputStream inputStream)
      throws SQLException

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

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

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

setNClob

void setNClob(String parameterName,
              Reader reader)
       throws SQLException

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

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

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

getObject

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

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

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

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

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

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

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

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

Параметры:
parameterIndex - первый параметр имеет индекс 1, второй - 2 и так далее
sqlType - код JDBC типа, определенный в SQLType, для регистрации параметра OUT. Если параметр имеет 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. Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

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

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

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

Параметры:
parameterIndex - первый параметр имеет индекс 1, второй - 2, и так далее
sqlType - код JDBC типа, определенный в SQLType, для регистрации параметра OUT.
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, и именованные массивы типов.

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

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

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

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

Параметры:
parameterIndex - первый параметр имеет индекс 1, второй - 2, и так далее
sqlType - код JDBC типа, определенный в SQLType, для регистрации параметра OUT.
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. Все параметры OUT должны быть зарегистрированы перед выполнением хранимой процедуры.

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

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

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

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

registerOutParameter

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

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

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

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

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

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

registerOutParameter

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

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

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

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

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

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

Параметры:
parameterName - имя параметра
sqlType - код типа JDBC, определенный в SQLType, используемый для регистрации параметра ВЫХОД.
typeName - полное квалифицированное имя SQL-структурированного типа
Исключения:
SQLException - если имя параметра не соответствует имени параметра; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает указанный sqlType или не поддерживает этот метод
С:
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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API