Интерфейс CallableStatement

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

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

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

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

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

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

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

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

boolean wasNull() throws SQLException

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

String getString(int parameterIndex) throws SQLException

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

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

boolean getBoolean(int parameterIndex) throws SQLException

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

byte getByte(int parameterIndex) throws SQLException

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

short getShort(int parameterIndex) throws SQLException

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

int getInt(int parameterIndex) throws SQLException

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

long getLong(int parameterIndex) throws SQLException

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

float getFloat(int parameterIndex) throws SQLException

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

double getDouble(int parameterIndex) throws SQLException

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

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

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

byte[] getBytes(int parameterIndex) throws SQLException

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

Date getDate(int parameterIndex) throws SQLException

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

Time getTime(int parameterIndex) throws SQLException

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

Timestamp getTimestamp(int parameterIndex) throws SQLException

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

Object getObject(int parameterIndex) throws SQLException

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

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

BigDecimal getBigDecimal(int parameterIndex) throws SQLException

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

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

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

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

Ref getRef(int parameterIndex) throws SQLException

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

Blob getBlob(int parameterIndex) throws SQLException

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

Clob getClob(int parameterIndex) throws SQLException

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

Array getArray(int parameterIndex) throws SQLException

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

Date getDate(int parameterIndex, Calendar cal) throws SQLException

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

Time getTime(int parameterIndex, Calendar cal) throws SQLException

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

Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException

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

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 типу параметра.

void registerOutParameter(String parameterName, int sqlType) throws SQLException

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

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

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

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

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

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

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

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

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

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

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

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

URL getURL(int parameterIndex) throws SQLException

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

void setURL(String parameterName, URL val) throws SQLException

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

void setNull(String parameterName, int sqlType) throws SQLException

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

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

void setBoolean(String parameterName, boolean x) throws SQLException

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

void setByte(String parameterName, byte x) throws SQLException

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

void setShort(String parameterName, short x) throws SQLException

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

void setInt(String parameterName, int x) throws SQLException

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

void setLong(String parameterName, long x) throws SQLException

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

void setFloat(String parameterName, float x) throws SQLException

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

void setDouble(String parameterName, double x) throws SQLException

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

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

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

void setString(String parameterName, String x) throws SQLException

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

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

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

void setDate(String parameterName, Date x) throws SQLException

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

void setTime(String parameterName, Time x) throws SQLException

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

void setTimestamp(String parameterName, Timestamp x) throws SQLException

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

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

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

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

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

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

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

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

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

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

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

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

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

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).

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

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

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

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

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

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

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

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

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

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

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

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

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

String getString(String parameterName) throws SQLException

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

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

boolean getBoolean(String parameterName) throws SQLException

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

byte getByte(String parameterName) throws SQLException

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

short getShort(String parameterName) throws SQLException

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

int getInt(String parameterName) throws SQLException

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

long getLong(String parameterName) throws SQLException

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

float getFloat(String parameterName) throws SQLException

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

double getDouble(String parameterName) throws SQLException

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

byte[] getBytes(String parameterName) throws SQLException

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

Date getDate(String parameterName) throws SQLException

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

Time getTime(String parameterName) throws SQLException

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

Timestamp getTimestamp(String parameterName) throws SQLException

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

Object getObject(String parameterName) throws SQLException

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

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

BigDecimal getBigDecimal(String parameterName) throws SQLException

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

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

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

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

Ref getRef(String parameterName) throws SQLException

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

Blob getBlob(String parameterName) throws SQLException

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

Clob getClob(String parameterName) throws SQLException

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

Array getArray(String parameterName) throws SQLException

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

Date getDate(String parameterName, Calendar cal) throws SQLException

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

Time getTime(String parameterName, Calendar cal) throws SQLException

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

Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException

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

URL getURL(String parameterName) throws SQLException

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

RowId getRowId(int parameterIndex) throws SQLException

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

RowId getRowId(String parameterName) throws SQLException

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

void setRowId(String parameterName, RowId x) throws SQLException

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

void setNString(String parameterName, String value) throws SQLException

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

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

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

void setNClob(String parameterName, NClob value) throws SQLException

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

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

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

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

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

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

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

NClob getNClob(int parameterIndex) throws SQLException

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

NClob getNClob(String parameterName) throws SQLException

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

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

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

SQLXML getSQLXML(int parameterIndex) throws SQLException

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

SQLXML getSQLXML(String parameterName) throws SQLException

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

String getNString(int parameterIndex) throws SQLException

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

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

String getNString(String parameterName) throws SQLException

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

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

Reader getNCharacterStream(int parameterIndex) throws SQLException

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

Reader getNCharacterStream(String parameterName) throws SQLException

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

Reader getCharacterStream(int parameterIndex) throws SQLException

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

Reader getCharacterStream(String parameterName) throws SQLException

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

void setBlob(String parameterName, Blob x) throws SQLException

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

void setClob(String parameterName, Clob x) throws SQLException

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

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

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

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

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

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

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

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

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

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

void setAsciiStream(String parameterName, InputStream x) throws SQLException

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

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

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

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

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

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

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

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

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

void setClob(String parameterName, Reader reader) throws SQLException

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

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

void setBlob(String parameterName, InputStream inputStream) throws SQLException

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

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

void setNClob(String parameterName, Reader reader) throws SQLException

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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