Класс BaseRowSet

java.lang.Object
- javax.sql.rowset.BaseRowSet

Все реализуемые интерфейсы:: Serializable, Cloneable

public abstract class BaseRowSet
extends Object
implements Serializable, Cloneable

Абстрактный класс, предоставляющий объект RowSet со своей базовой функциональностью. Базовые функции включают свойства и отправку уведомлений об событиях, которые должны реализовывать все компоненты JavaBeans™.

1.0 Обзор

Класс BaseRowSet предоставляет основную функциональность для всех реализаций RowSet, и все стандартные реализации могут использовать этот класс в сочетании с одним или несколькими интерфейсами RowSet для предоставления стандартной реализации, специфичной для поставщика. Для уточнения, все реализации должны реализовывать по крайней мере один из интерфейсов RowSet (JdbcRowSet, CachedRowSet, JoinRowSet, FilteredRowSet или WebRowSet). Это означает, что любая реализация, расширяющая класс BaseRowSet, также должна реализовывать один из интерфейсов RowSet.

Класс BaseRowSet предоставляет следующее:

Свойства
- Поля для хранения текущих свойств
- Методы для получения и установки свойств
Уведомления об событиях
Полный набор методов установки для установки параметров в команде объекта RowSet
Потоки
- Поля для хранения экземпляров потоков
- Константы для указания типа потока

2.0 Установка свойств

Все наборы строк поддерживают набор свойств, которые обычно устанавливаются с помощью инструмента. Количество и типы свойств набора строк будут различаться в зависимости от того, что делает реализация RowSet и как она получает свои данные. Например, наборы строк, получающие данные из объекта ResultSet, должны установить свойства, необходимые для создания соединения с базой данных. Если объект RowSet использует механизм DriverManager для создания соединения, ему необходимо установить свойство для JDBC-URL, определяющего соответствующий драйвер, а также установить свойства для имени пользователя и пароля. Если же набор строк использует объект DataSource для создания соединения, что является предпочтительным методом, ему не нужно устанавливать свойство для JDBC-URL. Вместо этого ему необходимо установить свойство для логического имени источника данных вместе со свойствами для имени пользователя и пароля.

ПРИМЕЧАНИЕ: Для использования объекта DataSource для создания соединения объект DataSource должен быть зарегистрирован в службе именования, использующей API Java Naming and Directory Interface™ (JNDI). Эта регистрация обычно выполняется администратором системы.

3.0 Установка команды и ее параметров

Когда набор строк получает данные из реляционной базы данных, он выполняет команду (запрос), которая создает объект ResultSet. Этот запрос является командой, которая устанавливается для свойства команды объекта RowSet. Набор строк заполняет себя данными, считывая данные из объекта ResultSet в себя. Если запрос содержит плейсхолдеры для значений, которые необходимо установить, для установки этих значений используются методы установки BaseRowSet. Все методы установки позволяют установить эти значения в null, если это необходимо.

Следующий фрагмент кода демонстрирует, как можно установить свойство команды для объекта CachedRowSet™ объект crs. Обратите внимание, что если используется инструмент для установки свойств, это тот код, который использует инструмент.

crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");

В этом примере значения для CREDIT_LIMIT и REGION являются параметрами-заместителями, которые обозначаются знаком вопроса (?). Первый знак вопроса — параметр-заполнитель номер 1, второй знак вопроса — параметр-заполнитель номер 2 и так далее. Все параметры-заменители должны быть установлены со значениями перед выполнением запроса. Для установки этих параметров-заменителей класс BaseRowSet предоставляет набор методов установки, аналогичных методам интерфейса PreparedStatement, для установки значений каждого типа данных. Объект RowSet хранит значения параметров в своей внутренней структуре, и метод execute использует их для установки значений параметров-заменителей перед отправкой команды в СУБД для выполнения.

Следующий фрагмент кода демонстрирует установку двух параметров в запросе из предыдущего примера.

crs.setInt(1, 5000);
    crs.setString(2, "West");

Если в этот момент вызвать метод execute, отправленный в СУБД запрос будет:

"SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > 5000 AND REGION = 'West'"

ПРИМЕЧАНИЕ: Установка объектов Array, Clob, Blob и Ref в качестве параметра команды сохраняет эти значения как объекты SerialArray, SerialClob, SerialBlob и SerialRef соответственно.

4.0 Обработка параметров за кулисами

ПРИМЕЧАНИЕ: Класс BaseRowSet предоставляет два типа методов установки: для установки свойств и для установки параметров-заменителей. Методы установки, рассматриваемые в этом разделе, — это те, которые устанавливают параметры-заменители.

Параметры-заменители, установленные с помощью методов установки BaseRowSet, хранятся как объекты во внутреннем объекте Hashtable. Примитивы хранятся в виде их типов Object. Например, byte хранится как объект Byte, а int — как объект Integer. При вызове метода execute значения в объекте Hashtable подставляются соответствующим параметрам-заместителям в команде.

Вызов метода getParams возвращает значения, хранящиеся в объекте Hashtable, в виде массива экземпляров Object. Элемент в этом массиве может быть простым экземпляром Object или массивом (который является типом Object). Используемый метод установки определяет, является ли элемент в этом массиве экземпляром Object или массивом.

Большинство методов для установки параметров-заменителей принимают два параметра, где первый параметр указывает, какой параметр-заполнитель устанавливается, а второй — устанавливаемое значение. Методы, такие как setInt, setString, setBoolean и setLong, относятся к этой категории. После вызова этих методов вызов метода getParams вернёт массив со значениями, которые были установлены. Каждый элемент массива — это экземпляр Object, представляющий установленные значения. Порядок этих значений в массиве определяется параметром int (первый параметр), переданным в метод установки. Значения в массиве — это значения (второй параметр), переданные методу установки. Другими словами, первый элемент массива — значение, которое будет установлено для первого параметра-заменителя в команде объекта RowSet. Второй элемент — значение, которое будет установлено для второго параметра-заменителя и так далее.

Некоторые методы установки передают драйверу и СУБД информацию, помимо устанавливаемого значения. При вызове метода getParams после использования одного из этих методов установки элементы в массиве будут сами являться массивами, чтобы вместить дополнительную информацию. В эту категорию входит метод setNull, так как одна из его версий принимает только два параметра (setNull(int parameterIndex, int SqlType)). Тем не менее, ему требуется массив для хранения информации, которая будет передана драйверу и СУБД. Первый элемент в этом массиве — устанавливаемое значение, которое является null, а второй элемент — значение int для sqlType, которое указывает тип SQL-значения, устанавливаемого в null. Эта информация необходима некоторым СУБД, поэтому требуется для обеспечения переносимости приложений. Другая версия предназначена для использования, когда устанавливаемое значение для null — это пользовательский тип данных. Она принимает три параметра (setNull(int parameterIndex, int sqlType, String typeName)) и также требует массив для хранения информации, которая будет передана драйверу и СУБД. Первые два элемента этого массива такие же, как и для первой версии метода setNull. Третий элемент, typeName, указывает SQL-имя пользовательского типа данных. Как и в других методах установки, номер параметра-заменителя, который нужно установить, определяется положением элемента в массиве, возвращаемом методом getParams. Например, если параметр, переданный методу setNull, равен 2, то второй элемент в массиве, возвращаемом методом getParams, будет массивом из двух или трех элементов.

Некоторые методы, такие как setObject и setDate, имеют версии, которые принимают более двух параметров, дополнительные параметры предоставляют информацию драйверу или СУБД. Например, методы setDate, setTime и setTimestamp могут принимать объект Calendar в качестве своего третьего параметра. Если СУБД не хранит информацию о часовом поясе, драйвер использует объект Calendar для построения объектов Date, Time или Timestamp, которые устанавливаются. Как и в других методах, предоставляющих дополнительную информацию, элементом в массиве, возвращаемом методом getParams, является массив вместо простого экземпляра Object.

Методы setAsciiStream, setBinaryStream, setCharacterStream и setUnicodeStream (который устарел, поэтому приложения должны использовать getCharacterStream вместо него) принимают три параметра, поэтому для них элемент в массиве, возвращаемом методом getParams, также является массивом. Отличием этих методов установки является то, что помимо информации, предоставленной параметрами, массив содержит одну из констант BaseRowSet, указывающих тип устанавливаемого потока.

ПРИМЕЧАНИЕ: Метод getParams вызывается внутри реализаций RowSet, расширяющих этот класс; обычно он не вызывается программистом приложения напрямую.

5.0 Уведомления об событиях

Класс BaseRowSet предоставляет механизм уведомления об событиях для наборов строк. Он содержит поле listeners, методы для добавления и удаления слушателей и методы для уведомления слушателей об изменениях.

Слушатель — это объект, реализующий интерфейс RowSetListener. Если он был добавлен в список слушателей объекта RowSet, он будет уведомлен при возникновении события в этом объекте RowSet. Реализация каждого слушателя методов RowSetListener определяет, что этот объект будет делать, когда он будет уведомлён о наступлении события.

Возможны три события для объекта RowSet:

перемещение курсора
изменение отдельной строки (обновление, удаление или вставка)
изменение содержимого всего объекта RowSet

Метод BaseRowSet, используемый для уведомлений, указывает тип произошедшего события. Например, метод notifyRowChanged указывает, что строка была обновлена, удалена или вставлена. Каждый из методов уведомления создает объект RowSetEvent, который предоставляется слушателю для идентификации объекта RowSet, на котором произошло событие. Что делает слушатель с этой информацией (возможно, ничего) зависит от его реализации.

6.0 Поведение по умолчанию

Объект BaseRowSet по умолчанию инициализируется со многими начальными значениями. Следующее верно для экземпляра по умолчанию RowSet, расширяющего класс BaseRowSet:

Имеет прокручиваемый курсор и не отображает изменения, внесённые другими.
Подлежит обновлению.
Не отображает строки, которые были удалены.
Не имеет временного ограничения на время выполнения команды объекта драйвера RowSet.
Не имеет ограничения на количество строк.
Не имеет ограничения на количество байт, которое может содержать столбец. ПРИМЕЧАНИЕ: Это ограничение применяется только к столбцам, которые содержат значения следующих типов: BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR и LONGVARCHAR.
Не будет видеть несохранённые данные (получение «грязных» данных).
Обработка escape включена.
Тип карты соединения установлен на null.
Имеет пустой объект Vector для хранения значений, установленных для параметров-заполнителей в команде объекта RowSet.

Если требуются другие значения, приложение должно явно установить значения свойств. Например, следующая строка кода устанавливает максимальное количество строк для объекта CachedRowSet crs в 500.

crs.setMaxRows(500);

Методы, реализованные в расширениях этого класса BaseRowSet, обязаны генерировать объект SQLException при любом нарушении определённых утверждений. Кроме того, если расширяемый класс переопределяет и повторно реализует метод BaseRowSet и сталкивается с проблемами подключения или проблемы с источником данных, этот метод может дополнительно генерировать объект SQLException по этой причине.

