Интерфейс CallableStatement

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

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

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

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

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

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

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 long. Драйвер преобразует это значение в SQL BIGINT значение при отправке в базу данных.

void setFloat(String parameterName, float x) throws SQLException

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

void setDouble(String parameterName, double x) throws SQLException

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

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

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

void setString(String parameterName, String x) throws SQLException

Устанавливает указанный параметр в заданное значение Java String. Драйвер преобразует это значение в 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-объект будет преобразован в указанный targetSqlType перед отправкой в базу данных. Если объект имеет пользовательское отображение (является классом, реализующим интерфейс SQLData), драйвер JDBC должен вызвать метод SQLData.writeSQL для записи его в SQL-поток данных. Если, с другой стороны, объект является классом, реализующим Ref, 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 типа, заданное имя типа игнорируется.

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 должен содержать количество символов, указанное параметром length, иначе при выполнении CallableStatement будет сгенерирована SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int), поскольку он сообщает драйверу, что значение параметра должно быть отправлено на сервер как CLOB. При использовании метода setCharacterStream, драйверу может потребоваться выполнить дополнительные действия для определения, следует ли отправлять данные параметра на сервер как LONGVARCHAR или CLOB.

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

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

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

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

Примечание: Обратитесь к документации драйвера 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. Если эти условия не выполняются, драйвер базы данных сгенерирует SQLException при выполнении подготовленного запроса.

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

Реализация по умолчанию выбросит 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 игнорируется.

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

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