С момента:: 1.5
См. также:: Сериализованная форма

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

Модификатор и тип	Поле	Описание
`static int`	`ASCII_STREAM_PARAM`	Константа, указывающая объекту `RowSetReaderImpl`, что данный параметр является потоком ASCII.
`protected InputStream`	`asciiStream`	Объект `InputStream`, который будет возвращён методом `getAsciiStream`, указанным в интерфейсе `ResultSet`.
`static int`	`BINARY_STREAM_PARAM`	Константа, указывающая объекту `RowSetReaderImpl`, что данный параметр является двоичным потоком.
`protected InputStream`	`binaryStream`	Объект `InputStream`, который будет возвращён методом `getBinaryStream`, указанным в интерфейсе `ResultSet`.
`protected Reader`	`charStream`	Объект `Reader`, который будет возвращён методом `getCharacterStream`, указанным в интерфейсе `ResultSet`.
`static int`	`UNICODE_STREAM_PARAM`	Константа, указывающая объекту `RowSetReaderImpl`, что данный параметр является потоком Unicode.
`protected InputStream`	`unicodeStream`	Объект `InputStream`, который будет возвращён методом `getUnicodeStream`, указанным в интерфейсе `ResultSet`.

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

Конструктор	Описание
`BaseRowSet()`	Создаёт новый объект `BaseRowSet`, инициализированный объектом по умолчанию `Vector` для его поля `listeners`.

Методы

Модификатор и тип	Метод	Описание
`void`	`addRowSetListener(RowSetListener listener)`	Слушатель будет уведомлен всякий раз, когда произойдёт событие на этом объекте `RowSet`.
`void`	`clearParameters()`	Очищает все текущие значения параметров во внутренней представлении параметров объекта `RowSet`, которые должны быть установлены в команде объекта `RowSet` при её выполнении.
`String`	`getCommand()`	Возвращает SQL-запрос, являющийся командой для этого объекта `RowSet`.
`int`	`getConcurrency()`	Возвращает конкуретность для этого объекта `RowSet`.
`String`	`getDataSourceName()`	Возвращает логическое имя, которое, когда предоставляется службе именования, использующей API Java Naming and Directory Interface (JNDI), извлекает объект `javax.sql.DataSource`.
`boolean`	`getEscapeProcessing()`	Определяет, включена ли обработка экранирования для этого объекта `RowSet`.
`int`	`getFetchDirection()`	Возвращает текущее значение направления извлечения для этого объекта `RowSet`.
`int`	`getFetchSize()`	Возвращает размер извлечения для этого объекта `RowSet`.
`int`	`getMaxFieldSize()`	Возвращает максимальное количество байтов, которое может быть использовано для значения столбца в этом объекте `RowSet`.
`int`	`getMaxRows()`	Возвращает максимальное количество строк, которое может содержать этот объект `RowSet`.
`Object[]`	`getParams()`	Возвращает массив, содержащий значения параметров (как объекты, так и примитивы), которые были установлены для команды этого объекта `RowSet`, и выбрасывает объект `SQLException`, если не все параметры не были установлены.
`String`	`getPassword()`	Возвращает пароль, используемый для создания подключения к базе данных для этого объекта `RowSet`.
`int`	`getQueryTimeout()`	Возвращает максимальное количество секунд, которое драйвер будет ожидать выполнения запроса.
`boolean`	`getShowDeleted()`	Возвращает `boolean`, указывающий, отображаются ли строки, помеченные для удаления, в наборе текущих строк.
`int`	`getTransactionIsolation()`	Возвращает свойство изоляции транзакции для подключения этого объекта `RowSet`.
`int`	`getType()`	Возвращает тип этого объекта `RowSet`.
`Map<String,Class<?>>`	`getTypeMap()`	Возвращает карту типов, связанную с объектом `Connection` для этого объекта `RowSet`.
`String`	`getUrl()`	Возвращает JDBC URL, который объект `RowSet` использует для создания соединения с реляционной базой данных с помощью драйвера, поддерживающего технологию JDBC.
`String`	`getUsername()`	Возвращает имя пользователя, используемое для создания подключения к базе данных.
`protected void`	`initParams()`	Выполняет необходимые внутренние настройки и инициализации, чтобы любая реализация JDBC `RowSet` могла начать использовать стандартные средства, предоставляемые экземпляром `BaseRowSet`.
`boolean`	`isReadOnly()`	Возвращает `boolean`, указывающий, является ли этот объект `RowSet` только для чтения.
`protected void`	`notifyCursorMoved()`	Уведомляет всех зарегистрированных слушателей с этим объектом `RowSet`, что его курсор переместился.
`protected void`	`notifyRowChanged()`	Уведомляет всех зарегистрированных слушателей с этим объектом `RowSet`, что одна из его строк изменилась.
`protected void`	`notifyRowSetChanged()`	Уведомляет всех зарегистрированных слушателей с этим объектом `RowSet`, что всё его содержимое изменилось.
`void`	`removeRowSetListener(RowSetListener listener)`	Удаляет указанный объект из списка слушателей этого объекта `RowSet`.
`void`	`setArray(int parameterIndex, Array array)`	Устанавливает указанный параметр в объект `Array` языка программирования Java.
`void`	`setAsciiStream(int parameterIndex, InputStream x)`	Устанавливает указанный параметр в команде этого объекта `RowSet` в задаваемый поток ввода.
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)`	Устанавливает указанный параметр в задаваемый объект `java.io.InputStream`, который будет содержать указанное количество байтов.
`void`	`setAsciiStream(String parameterName, InputStream x)`	Устанавливает указанный параметр в задаваемый поток ввода.
`void`	`setAsciiStream(String parameterName, InputStream x, int length)`	Устанавливает указанный параметр в задаваемый поток ввода, который будет содержать указанное количество байтов.
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)`	Устанавливает указанный параметр в задаваемое значение `java.lang.BigDecimal`.
`void`	`setBigDecimal(String parameterName, BigDecimal x)`	Устанавливает указанный параметр в задаваемое значение `java.math.BigDecimal`.
`void`	`setBinaryStream(int parameterIndex, InputStream x)`	Устанавливает указанный параметр в команде этого объекта `RowSet` в задаваемый поток ввода.
`void`	`setBinaryStream(int parameterIndex, InputStream x, int length)`	Устанавливает указанный параметр в задаваемый объект `java.io.InputStream`, который будет содержать указанное количество байтов.
`void`	`setBinaryStream(String parameterName, InputStream x)`	Устанавливает указанный параметр в задаваемый поток ввода.
`void`	`setBinaryStream(String parameterName, InputStream x, int length)`	Устанавливает указанный параметр в задаваемый поток ввода, который будет содержать указанное количество байтов.
`void`	`setBlob(int parameterIndex, InputStream inputStream)`	Устанавливает указанный параметр в объект `InputStream`.
`void`	`setBlob(int parameterIndex, InputStream inputStream, long length)`	Устанавливает указанный параметр в объект `InputStream`.
`void`	`setBlob(int parameterIndex, Blob x)`	Устанавливает указанный параметр в задаваемый объект `Blob` на языке программирования Java.
`void`	`setBlob(String parameterName, InputStream inputStream)`	Устанавливает указанный параметр в объект `InputStream`.
`void`	`setBlob(String parameterName, InputStream inputStream, long length)`	Устанавливает указанный параметр в объект `InputStream`.
`void`	`setBlob(String parameterName, Blob x)`	Устанавливает указанный параметр в задаваемый объект `java.sql.Blob`.
`void`	`setBoolean(int parameterIndex, boolean x)`	Устанавливает указанный параметр в задаваемое значение `boolean` на языке программирования Java.
`void`	`setBoolean(String parameterName, boolean x)`	Устанавливает указанный параметр в задаваемое значение Java `boolean`.
`void`	`setByte(int parameterIndex, byte x)`	Устанавливает указанный параметр в задаваемое значение `byte` на языке программирования Java.
`void`	`setByte(String parameterName, byte x)`	Устанавливает указанный параметр в задаваемое значение Java `byte`.
`void`	`setBytes(int parameterIndex, byte[] x)`	Устанавливает указанный параметр в задаваемый массив байтов.
`void`	`setBytes(String parameterName, byte[] x)`	Устанавливает указанный параметр в задаваемый Java массив байтов.
`void`	`setCharacterStream(int parameterIndex, Reader reader)`	Устанавливает указанный параметр в команде этого объекта `RowSet` в задаваемый объект `Reader`.
`void`	`setCharacterStream(int parameterIndex, Reader reader, int length)`	Устанавливает указанный параметр в задаваемый объект `java.io.Reader`, который будет содержать указанное количество символов.
`void`	`setCharacterStream(String parameterName, Reader reader)`	Устанавливает указанный параметр в задаваемый объект `Reader`.
`void`	`setCharacterStream(String parameterName, Reader reader, int length)`	Устанавливает указанный параметр в задаваемый объект `Reader`, длина которого равна заданному числу символов.

`void`	`setClob(int parameterIndex, Reader reader)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setClob(int parameterIndex, Reader reader, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setClob(int parameterIndex, Clob x)`	Устанавливает указанный параметр в объект `Clob` в языке программирования Java.
`void`	`setClob(String parameterName, Reader reader)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setClob(String parameterName, Reader reader, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setClob(String parameterName, Clob x)`	Устанавливает указанный параметр в объект `java.sql.Clob`.
`void`	`setCommand(String cmd)`	Устанавливает свойство `command` объекта `RowSet` в заданный объект `String` и очищает параметры, если таковые были установлены для предыдущей команды.
`void`	`setConcurrency(int concurrency)`	Устанавливает конкуретность для объекта `RowSet` в указанную конкуретность.
`void`	`setDataSourceName(String name)`	Устанавливает свойство имени `DataSource` для объекта `RowSet` в заданное логическое имя и устанавливает свойство Url объекта `RowSet` в `null`.
`void`	`setDate(int parameterIndex, Date x)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`.
`void`	`setDate(int parameterIndex, Date x, Calendar cal)`	Устанавливает указанный параметр в заданный объект `java.sql.Date`.
`void`	`setDate(String parameterName, Date x)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`, используя по умолчанию часовой пояс виртуальной машины, на которой выполняется приложение.
`void`	`setDate(String parameterName, Date x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`, используя заданный объект `Calendar`.
`void`	`setDouble(int parameterIndex, double x)`	Устанавливает указанный параметр в заданное значение `double` в языке программирования Java.
`void`	`setDouble(String parameterName, double x)`	Устанавливает указанный параметр в заданное Java значение `double`.
`void`	`setEscapeProcessing(boolean enable)`	Устанавливает для заданного `boolean`, будет ли драйвер сканировать синтаксис экранирования и выполнять замену экранирования перед отправкой SQL-запросов в базу данных.
`void`	`setFetchDirection(int direction)`	Предоставляет драйверу подсказку о направлении обработки строк в объекте `RowSet`.
`void`	`setFetchSize(int rows)`	Устанавливает размер выборки для объекта `RowSet` в заданное число строк.
`void`	`setFloat(int parameterIndex, float x)`	Устанавливает указанный параметр в заданное значение `float` в языке программирования Java.
`void`	`setFloat(String parameterName, float x)`	Устанавливает указанный параметр в заданное Java значение `float`.
`void`	`setInt(int parameterIndex, int x)`	Устанавливает указанный параметр в объект `int` в языке программирования Java.
`void`	`setInt(String parameterName, int x)`	Устанавливает указанный параметр в заданное Java значение `int`.
`void`	`setLong(int parameterIndex, long x)`	Устанавливает указанный параметр в заданное значение `long` в языке программирования Java.
`void`	`setLong(String parameterName, long x)`	Устанавливает максимальное количество байтов, которое может быть использовано для значения столбца в этом объекте `RowSet`, в заданное значение.
`void`	`setMaxFieldSize(int max)`	Устанавливает максимальное количество строк, которое может содержать этот объект `RowSet`, в заданное значение.
`void`	`setMaxRows(int max)`	Устанавливает указанный параметр в объекте команды этого объекта `RowSet` в объект `Reader`.
`void`	`setNCharacterStream(int parameterIndex, Reader value, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNCharacterStream(String parameterName, Reader value)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNCharacterStream(String parameterName, Reader value, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(int parameterIndex, Reader reader)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(int parameterIndex, Reader reader, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(int parameterIndex, NClob value)`	Устанавливает указанный параметр в объект `java.sql.NClob`.
`void`	`setNClob(String parameterName, Reader reader)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(String parameterName, Reader reader, long length)`	Устанавливает указанный параметр в объект `Reader`.
`void`	`setNClob(String parameterName, NClob value)`	Устанавливает указанный параметр в объект `java.sql.NClob`.
`void`	`setNString(int parameterIndex, String value)`	Устанавливает указанный параметр в заданный объект `String`.
`void`	`setNString(String parameterName, String value)`	Устанавливает указанный параметр в заданный объект `String`.
`void`	`setNull(int parameterIndex, int sqlType)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setNull(int parameterIndex, int sqlType, String typeName)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setNull(String parameterName, int sqlType)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setNull(String parameterName, int sqlType, String typeName)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setNull(String parameterName, int sqlType, String typeName)`	Устанавливает указанный параметр в SQL `NULL`.
`void`	`setObject(int parameterIndex, Object x)`	Устанавливает указанный параметр в объект `Object` в языке программирования Java.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType)`	Устанавливает значение указанного параметра в заданное значение `Object`.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType, int scale)`	Устанавливает указанный параметр в объект `Object` в языке программирования Java.
`void`	`setObject(String parameterName, Object x)`	Устанавливает значение указанного параметра в заданный объект.
`void`	`setObject(String parameterName, Object x, int targetSqlType)`	Устанавливает значение указанного параметра в заданный объект.
`void`	`setObject(String parameterName, Object x, int targetSqlType, int scale)`	Устанавливает значение указанного параметра в заданный объект.
`void`	`setPassword(String pass)`	Устанавливает пароль, используемый для создания подключения к базе данных для объекта `RowSet`, в заданный объект `String`.
`void`	`setQueryTimeout(int seconds)`	Устанавливает максимальное время ожидания выполнения запроса драйвером в заданное количество секунд.
`void`	`setReadOnly(boolean value)`	Устанавливает свойство readOnly объекта `RowSet` в заданное значение `boolean`.
`void`	`setRef(int parameterIndex, Ref ref)`	Устанавливает указанный параметр в заданный объект `Ref` в языке программирования Java.
`void`	`setRowId(int parameterIndex, RowId x)`	Устанавливает указанный параметр в заданный объект `java.sql.RowId`.
`void`	`setRowId(String parameterName, RowId x)`	Устанавливает указанный параметр в заданный объект `java.sql.RowId`.
`void`	`setShort(int parameterIndex, short x)`	Устанавливает указанный параметр в заданное значение `short` в языке программирования Java.

`void`	`setShort(String parameterName, short x)`	Устанавливает указанный параметр в заданное значение Java `short`.
`void`	`setShowDeleted(boolean value)`	Устанавливает свойство `showDeleted` в заданное значение `boolean`, которое определяет, отображаются ли строки, помеченные на удаление, в наборе текущих строк.
`void`	`setSQLXML(int parameterIndex, SQLXML xmlObject)`	Устанавливает указанный параметр в заданный объект `java.sql.SQLXML`.
`void`	`setSQLXML(String parameterName, SQLXML xmlObject)`	Устанавливает указанный параметр в заданный объект `java.sql.SQLXML`.
`void`	`setString(int parameterIndex, String x)`	Устанавливает указанный параметр в заданное значение `String`.
`void`	`setString(String parameterName, String x)`	Устанавливает указанный параметр в заданное значение Java `String`.
`void`	`setTime(int parameterIndex, Time x)`	Устанавливает указанный параметр в заданное значение `java.sql.Time`.
`void`	`setTime(int parameterIndex, Time x, Calendar cal)`	Устанавливает указанный параметр в заданный объект `java.sql.Time`.
`void`	`setTime(String parameterName, Time x)`	Устанавливает указанный параметр в заданное значение `java.sql.Time`.
`void`	`setTime(String parameterName, Time x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Time`, используя заданный объект `Calendar`.
`void`	`setTimestamp(int parameterIndex, Timestamp x)`	Устанавливает указанный параметр в заданное значение `java.sql.Timestamp`.
`void`	`setTimestamp(int parameterIndex, Timestamp x, Calendar cal)`	Устанавливает указанный параметр в заданный объект `java.sql.Timestamp`.
`void`	`setTimestamp(String parameterName, Timestamp x)`	Устанавливает указанный параметр в заданное значение `java.sql.Timestamp`.
`void`	`setTimestamp(String parameterName, Timestamp x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Timestamp`, используя заданный объект `Calendar`.
`void`	`setTransactionIsolation(int level)`	Устанавливает свойство изоляции транзакции для этого объекта JDBC `RowSet` в заданную константу.
`void`	`setType(int type)`	Устанавливает тип для этого объекта `RowSet` в указанный тип.
`void`	`setTypeMap(Map<String,Class<?>> map)`	Устанавливает заданный объект `java.util.Map` в качестве карты типов, связанной с объектом `Connection` для этого объекта `RowSet`.
`void`	`setUnicodeStream(int parameterIndex, InputStream x, int length)`	Устарело. Вместо этого следует использовать getCharacterStream
`void`	`setUrl(String url)`	Устанавливает свойство Url для этого объекта `RowSet` в заданный объект `String` и устанавливает свойство имени источника данных в `null`.
`void`	`setURL(int parameterIndex, URL x)`	Устанавливает указанный параметр в заданное значение `java.net.URL`.
`void`	`setUsername(String name)`	Устанавливает свойство имени пользователя для этого объекта `RowSet` в заданное имя пользователя.

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Поля

UNICODE_STREAM_PARAM

public static final int UNICODE_STREAM_PARAM

Константа, указывающая объекту RowSetReaderImpl, что заданный параметр является потоком Unicode. Этот объект RowSetReaderImpl предоставляется в качестве расширения абстрактного класса SyncProvider, определённого в механизме SPI статической фабрики SyncFactory.

См. также:: Значения постоянных полей

BINARY_STREAM_PARAM

public static final int BINARY_STREAM_PARAM

Константа, указывающая объекту RowSetReaderImpl, что заданный параметр является двоичным потоком. Объект RowSetReaderImpl предоставляется в качестве расширения абстрактного класса SyncProvider, определённого в механизме SPI статической фабрики SyncFactory.

См. также:: Значения постоянных полей

ASCII_STREAM_PARAM

public static final int ASCII_STREAM_PARAM

Константа, указывающая объекту RowSetReaderImpl, что заданный параметр является потоком ASCII. Объект RowSetReaderImpl предоставляется в качестве расширения абстрактного класса SyncProvider, определённого в механизме SPI статической фабрики SyncFactory.

См. также:: Значения постоянных полей

binaryStream

protected InputStream binaryStream

Объект InputStream, который будет возвращён методом getBinaryStream, указанным в интерфейсе ResultSet.

unicodeStream

protected InputStream unicodeStream

Объект InputStream, который будет возвращён методом getUnicodeStream, указанным в интерфейсе ResultSet.

asciiStream

protected InputStream asciiStream

Объект InputStream, который будет возвращён методом getAsciiStream, указанным в интерфейсе ResultSet.

charStream

protected Reader charStream

Объект Reader, который будет возвращён методом getCharacterStream, указанным в интерфейсе ResultSet.

Конструкторы

BaseRowSet

public BaseRowSet()

Создаёт новый объект BaseRowSet, инициализированный по умолчанию объектом Vector для своего поля listeners. Другие значения по умолчанию, с которыми он инициализирован, указаны в разделе 6.0 комментария к классу для этого класса.

Методы

initParams

protected void initParams()

Выполняет необходимые внутренние настройки и инициализации, чтобы любой JDBC RowSet-реализации можно было начать использовать стандартные средства, предоставляемые экземпляром BaseRowSet. Этот метод должен вызываться после создания объекта RowSet для правильной инициализации всех параметров. Этот метод не должен вызываться приложением, но вызывается из реализации RowSet, расширяющей этот класс.

addRowSetListener

public void addRowSetListener(RowSetListener listener)

Слушатель будет уведомлен всякий раз, когда произойдет событие в этом объекте RowSet.

Слушатель может, например, быть таблицей или графиком, которые нужно обновить, чтобы точно отразить текущее состояние объекта RowSet.

Примечание: если объект RowSetListener находится в состоянии null, этот метод игнорирует значение null и не добавляет null-ссылку в набор слушателей.

Примечание: если слушатель уже установлен, и новый экземпляр RowSetListener добавляется в набор слушателей, уже зарегистрированных для получения уведомлений о событиях от этого объекта RowSet.

Параметры:: listener — объект, реализующий интерфейс javax.sql.RowSetListener и желающий получать уведомления о событиях, происходящих в этом объекте RowSet; может быть null.
См. также:: removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

public void removeRowSetListener(RowSetListener listener)

Удаляет указанный объект из списка слушателей этого объекта RowSet. Если переданный аргумент не является зарегистрированным слушателем, этот метод ничего не делает. Примечание: если объект RowSetListener находится в состоянии null, этот метод игнорирует значение null.

Параметры:: listener — объект RowSetListener, присутствующий в списке слушателей этого объекта RowSet.
См. также:: addRowSetListener(javax.sql.RowSetListener)

notifyCursorMoved

protected void notifyCursorMoved()
                          throws SQLException

Уведомляет всех слушателей, зарегистрированных с этим объектом RowSet, о перемещении его курсора.

Когда приложение вызывает метод для перемещения курсора, этот метод перемещает курсор и затем вызывает этот метод внутри. Приложение не должно вызывать этот метод напрямую.

Исключения:: SQLException — если класс, расширяющий абстрактный класс BaseRowSet, не реализует интерфейс RowSet или один из его под-интерфейсов.

notifyRowChanged

protected void notifyRowChanged()
                         throws SQLException

Уведомляет всех слушателей, зарегистрированных с этим объектом RowSet, что одна из его строк изменилась.

Когда приложение вызывает метод, изменяющий строку, такой как методы CachedRowSet insertRow, updateRow или deleteRow, этот метод вызывает notifyRowChanged внутри. Приложение не должно вызывать этот метод напрямую.

Исключения:: SQLException — если класс, расширяющий абстрактный класс BaseRowSet, не реализует интерфейс RowSet или один из его под-интерфейсов.

notifyRowSetChanged

protected void notifyRowSetChanged()
                            throws SQLException

Уведомляет всех слушателей, зарегистрированных с этим объектом RowSet, что все его содержимое изменилось.

Когда приложение вызывает методы, изменяющие все содержимое объекта RowSet, такие как методы CachedRowSet execute, populate, restoreOriginal или release, этот метод вызывает notifyRowSetChanged внутри (прямо или косвенно). Приложение не должно вызывать этот метод напрямую.

Исключения:: SQLException — если класс, расширяющий абстрактный класс BaseRowSet, не реализует интерфейс RowSet или один из его под-интерфейсов.

getCommand

public String getCommand()

Возвращает SQL-запрос, который является командой для этого объекта RowSet. Свойство command содержит запрос, который будет выполнен для заполнения этого объекта RowSet.

SQL-запрос, возвращаемый этим методом, используется методами RowSet, такими как execute и populate, которые могут быть реализованы любым классом, расширяющим абстрактный класс BaseRowSet и реализующим один или несколько стандартных интерфейсов JSR-114 RowSet.

Команда используется чтецом объекта RowSet для получения объекта ResultSet. Затем чтец считывает данные из объекта ResultSet и использует их для заполнения этого объекта RowSet.

Значение по умолчанию для свойства command равно null.

Возвращает:: значение String для свойства RowSet объекта command; может быть null
См. также:: setCommand(java.lang.String)

setCommand

public void setCommand(String cmd)
                throws SQLException

Устанавливает свойство RowSet объекта command на заданный объект String и очищает параметры, если они были заданы для предыдущей команды.

Свойство command может не потребоваться, если объект RowSet получает данные из источника, не поддерживающего команды, например, из таблицы или другого табличного файла. Таким образом, это свойство является необязательным и может быть null.

Параметры:: cmd — объект String, содержащий SQL-запрос, который будет установлен как свойство команды этого объекта RowSet; может быть null, но не пустой строкой
Исключения:: SQLException — если в качестве значения команды предоставлена пустая строка
См. также:: getCommand()

getUrl

public String getUrl()
              throws SQLException

Возвращает JDBC-URL, который использует объект RowSet для подключения к реляционной базе данных с помощью драйвера, поддерживающего JDBC-технологию.

Свойство Url будет null, если базовый источник данных — это источник данных, не поддерживающий SQL, например, таблица или XML-источник данных.

Возвращает:: объект String, содержащий JDBC-URL, используемый для установления соединения для этого объекта RowSet; может быть null (значение по умолчанию), если не задано
Исключения:: SQLException — если при получении значения URL произошла ошибка
См. также:: setUrl(java.lang.String)

setUrl

public void setUrl(String url)
            throws SQLException

Устанавливает свойство Url для этого объекта RowSet на указанный объект String и устанавливает свойство имени источника данных на null. Свойство Url — это JDBC-URL, используемый при создании соединения с помощью драйвера, поддерживающего JDBC-технологию ("JDBC-драйвер"), и объекта DriverManager. Правильный JDBC-URL для используемого драйвера можно найти в документации драйвера. Хотя существуют рекомендации по формированию JDBC-URL, поставщик драйвера может указать любой объект String, кроме объекта длиной 0 (пустая строка).

Установка свойства Url необязательна, если соединения устанавливаются с помощью объекта DataSource вместо объекта DriverManager. Драйвер будет использовать либо свойство URL, либо свойство dataSourceName для создания соединения, в зависимости от того, какое из них было указано последним. Если приложение использует JDBC-URL, оно должно загрузить JDBC-драйвер, который принимает JDBC-URL, прежде чем использовать объект RowSet для подключения к базе данных. Объект RowSet будет использовать URL внутри для создания подключения к базе данных для чтения или записи данных.

Параметры:: url — объект String, содержащий JDBC-URL, который будет использован для установления соединения с базой данных для этого объекта RowSet; может быть null, но не должен быть пустой строкой
Исключения:: SQLException — если при установке свойства Url произошла ошибка или переданный параметр — строка длиной 0 (пустая строка)
См. также:: getUrl()

getDataSourceName

public String getDataSourceName()

Возвращает логическое имя, которое, когда передаётся в службу именования, использующую API Java Naming and Directory Interface (JNDI), возвращает объект javax.sql.DataSource. Этот объект DataSource может быть использован для установления соединения с источником данных, который он представляет.

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

Возвращает:: объект String, идентифицирующий объект DataSource, который будет использован для создания соединения; если логическое имя не установлено, возвращается null.
См. также:: setDataSourceName(java.lang.String)

setDataSourceName

public void setDataSourceName(String name)
                       throws SQLException

Устанавливает свойство имени источника данных для этого объекта RowSet на указанное логическое имя и устанавливает свойство Url этого объекта RowSet на null. Имя должно быть связано с объектом DataSource в службе именования JNDI, чтобы приложение могло выполнить поиск по этому имени для получения объекта DataSource, связанного с ним. Затем объект DataSource может быть использован для установления соединения с источником данных, который он представляет.

Пользователи должны установить либо свойство Url, либо свойство dataSourceName. Если оба свойства установлены, драйвер будет использовать свойство, установленное последним.

Параметры:: name - объект String с именем, которое может быть передано в службу именования на основе технологии JNDI для получения объекта DataSource, который может быть использован для получения соединения; может быть null, но не должно быть пустой строкой
Исключения:: SQLException - если в качестве имени DataSource предоставлена пустая строка
См. также:: getDataSourceName()

getUsername

public String getUsername()

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

Возвращает:: объект String, содержащий имя пользователя, которое предоставляется источнику данных для создания подключения; может быть null (значение по умолчанию), если не задано
См. также:: setUsername(java.lang.String)

setUsername

public void setUsername(String name)

Устанавливает свойство username для этого объекта RowSet заданному имени пользователя. Поскольку оно не сериализуется, свойство username устанавливается во время выполнения перед вызовом метода execute.

Параметры:: name - объект String, содержащий имя пользователя, которое предоставляется источнику данных для создания подключения. Может быть null.
См. также:: getUsername()

getPassword

public String getPassword()

Возвращает пароль, используемый для создания подключения к базе данных для этого объекта RowSet. Поскольку свойство password не сериализуется, оно устанавливается во время выполнения перед вызовом метода execute. Значение по умолчанию — null.

Возвращает:: объект String, представляющий пароль, который должен быть предоставлен базе данных для создания подключения
См. также:: setPassword(java.lang.String)

setPassword

public void setPassword(String pass)

Устанавливает пароль, используемый для создания подключения к базе данных для этого объекта RowSet, на заданный объект String. Поскольку свойство password не сериализуется, оно устанавливается во время выполнения перед вызовом метода execute.

Параметры:: pass - объект String, представляющий пароль, который предоставляется базе данных для создания подключения. Может быть null.
См. также:: getPassword()

setType

public void setType(int type)
             throws SQLException

Устанавливает тип для этого объекта RowSet на указанный тип. Тип по умолчанию — ResultSet.TYPE_SCROLL_INSENSITIVE.

Параметры:: type - одно из следующих констант: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE
Исключения:: SQLException - если переданный параметр не является одной из следующих констант: ResultSet.TYPE_FORWARD_ONLY или ResultSet.TYPE_SCROLL_INSENSITIVE ResultSet.TYPE_SCROLL_SENSITIVE
См. также:: getConcurrency(), getType()

getType

public int getType()
            throws SQLException

Возвращает тип этого объекта RowSet. Тип изначально определяется оператором, который создал объект RowSet. Объект RowSet может в любое время вызвать метод setType для изменения своего типа. Значение по умолчанию — TYPE_SCROLL_INSENSITIVE.

Возвращает:: тип этого JDBC-объекта RowSet, который должен быть одним из следующих: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE
Исключения:: SQLException - если при получении типа этого объекта RowSet произошла ошибка
См. также:: setType(int)

setConcurrency

public void setConcurrency(int concurrency)
                    throws SQLException

Устанавливает конкурентность для этого объекта RowSet на указанную конкурентность. Конкурентность по умолчанию для любого объекта RowSet (подключенного или отключенного) — ResultSet.CONCUR_UPDATABLE, но этот метод можно вызвать в любое время для изменения конкурентности.

Параметры:: concurrency - одно из следующих констант: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE
Исключения:: SQLException - если переданный параметр не является одной из следующих констант: ResultSet.CONCUR_UPDATABLE или ResultSet.CONCUR_READ_ONLY
См. также:: getConcurrency(), isReadOnly()

isReadOnly

public boolean isReadOnly()

Возвращает значение, указывающее, является ли этот объект RowSet только для чтения. Любые попытки обновить объект RowSet только для чтения приведут к выбросу исключения SQLException. По умолчанию наборы строк являются изменяемыми, если обновления возможны.

Возвращает:: true, если этот объект RowSet не может быть обновлён; false в противном случае
См. также:: setConcurrency(int), setReadOnly(boolean)

setReadOnly

public void setReadOnly(boolean value)

Устанавливает свойство readOnly этого объекта RowSet в заданное значение boolean.

Параметры:: value - true, чтобы указать, что этот объект RowSet является только для чтения; false, чтобы указать, что он изменяемый

getTransactionIsolation

public int getTransactionIsolation()

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

Для реализаций RowSet, таких как CachedRowSet, которые работают в автономном режиме, объект SyncProvider предлагает дополнительные параметры блокировки и целостности данных. Описанные ниже параметры применимы только к подключённым объектам RowSet (объекты JdbcRowSet).

Возвращает:: одну из следующих констант: Connection.TRANSACTION_NONE, Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE
См. также:: SyncFactory, SyncProvider, setTransactionIsolation(int)

setTransactionIsolation

public void setTransactionIsolation(int level)
                             throws SQLException

Устанавливает свойство изоляции транзакций для этого объекта JDBC RowSet на заданную константу. СУБД будет использовать этот уровень изоляции транзакций для транзакций, если это возможно.

Для реализаций RowSet, таких как CachedRowSet, которые работают в автономном режиме, используемый объект SyncProvider предоставляет дополнительные параметры блокировки и целостности данных. Описанные ниже параметры применимы только к подключённым объектам RowSet (объекты JdbcRowSet).

Параметры:: level - одна из следующих констант, указанных в порядке возрастания: Connection.TRANSACTION_NONE, Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE
Исключения:: SQLException - если заданный параметр не является одной из констант Connection
См. также:: SyncFactory, SyncProvider, getTransactionIsolation()

getTypeMap

public Map<String,Class<?>> getTypeMap()

Возвращает карту типов, связанную с объектом Connection для этого объекта RowSet.

Драйверы, поддерживающие API JDBC 3.0, создают объекты Connection с связанной картой типов. Эта карта типов, которая изначально пуста, может содержать одно или несколько полных квалифицированных имён SQL и объекты Class, указывающие класс, к которому будет сопоставлено указанное имя SQL. Сопоставление типов, указанное в карте типов соединения, используется для пользовательского сопоставления типов, когда ни одна другая карта типов его не заменяет.

Если карта типов явно предоставлена методу, который может выполнить пользовательское сопоставление, эта карта типов будет использоваться вместо карты типов соединения.

Возвращает:: объект java.util.Map, который является картой типов для подключения этого объекта RowSet

setTypeMap

public void setTypeMap(Map<String,Class<?>> map)

Устанавливает заданный объект java.util.Map в качестве карты типов, связанной с объектом Connection для этого объекта RowSet. Пользовательское сопоставление, указанное в этой карте типов, будет использоваться, если метод не явно укажет другую карту типов, в этом случае будет использоваться предоставленная карта типов.

Параметры:: map - объект java.util.Map, который содержит сопоставление между именами SQL-типов для пользовательских типов (UDT) и классами в языке программирования Java. Каждый элемент объекта Map состоит из полного квалифицированного SQL-имени UDT и объекта Class для реализации SQLData этого UDT. Может быть null.

getMaxFieldSize

public int getMaxFieldSize()
                    throws SQLException

Возвращает максимальное количество байтов, которое может быть использовано для значения столбца в этом объекте RowSet. Это ограничение применяется только к столбцам, содержащим значения следующих типов: BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR и LONGVARCHAR. Если предел превышен, избыточные данные молча отбрасываются.

Возвращает:: число int, указывающее текущее максимальное ограничение размера столбца; ноль означает, что ограничений нет
Исключения:: SQLException - если при внутренней проверке максимального размера столбца произошла ошибка

setMaxFieldSize

public void setMaxFieldSize(int max)
                     throws SQLException

Устанавливает максимальное количество байтов, которое может быть использовано для значения столбца в этом объекте RowSet, заданному числу. Это ограничение применяется только к столбцам, которые содержат значения следующих типов: BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR и LONGVARCHAR. Если предел превышен, избыточные данные отбрасываются без уведомления. Для максимальной переносимости рекомендуется использовать значения, большие, чем 256.

Параметры:: max - int, указывающий новый предел максимального размера столбца; ноль означает отсутствие ограничения
Исключения:: SQLException - если (1) при внутреннем установлении максимального предела размера столбца возникает ошибка или (2) задан размер меньше 0

getMaxRows

public int getMaxRows()
               throws SQLException

Возвращает максимальное количество строк, которое может содержать этот объект RowSet. Если этот предел превышен, избыточные строки отбрасываются без уведомления.

Возвращает:: int, указывающий текущее максимальное количество строк; ноль означает отсутствие ограничения
Исключения:: SQLException - если при внутреннем определении максимального предела строк, которые может содержать объект Rowset, возникает ошибка

setMaxRows

public void setMaxRows(int max)
                throws SQLException

Устанавливает максимальное количество строк, которое может содержать этот объект RowSet, заданному числу. Если этот предел превышен, избыточные строки отбрасываются без уведомления.

Параметры:: max - int, указывающий текущее максимальное количество строк; ноль означает отсутствие ограничения
Исключения:: SQLException - если при внутреннем установлении максимального предела количества строк для объекта JDBC RowSet возникает ошибка; или если max меньше 0; или если max меньше fetchSize объекта RowSet

setEscapeProcessing

public void setEscapeProcessing(boolean enable)
                         throws SQLException

Устанавливает, будет ли драйвер сканировать синтаксис экранирования и выполнять замену экранирования перед отправкой SQL-запросов в базу данных, заданному значению boolean. По умолчанию драйвер выполняет обработку экранирования.

Примечание: Поскольку объекты PreparedStatement обычно анализируются до вызова этого метода, отключение обработки экранирования для подготовленных запросов, скорее всего, не повлияет.

Параметры:: enable - true для включения обработки экранирования; false для её отключения
Исключения:: SQLException - если при установке обработки синтаксиса экранирования в драйвере JDBC возникает ошибка

getQueryTimeout

public int getQueryTimeout()
                    throws SQLException

Возвращает максимальное количество секунд, которое драйвер будет ждать выполнения запроса. Если предел превышен, выбрасывается исключение SQLException.

Возвращает:: текущее ограничение таймаута запроса в секундах; ноль означает отсутствие ограничения
Исключения:: SQLException - если при определении значения таймаута запроса возникает ошибка

setQueryTimeout

public void setQueryTimeout(int seconds)
                     throws SQLException

Устанавливает заданное число в качестве максимального количества секунд, которые драйвер будет ждать выполнения запроса. Если предел превышен, выбрасывается исключение SQLException.

Параметры:: seconds - новое ограничение таймаута запроса в секундах; ноль означает отсутствие ограничения; не должно быть меньше нуля
Исключения:: SQLException - если при установке таймаута запроса возникает ошибка или значение таймаута запроса меньше 0

getShowDeleted

public boolean getShowDeleted()
                       throws SQLException

Возвращает boolean, указывающее, отображаются ли строки, помеченные для удаления, в наборе текущих строк. Значение по умолчанию - false.

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

Возвращает:: true, если строки, помеченные для удаления, видны; false в противном случае
Исключения:: SQLException - если при определении видимости строк, помеченных для удаления, возникает ошибка
См. также:: setShowDeleted(boolean)

setShowDeleted

public void setShowDeleted(boolean value)
                    throws SQLException

Устанавливает свойство showDeleted в заданное значение boolean, определяющее, отображаются ли строки, помеченные для удаления, в наборе текущих строк.

Параметры:: value - true, если строки, помеченные для удаления, должны отображаться; false в противном случае
Исключения:: SQLException - если при установке видимости строк, помеченных для удаления, возникает ошибка
См. также:: getShowDeleted()

getEscapeProcessing

public boolean getEscapeProcessing()
                            throws SQLException

Определяет, включена ли обработка экранирования для этого объекта RowSet.

Возвращает:: true, если обработка экранирования включена; false в противном случае
Исключения:: SQLException - если при определении состояния обработки экранирования или если внутренний триггер обработки экранирования не был включен, возникает ошибка

setFetchDirection

public void setFetchDirection(int direction)
                       throws SQLException

Даёт драйверу подсказку о направлении обработки строк в этом объекте RowSet. Драйвер может проигнорировать эту подсказку.

Объект RowSet наследует свойства по умолчанию от объекта ResultSet, из которого он получил данные. Направление выборки по умолчанию этого объекта ResultSet устанавливается объектом Statement, который его создал.

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

Объект RowSet может использовать этот метод в любое время для изменения своего параметра направления выборки.

Параметры:: direction - одно из значений ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN
Исключения:: SQLException - если (1) тип RowSet равен TYPE_FORWARD_ONLY, и заданное направление выборки не равно FETCH_FORWARD, или (2) заданное направление выборки не является одним из следующих: ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN
См. также:: getFetchDirection()

getFetchDirection

public int getFetchDirection()
                      throws SQLException

Возвращает текущее значение параметра направления выборки этого объекта RowSet. Тип по умолчанию - ResultSet.FETCH_FORWARD

Возвращает:: одно из значений ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN
Исключения:: SQLException - если при определении текущего направления выборки для извлечения строк возникает ошибка
См. также:: setFetchDirection(int)

setFetchSize

public void setFetchSize(int rows)
                  throws SQLException

Устанавливает размер выборки для этого объекта RowSet заданному количеству строк. Размер выборки даёт драйверу JDBC ("драйвер JDBC") подсказку о количестве строк, которое следует извлечь из базы данных при необходимости получения дополнительных строк для этого объекта RowSet. Если указанный размер выборки равен нулю, драйвер игнорирует это значение и может сам сделать наиболее подходящий вывод о том, каким должен быть размер выборки.

Объект RowSet наследует свойства по умолчанию от объекта ResultSet, из которого он получил данные. Размер выборки по умолчанию этого объекта ResultSet устанавливается объектом Statement, который его создал.

Этот метод применим к объекту RowSet только во время подключения к базе данных с помощью драйвера JDBC. Для подключенных реализаций RowSet, таких как JdbcRowSet, этот метод оказывает непосредственное и немедленное влияние на подлежащий драйвер JDBC.

Объект RowSet может использовать этот метод в любое время для изменения своего параметра размера выборки.

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

Параметры:: rows - количество строк для выборки; 0, чтобы драйвер сам решил, какой размер выборки использовать; не должно быть меньше 0 или больше максимального количества строк, разрешённого для данного объекта RowSet (число, возвращаемое методом getMaxRows())
Исключения:: SQLException - если заданный размер выборки меньше 0 или больше предела максимального количества строк
См. также:: getFetchSize()

getFetchSize

public int getFetchSize()
                 throws SQLException

Возвращает размер выборки для этого объекта RowSet. Значение по умолчанию равно нулю.

Возвращает:: количество строк, предлагаемое как размер выборки, когда этому объекту RowSet требуются дополнительные строки из базы данных
Исключения:: SQLException - если при определении количества строк в текущем размере выборки возникает ошибка
См. также:: setFetchSize(int)

getConcurrency

public int getConcurrency()
                   throws SQLException

Возвращает конкурентность для этого объекта RowSet. По умолчанию это CONCUR_UPDATABLE для подключенных и разъединённых объектов RowSet.

Приложение может вызвать метод setConcurrency в любое время, чтобы изменить конкурентность объекта RowSet.

Возвращает:: тип конкурентности для этого объекта RowSet, который должен быть одним из следующих: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE
Выбрасывает:: SQLException - если произошла ошибка при получении конкурентности этого объекта RowSet
См. также:: setConcurrency(int), isReadOnly()

setNull

public void setNull(int parameterIndex,
                    int sqlType)
             throws SQLException

Устанавливает указанный параметр в SQL NULL. Обратите внимание, что тип SQL параметра должен быть указан с помощью одного из кодов типов, определенных в java.sql.Types. Этот тип SQL указан во втором параметре.

Обратите внимание, что второй параметр сообщает СУБД о типе данных значения, устанавливаемого для NULL. Некоторые СУБД требуют этой информации, поэтому она необходима для повышения портативности кода.

Значение параметра, установленное этим методом, хранится в памяти и будет передано как соответствующий параметр в команде объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Вызовы метода getParams после вызова этой версии setNull вернут массив Object, содержащий значения установленных параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива - null. Второй элемент - значение, установленное для sqlType. Номер параметра указан позицией элемента в массиве, возвращаемом методом getParams, где первый элемент - значение для первого параметра-заполнителя, второй элемент - значение для второго параметра-заполнителя и так далее. Другими словами, если второй параметр-заполнитель устанавливается в значение null, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Обратите внимание, что так как нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий номеру параметра-заполнителя parameterIndex, равен parameterIndex - 1.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде объекта RowSet, который должен быть установлен. Первый параметр - 1, второй - 2 и так далее; должен быть 1 или больше; sqlType - значение int, которое является одним из кодов типов SQL, определенных в классе Types. Если предоставлен нестандартный sqlType, этот метод не будет выбрасывать SQLException. Это позволяет неявно поддерживать нестандартные типы SQL.
Выбрасывает:: SQLException - если произошла ошибка доступа к базе данных или указанный индекс параметра находится вне границ
См. также:: getParams()

setNull

public void setNull(int parameterIndex,
                    int sqlType,
                    String typeName)
             throws SQLException

Устанавливает указанный параметр в SQL NULL. Хотя эта версия метода setNull предназначена для параметров, определенных пользователем, и REF параметров, этот метод может быть использован для установки нулевого параметра для любого типа JDBC. К типам, определенным пользователем, относятся: STRUCT, DISTINCT и JAVA_OBJECT, а также типы массивов с именем.

Примечание: Для обеспечения портативности приложения должны передавать код типа SQL и полное квалифицированное имя типа SQL при указании параметра, определённого пользователем, или NULL параметра. В случае типа, определённого пользователем, имя является именем типа самого параметра. Для параметра REF имя является именем типа ссылаемого типа. Если технология JDBC не нуждается в коде типа или информации о имени типа, она может ее игнорировать.

Если параметр не имеет типа, определенного пользователем, или REF типа, заданный параметр typeName игнорируется.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Вызовы метода getParams после вызова этой версии setNull вернут массив Object, содержащий значения установленных параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива - null. Второй элемент - значение, установленное для sqlType, а третий - значение, установленное для typeName. Номер параметра указан позицией элемента в массиве, возвращаемом методом getParams, где первый элемент - значение для первого параметра-заполнителя, второй элемент - значение для второго параметра-заполнителя и так далее. Другими словами, если второй параметр-заполнитель устанавливается в значение null, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде объекта RowSet, который должен быть установлен. Первый параметр - 1, второй - 2 и так далее; должен быть 1 или больше; sqlType - значение из java.sql.Types; typeName - полное квалифицированное имя пользовательского SQL типа, которое игнорируется, если параметр не является пользовательским типом или имеет значение REF
Выбрасывает:: SQLException - если произошла ошибка или указанный индекс параметра находится вне границ
См. также:: getParams()

setBoolean

public void setBoolean(int parameterIndex,
                       boolean x)
                throws SQLException

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

Значение параметра, установленное этим методом, хранится в памяти и будет передано как соответствующий параметр в команде объекта RowSet при вызове метода execute. Методы, такие как execute, populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде объекта RowSet, который должен быть установлен. Первый параметр - 1, второй - 2 и так далее; должен быть 1 или больше; x - значение параметра
Выбрасывает:: SQLException - если произошла ошибка или индекс параметра находится вне границ
См. также:: getParams()

setByte

public void setByte(int parameterIndex,
                    byte x)
             throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде объекта RowSet, который должен быть установлен. Первый параметр - 1, второй - 2 и так далее; должен быть 1 или больше; x - значение параметра
Выбрасывает:: SQLException - если произошла ошибка или индекс параметра находится вне границ
См. также:: getParams()

setShort

public void setShort(int parameterIndex,
                     short x)
              throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде объекта RowSet, который должен быть установлен. Первый параметр - 1, второй - 2 и так далее; должен быть 1 или больше; x - значение параметра
Выбрасывает:: SQLException - если произошла ошибка или индекс параметра находится вне границ
См. также:: getParams()

setInt

public void setInt(int parameterIndex,
                   int x)
            throws SQLException

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

Значение параметра, установленное этим методом, сохраняется внутри и будет предоставлено в качестве соответствующего параметра в команде этого объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setLong

public void setLong(int parameterIndex,
                    long x)
             throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setFloat

public void setFloat(int parameterIndex,
                     float x)
              throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setDouble

public void setDouble(int parameterIndex,
                      double x)
               throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setBigDecimal

public void setBigDecimal(int parameterIndex,
                          BigDecimal x)
                   throws SQLException

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

Примечание: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setString

public void setString(int parameterIndex,
                      String x)
               throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setBytes

public void setBytes(int parameterIndex,
                     byte[] x)
              throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй — 2 и т.д.; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setDate

public void setDate(int parameterIndex,
                    Date x)
             throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Вызовы метода getParams после вызова этого варианта setDate вернут массив со значением, которое будет установлено для параметра-заполнителя с номером parameterIndex, — объектом Date, переданным во втором параметре. Обратите внимание, что поскольку нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет индекс parameterIndex - 1.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - значение параметра
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setTime

public void setTime(int parameterIndex,
                    Time x)
             throws SQLException

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

Значение параметра, установленное этим методом, хранится внутри и будет предоставлено как соответствующий параметр в команде этого объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определён в этом классе.

Вызовы метода getParams после вызова этого варианта метода setTime вернут массив установленных параметров. Параметр для параметра-заполнителя с номером parameterIndex будет объектом Time, который был установлен в качестве второго параметра этого метода.

Обратите внимание, что поскольку нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет индекс parameterIndex - 1.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - объект java.sql.Time, который должен быть установлен в качестве значения для параметра-заполнителя parameterIndex
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp x)
                  throws SQLException

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

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определён в этом классе.

Вызовы метода getParams после вызова этого варианта setTimestamp вернут массив, где значение для параметра-заполнителя с номером parameterIndex — это объект Timestamp, переданный в качестве второго параметра этому методу. Обратите внимание, что поскольку нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет индекс parameterIndex -1.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - объект java.sql.Timestamp
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           InputStream x,
                           int length)
                    throws SQLException

Устанавливает указанный параметр в предоставленный объект java.io.InputStream, который будет иметь указанное количество байтов. Содержимое потока будет считано и отправлено в базу данных. Этот метод вызывает исключение SQLException, если количество прочитанных и отправленных в базу данных байтов не равно length.

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

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

Примечание: JdbcRowSet не требует метода populate, так как он не определён в этом классе.

Вызовы метода getParams после вызова setAsciiStream вернут массив, содержащий установленные значения параметров. Элемент в массиве, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — предоставленный объект java.io.InputStream. Второй элемент — значение, установленное для length. Третий элемент — внутренняя константа BaseRowSet, указывающая, что поток, переданный этому методу, является потоком ASCII. Номер параметра определяется позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и так далее. Другими словами, если вводимый поток устанавливает значение для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом массива, возвращаемого методом getParams.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - входной поток Java, содержащий значение ASCII-параметра; length - количество байтов в потоке. Это количество байтов, которое драйвер отправит в СУБД; значения 0 или меньше не определены, но приведут к исключению с неверным значением длины в базовом драйвере JDBC.
Исключения:: SQLException - если произошла ошибка, индекс параметра находится вне допустимого диапазона или при подключении к источнику данных количество байтов, прочитанных и отправленных драйвером в базу данных, не равно количеству байтов, указанных в length
См. также:: getParams()

setAsciiStream

public void setAsciiStream(int parameterIndex,
                           InputStream x)
                    throws SQLException

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

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

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

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            InputStream x,
                            int length)
                     throws SQLException

Устанавливает указанный параметр в заданный объект java.io.InputStream, который будет содержать указанное количество байтов. Содержимое потока будет считано и отправлено в базу данных. Этот метод выбрасывает объект SQLException, если количество байтов, прочитанных и отправленных в базу данных, не равно length.

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

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

Значение параметра, установленное этим методом, хранится внутри и будет передано в качестве соответствующего параметра в команде этого объекта RowSet, когда будет вызван метод execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определён в этом классе.

Вызовы метода getParams после вызова setBinaryStream вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный объект java.io.InputStream. Второй элемент — значение, установленное для length. Третий элемент — внутренняя константа BaseRowSet, указывающая, что поток, переданный в этот метод, является двоичным потоком. Номер параметра указывается позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и так далее. Другими словами, если устанавливаемый входной поток является значением для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Обратите внимание, что поскольку нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, — это элемент с номером parameterIndex -1.

Parameters:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - входной поток, содержащий двоичное значение, которое нужно установить; length - количество байтов в потоке; длины 0 или меньше не определены, но приведут к исключению неверной длины в подлежащем JDBC-драйвере.
Throws:: SQLException - если произошла ошибка, индекс параметра вне диапазона или при подключении к источнику данных количество байтов, считанных и отправленных драйвером в базу данных, не равно количеству байтов, указанных в length
See Also:: getParams()

setBinaryStream

public void setBinaryStream(int parameterIndex,
                            InputStream x)
                     throws SQLException

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

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

Parameters:: parameterIndex - первый параметр — 1, второй — 2 и так далее.; x - входной поток Java, содержащий двоичное значение параметра
Throws:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом объекте PreparedStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:: 1.6

setUnicodeStream

@Deprecated
public void setUnicodeStream(int parameterIndex,
                             InputStream x,
                             int length)
                      throws SQLException

Deprecated.

getCharacterStream следует использовать вместо него

Устанавливает указанный параметр в заданный объект java.io.InputStream, который будет содержать указанное количество байтов. Содержимое потока будет считано и отправлено в базу данных. Этот метод выбрасывает исключение SQLException, если количество прочитанных и отправленных байтов в базу данных не равно length.

Когда очень большое Unicode-значение передаётся в параметр LONGVARCHAR, может быть практичнее отправить его через объект java.io.InputStream. JDBC-драйвер будет считывать данные из потока по мере необходимости, до достижения конца файла. Драйвер выполнит необходимые преобразования из Unicode в формат базы данных CHAR. Формат байтов Unicode-потока должен быть Java UTF-8, как определено в спецификации виртуальной машины Java.

Этот метод устарел; следует использовать метод getCharacterStream.

Значение параметра, установленное этим методом, хранится внутри и будет передано в качестве соответствующего параметра в команде этого объекта RowSet, когда вызывается метод execute. Вызовы метода getParams после вызова setUnicodeStream вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный объект java.io.InputStream. Второй элемент — значение, установленное для length. Третий элемент — внутренняя константа BaseRowSet, указывающая, что поток, переданный в этот метод, является Unicode-потоком. Номер параметра указывается позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и так далее. Другими словами, если устанавливаемый входной поток является значением для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Parameters:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - объект java.io.InputStream, содержащий значение параметра UNICODE; length - количество байтов во входном потоке
Throws:: SQLException - если произошла ошибка, индекс параметра вне диапазона или количество байтов, прочитанных и отправленных драйвером в базу данных, не равно количеству байтов, указанных в length
See Also:: getParams()

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               Reader reader,
                               int length)
                        throws SQLException

Устанавливает указанный параметр в заданный объект java.io.Reader, который будет содержать указанное количество символов. Содержимое ридера будет считано и отправлено в базу данных. Этот метод выбрасывает исключение SQLException, если количество прочитанных и отправленных байтов в базу данных не равно length.

Когда очень большое Unicode-значение передаётся в параметр LONGVARCHAR, может быть практичнее отправить его через объект Reader. JDBC-драйвер будет считывать данные из потока по мере необходимости, до достижения конца файла. Драйвер выполнит необходимые преобразования из Unicode в формат базы данных CHAR. Формат байтов Unicode-потока должен быть Java UTF-8, как определено в спецификации виртуальной машины Java.

Значение параметра, установленное этим методом, хранится внутри и будет передано в качестве соответствующего параметра в команде этого объекта RowSet, когда вызывается метод execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определён в этом классе.

Вызовы метода getParams после вызова setCharacterStream вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный объект java.io.Reader. Второй элемент — значение, установленное для length. Номер параметра указывается позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и так далее. Другими словами, если устанавливаемый ридер является значением для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; reader - объект, содержащий данные Юникода; length - количество символов в потоке; длины 0 или меньше не определены, но приведут к исключению неверной длины в базовом драйвере JDBC.
Исключения:: SQLException - если произошла ошибка, индекс параметра находится вне допустимого диапазона или при подключении к источнику данных количество байтов, которые драйвер считывает и отправляет в базу данных, не равно количеству байтов, указанному в length
См. также:: getParams()

setCharacterStream

public void setCharacterStream(int parameterIndex,
                               Reader reader)
                        throws SQLException

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

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

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

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

setObject

public void setObject(int parameterIndex,
                      Object x,
                      int targetSqlType,
                      int scale)
               throws SQLException

Устанавливает указанный параметр в объекте на языке программирования Java в объект типа Object. Второй параметр должен быть типа Object. Для целочисленных значений следует использовать эквивалентные объекты java.lang. Например, используйте класс Integer для int.

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

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

Значение параметра, установленное этим методом, хранится во внутренней области и будет использовано как соответствующий параметр в команде этого объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Вызовы метода getParams после вызова этой версии setObject вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный экземпляр Object, второй — значение, установленное для targetSqlType. Третий элемент — значение, установленное для scale, которое драйвер проигнорирует, если тип устанавливаемого объекта не является java.sql.Types.NUMERIC или java.sql.Types.DECIMAL. Номер параметра указывается положением элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и так далее. Иными словами, если устанавливаемый объект является значением для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Обратите внимание, что, поскольку нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет номер parameterIndex - 1.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - объект Object, содержащий входное значение параметра; должен быть типа Object; targetSqlType - SQL-тип (как определено в java.sql.Types), который должен быть отправлен в базу данных. Аргумент scale может дополнительно квалифицировать этот тип. Если предоставлен нестандартный targetSqlType, этот метод не будет выбрасывать SQLException. Это позволяет неявно поддерживать нестандартные SQL-типы.; scale - для типов java.sql.Types.DECIMAL и java.sql.Types.NUMERIC это количество цифр после десятичной точки. Для всех других типов это значение будет проигнорировано.
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setObject

public void setObject(int parameterIndex,
                      Object x,
                      int targetSqlType)
               throws SQLException

Устанавливает значение указанного параметра с заданным значением Object. Этот метод подобен setObject(int parameterIndex, Object x, int targetSqlType, int scale), за исключением того, что он предполагает масштаб нуль.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

Вызовы метода getParams после вызова этой версии setObject вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный экземпляр Object. Второй элемент — значение, установленное для targetSqlType. Номер параметра указывается положением элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и так далее. Иными словами, если устанавливаемый объект является значением для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом в массиве, возвращаемом getParams.

Параметры:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше; x - объект Object, содержащий входное значение параметра; должен быть типа Object; targetSqlType - SQL-тип (как определено в java.sql.Types), который должен быть отправлен в базу данных. Если предоставлен нестандартный targetSqlType, этот метод не будет выбрасывать SQLException. Это позволяет неявно поддерживать нестандартные SQL-типы.
Исключения:: SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setObject

public void setObject(int parameterIndex,
                      Object x)
               throws SQLException

Устанавливает указанный параметр в значение Object на языке программирования Java. Второй параметр должен быть типа Object. Для целочисленных значений следует использовать соответствующие объекты класса java.lang. Например, используйте класс Integer для значения int.

Спецификация JDBC определяет стандартное отображение типов Java Object в типы SQL. Драйвер будет использовать это стандартное отображение для преобразования данного объекта в соответствующий тип SQL перед отправкой его в базу данных. Если объект имеет пользовательское отображение (является классом, реализующим интерфейс SQLData), драйвер должен вызвать метод SQLData.writeSQL для записи объекта в поток данных SQL.

Если, с другой стороны, объект является классом, реализующим интерфейсы Ref, Blob, Clob, Struct или Array, драйвер должен передать его в базу данных в качестве значения соответствующего типа SQL.

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

Значение параметра, установленное этим методом, хранится в памяти и будет передано в качестве соответствующего параметра в команде этого объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

После вызова этого метода вызов метода getParams вернет массив объектов текущих параметров команды, который будет включать установленное значение Object для параметра-заполнителя с номером parameterIndex. Обратите внимание, что поскольку нумерация элементов массива начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет номер parameterIndex -1.

Parameters:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй - 2 и так далее; должен быть 1 или больше; x - объект, содержащий значение входного параметра
Throws:: SQLException - если произошла ошибка, индекс параметра вне диапазона, или возникает неоднозначность в реализации устанавливаемого объекта
See Also:: getParams()

setRef

public void setRef(int parameterIndex,
                   Ref ref)
            throws SQLException

Устанавливает указанный параметр в заданный объект Ref на языке программирования Java. Драйвер преобразует это в значение SQL REF при отправке в базу данных. Внутренне, Ref представлен как SerialRef для обеспечения сериализуемости.

Значение параметра, установленное этим методом, хранится во внутренней памяти и будет передано в качестве соответствующего параметра в команде этого объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть предоставлены в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

После вызова этого метода вызов метода getParams вернет массив объектов текущих параметров команды, который будет включать объект Ref, установленный для параметра-заполнителя с номером parameterIndex. Обратите внимание, что поскольку нумерация элементов массива начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет номер parameterIndex -1.

Parameters:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй - 2 и так далее; должен быть 1 или больше; ref - объект типа Ref, представляющий значение SQL REF; не может быть null
Throws:: SQLException - если произошла ошибка; индекс параметра вне диапазона или объект Ref имеет значение null; или объект Ref возвращает имя базового типа null.
See Also:: getParams(), SerialRef

setBlob

public void setBlob(int parameterIndex,
                    Blob x)
             throws SQLException

Устанавливает указанный параметр в заданный объект Blob на языке программирования Java. Драйвер преобразует это в значение SQL BLOB при отправке в базу данных. Внутренне, Blob представлен как SerialBlob для обеспечения сериализуемости.

После вызова этого метода вызов метода getParams вернет массив объектов текущих параметров команды, который будет включать объект Blob, установленный для параметра-заполнителя с номером parameterIndex. Обратите внимание, что поскольку нумерация элементов массива начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет номер parameterIndex -1.

Parameters:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй - 2 и так далее; должен быть 1 или больше; x - объект типа Blob, представляющий значение SQL BLOB
Throws:: SQLException - если произошла ошибка или индекс параметра вне диапазона
See Also:: getParams(), SerialBlob

setClob

public void setClob(int parameterIndex,
                    Clob x)
             throws SQLException

Устанавливает указанный параметр в заданный объект Clob на языке программирования Java. Драйвер преобразует это в значение SQL CLOB при отправке в базу данных. Внутренне, Clob представлен как SerialClob для обеспечения сериализуемости.

ПРИМЕЧАНИЕ: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

После вызова этого метода вызов метода getParams вернет массив объектов текущих параметров команды, который будет включать объект Clob, установленный для параметра-заполнителя с номером parameterIndex. Обратите внимание, что поскольку нумерация элементов массива начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет номер parameterIndex -1.

Parameters:: parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр имеет номер 1, второй - 2 и так далее; должен быть 1 или больше; x - объект типа Clob, представляющий значение SQL CLOB; не может быть null
Throws:: SQLException - если произошла ошибка; индекс параметра вне диапазона или объект Clob равен null
See Also:: getParams(), SerialBlob

setArray

public void setArray(int parameterIndex,
                     Array array)
              throws SQLException

Устанавливает указанный параметр в объект Array на языке программирования Java. Драйвер преобразует это в значение SQL ARRAY при отправке в базу данных. Внутренне, Array представлен как SerialArray для обеспечения сериализуемости.

Примечание: JdbcRowSet не требует метода populate, так как он не определен в этом классе.

После вызова этого метода вызов метода getParams вернет массив объектов текущих параметров команды, который будет включать объект Array, установленный для параметра-заполнителя с номером parameterIndex. Обратите внимание, что поскольку нумерация элементов массива начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет номер parameterIndex -1.

Параметры:: parameterIndex — порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и т. д.; должен быть 1 или больше; array — объект Array, представляющий значение SQL ARRAY; не может быть null. Объект Array, переданный этому методу, должен возвращать не-null значение Object для всех вызовов метода getArray(). Значение null приведёт к выбрасыванию исключения SQLException.
Исключения:: SQLException — если произошла ошибка; индекс параметра находится вне допустимого диапазона или объект ARRAY имеет значение null
См. также:: getParams(), SerialArray

setDate

public void setDate(int parameterIndex,
                    Date x,
                    Calendar cal)
             throws SQLException

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

Значение параметра, установленное этим методом, хранится в памяти и будет предоставлено как соответствующий параметр в команде этого объекта RowSet при вызове метода execute. Методы, такие как execute и populate, должны быть реализованы в любом классе, расширяющем этот класс и реализующем один или несколько стандартных интерфейсов JSR-114 RowSet.

ПРИМЕЧАНИЕ: Метод JdbcRowSet не требуется для этого класса, так как он не определён.

Вызовы метода getParams после вызова данного метода setDate вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный объект java.sql.Date. Второй элемент — значение, установленное для cal. Номер параметра определяется позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и т. д. Другими словами, если устанавливаемая дата является значением для второго параметра-заполнителя, массив, содержащий её, будет вторым элементом в массиве, возвращаемом методом getParams.

Обратите внимание, что так как нумерация элементов в массиве начинается с нуля, элемент массива, соответствующий параметру-заполнителю с номером parameterIndex, имеет индекс parameterIndex - 1.

Параметры:: parameterIndex — порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и т. д.; должен быть 1 или больше; x — объект java.sql.Date, представляющий значение SQL DATE; cal — объект java.util.Calendar, используемый при построении даты
Исключения:: SQLException — если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setTime

public void setTime(int parameterIndex,
                    Time x,
                    Calendar cal)
             throws SQLException

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

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

ПРИМЕЧАНИЕ: Метод JdbcRowSet не требуется для этого класса, так как он не определён.

Вызовы метода getParams после вызова данного метода setTime вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный объект java.sql.Time. Второй элемент — значение, установленное для cal. Номер параметра определяется позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и т. д. Другими словами, если устанавливаемое время является значением для второго параметра-заполнителя, массив, содержащий его, будет вторым элементом в массиве, возвращаемом методом getParams.

Параметры:: parameterIndex — порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и т. д.; должен быть 1 или больше; x — объект java.sql.Time; cal — объект java.util.Calendar, используемый драйвером для построения времени
Исключения:: SQLException — если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

setTimestamp

public void setTimestamp(int parameterIndex,
                         Timestamp x,
                         Calendar cal)
                  throws SQLException

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

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

ПРИМЕЧАНИЕ: Метод JdbcRowSet не требуется для этого класса, так как он не определён.

Вызовы метода getParams после вызова данного метода setTimestamp вернут массив, содержащий установленные значения параметров. В этом массиве элемент, представляющий значения, установленные этим методом, сам будет массивом. Первый элемент этого массива — заданный объект java.sql.Timestamp. Второй элемент — значение, установленное для cal. Номер параметра определяется позицией элемента в массиве, возвращаемом методом getParams, где первый элемент — значение для первого параметра-заполнителя, второй элемент — значение для второго параметра-заполнителя и т. д. Другими словами, если устанавливаемая метка времени является значением для второго параметра-заполнителя, массив, содержащий её, будет вторым элементом в массиве, возвращаемом методом getParams.

Параметры:: parameterIndex — порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и т. д.; должен быть 1 или больше; x — объект java.sql.Timestamp; cal — объект java.util.Calendar, используемый драйвером для построения метки времени
Исключения:: SQLException — если произошла ошибка или индекс параметра находится вне допустимого диапазона
См. также:: getParams()

clearParameters

public void clearParameters()
                     throws SQLException

Очищает все текущие значения параметров в внутренней представлении параметров этого объекта RowSet, которые должны быть установлены в команде этого объекта RowSet при его выполнении.

В общем случае значения параметров сохраняются для повторного использования в команде этого объекта RowSet. Установка значения параметра с помощью методов-сеттеров автоматически очищает значение указанного параметра и заменяет его новым заданным значением.

Этот метод вызывается внутри метода setCommand для очистки всех параметров, установленных для предыдущей команды.

Кроме того, этот метод отличается от метода initParams тем, что сохраняет схему объекта RowSet.

Исключения:: SQLException — если произошла ошибка при очистке параметров

getParams

public Object[] getParams()
                   throws SQLException

Получает массив, содержащий значения параметров (как объекты, так и примитивные типы), установленные для команды этого объекта RowSet, и выбрасывает объект SQLException, если не все параметры не заданы. Перед отправкой команды в СУБД для выполнения эти параметры будут заменены на параметры-заполнители в объекте PreparedStatement, который является командой для реализации RowSet, расширяющей класс BaseRowSet.

Каждый элемент возвращаемого массива — это экземпляр Object, содержащий значения параметров, предоставленные методу-сеттеру. Порядок элементов определяется значением, предоставленным для parameterIndex. Если метод-сеттер принимает только индекс параметра и значение для установки (возможно, null), элемент массива будет содержать значение для установки (которое будет выражено как Object). Если есть дополнительные параметры, элемент массива сам будет массивом, содержащим значение для установки плюс любые дополнительные значения параметров, предоставленные методу-сеттеру. Если метод устанавливает поток, элемент массива включает тип потока, предоставляемого методу. Эти дополнительные параметры предназначены для использования драйвером или СУБД и могут быть или не быть использованы.

ПРИМЕЧАНИЕ: Сохраненные значения параметров типов Array, Blob, Clob и Ref возвращаются как SerialArray, SerialBlob, SerialClob и SerialRef соответственно.

Возвращает:: массив экземпляров Object, включающий значения параметров, которые могут быть установлены в команде этого объекта RowSet; пустой массив, если не было установлено ни одного параметра
Выбрасывает:: SQLException — если произошла ошибка при получении массива параметров объекта этого объекта RowSet или если не все параметры были установлены

setNull

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

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

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

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

setNull

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

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

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

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

setBoolean

public void setBoolean(String parameterName,
                       boolean x)
                throws SQLException

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

Параметры:: parameterName — имя параметра; x — значение параметра
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException — если JDBC драйвер не поддерживает этот метод
См. также:: getParams()

setByte

public void setByte(String parameterName,
                    byte x)
             throws SQLException

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

Параметры:: parameterName — имя параметра; x — значение параметра
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException — если JDBC драйвер не поддерживает этот метод
См. также:: getParams()

setShort

public void setShort(String parameterName,
                     short x)
              throws SQLException

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

setInt

public void setInt(String parameterName,
                   int x)
            throws SQLException

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

setLong

public void setLong(String parameterName,
                    long x)
             throws SQLException

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

setFloat

public void setFloat(String parameterName,
                     float x)
              throws SQLException

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

setDouble

public void setDouble(String parameterName,
                      double x)
               throws SQLException

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

setBigDecimal

public void setBigDecimal(String parameterName,
                          BigDecimal x)
                   throws SQLException

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

setString

public void setString(String parameterName,
                      String x)
               throws SQLException

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

setBytes

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

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

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

setTimestamp

public void setTimestamp(String parameterName,
                         Timestamp x)
                  throws SQLException

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

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

setAsciiStream

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

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

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

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

setBinaryStream

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

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

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

setCharacterStream

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

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

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

setAsciiStream

public void setAsciiStream(String parameterName,
                           InputStream x)
                    throws SQLException

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

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

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

setBinaryStream

public void setBinaryStream(String parameterName,
                            InputStream x)
                     throws SQLException

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

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

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

setCharacterStream

public void setCharacterStream(String parameterName,
                               Reader reader)
                        throws SQLException

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

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

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

setNCharacterStream

public void setNCharacterStream(int parameterIndex,
                                Reader value)
                         throws SQLException

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

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

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

setObject

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

Устанавливает значение указанного параметра с помощью данного объекта. Второй аргумент должен быть типом объекта; для целочисленных значений следует использовать эквивалентные объекты java.lang.

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

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

setObject

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

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

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

setObject

public void setObject(String parameterName,
                      Object x)
               throws SQLException

Устанавливает значение указанного параметра с помощью данного объекта. Второй параметр должен быть типа Object; поэтому, эквивалентные объекты java.lang должны использоваться для встроенных типов.

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

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

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

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

setBlob

public void setBlob(int parameterIndex,
                    InputStream inputStream,
                    long length)
             throws SQLException

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

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

setBlob

public void setBlob(int parameterIndex,
                    InputStream inputStream)
             throws SQLException

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

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

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

setBlob

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

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

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

setBlob

public void setBlob(String parameterName,
                    Blob x)
             throws SQLException

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

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

setBlob

public void setBlob(String parameterName,
                    InputStream inputStream)
             throws SQLException

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

setClob

public void setClob(int parameterIndex,
                    Reader reader,
                    long length)
             throws SQLException

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

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

setClob

public void setClob(int parameterIndex,
                    Reader reader)
             throws SQLException

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

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

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

setClob

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

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

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

setClob

public void setClob(String parameterName,
                    Clob x)
             throws SQLException

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

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

setClob

public void setClob(String parameterName,
                    Reader reader)
             throws SQLException

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

setDate

public void setDate(String parameterName,
                    Date x)
             throws SQLException

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

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

setDate

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

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

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

setTime

public void setTime(String parameterName,
                    Time x)
             throws SQLException

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

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

setTime

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

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

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

setTimestamp

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

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

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

setSQLXML

public void setSQLXML(int parameterIndex,
                      SQLXML xmlObject)
               throws SQLException

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

Параметры:: parameterIndex - индекс первого параметра равен 1, второго - 2 и т. д.; xmlObject - объект SQLXML, отображающий значение SQL XML
Исключения:: SQLException - если произошла ошибка доступа к базе данных, метод вызван на закрытом наборе результатов, java.xml.transform.Result, Writer или OutputStream не были закрыты для объекта SQLXML или произошла ошибка обработки XML-значения. Метод getCause исключения может предоставить более подробное исключение, например, если поток не содержит корректного XML.; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

setSQLXML

public void setSQLXML(String parameterName,
                      SQLXML xmlObject)
               throws SQLException

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

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

setRowId

public void setRowId(int parameterIndex,
                     RowId x)
              throws SQLException

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

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

setRowId

public void setRowId(String parameterName,
                     RowId x)
              throws SQLException

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

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

setNString

public void setNString(int parameterIndex,
                       String value)
                throws SQLException

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

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

setNString

public void setNString(String parameterName,
                       String value)
                throws SQLException

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

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

setNCharacterStream

public void setNCharacterStream(int parameterIndex,
                                Reader value,
                                long length)
                         throws SQLException

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

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

setNCharacterStream

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

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

setNCharacterStream

public void setNCharacterStream(String parameterName,
                                Reader value)
                         throws SQLException

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

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

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

setNClob

public void setNClob(String parameterName,
                     NClob value)
              throws SQLException

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

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

setNClob

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

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

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

setNClob

public void setNClob(String parameterName,
                     Reader reader)
              throws SQLException

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

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

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

setNClob

public void setNClob(int parameterIndex,
                     Reader reader,
                     long length)
              throws SQLException

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

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

setNClob

public void setNClob(int parameterIndex,
                     NClob value)
              throws SQLException

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

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

setNClob

public void setNClob(int parameterIndex,
                     Reader reader)
              throws SQLException

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

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

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

setURL

public void setURL(int parameterIndex,
                   URL x)
            throws SQLException

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

Параметры:: parameterIndex — первый параметр равен 1, второй — 2 и т. д.; x — объект java.net.URL для установки
Исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement; SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.sql.rowset/javax/sql/rowset/BaseRowSet.html