Класс 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 Установка свойств

Все наборы строк (rowsets) поддерживают набор свойств, которые обычно устанавливаются с помощью инструмента. Количество и типы свойств набора строк будут варьироваться в зависимости от того, что делает реализация 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 final int`	`ASCII_STREAM_PARAM`	Константа, указывающая объекту `RowSetReaderImpl`, что данный параметр является потоком ASCII.
`protected InputStream`	`asciiStream`	Объект `InputStream`, который будет возвращён методом `getAsciiStream`, указанным в интерфейсе `ResultSet`.
`static final int`	`BINARY_STREAM_PARAM`	Константа, указывающая объекту `RowSetReaderImpl`, что данный параметр является двоичным потоком.
`protected InputStream`	`binaryStream`	Объект `InputStream`, который будет возвращён методом `getBinaryStream`, указанным в интерфейсе `ResultSet`.
`protected Reader`	`charStream`	Объект `Reader`, который будет возвращён методом `getCharacterStream`, указанным в интерфейсе `ResultSet`.
`static final 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()`	Извлекает URL JDBC, который использует объект `javax.sql.Reader` этого объекта `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)`	Устанавливает указанный параметр в заданное значение Java `long`.
`void`	`setMaxFieldSize(int max)`	Устанавливает максимальное количество байтов, которое может быть использовано для значения столбца в этом объекте `RowSet`, в заданное число.
`void`	`setMaxRows(int max)`	Устанавливает максимальное количество строк, которое может содержать этот объект `RowSet`, в заданное число.
`void`	`setNCharacterStream(int parameterIndex, Reader value)`	Устанавливает указанный параметр в команде этого объекта `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`	`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`.

END_OF_DOCUMENT_MARKER

`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` в заданное имя пользователя.

Методы, объявленные в классе 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 и не добавляет нулевую ссылку в набор слушателей.

Примечание: если прослушиватель уже установлен, и новый экземпляр 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.

Возвращает:

SQL-запрос, являющийся значением для свойства command этого объекта RowSet; может быть null

См. также:

setCommand(java.lang.String)

setCommand

public void setCommand(String cmd) throws SQLException

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

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

Параметры:

cmd — объект String, содержащий SQL-запрос, который будет установлен как свойство command этого объекта RowSet; может быть null, но не пустой строкой

Исключения:

SQLException — если в качестве значения команды предоставлена пустая строка

См. также:

getCommand()

getUrl

public String getUrl() throws SQLException

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

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

Возвращает:

объект String, содержащий URL JDBC, используемый для установления подключения для этого объекта RowSet; может быть null (значение по умолчанию), если не задано

Исключения:

SQLException - если произошла ошибка при получении значения URL

См. также:

setUrl(java.lang.String)

setUrl

public void setUrl(String url) throws SQLException

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

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

Параметры:

url - объект String, содержащий URL JDBC, который будет использоваться для установления подключения к базе данных для этого объекта 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. Поскольку свойство пароля не сериализуется, оно устанавливается во время выполнения перед вызовом метода execute. Значение по умолчанию — null

Возвращает:

объект String, представляющий пароль, который должен быть предоставлен базе данных для создания подключения

См. также:

setPassword(java.lang.String)

setPassword

public void setPassword(String pass)

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

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

getTransactionIsolation

public int getTransactionIsolation()

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

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

Returns:

одно из следующих констант: Connection.TRANSACTION_NONE, Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE

See Also:

setTransactionIsolation

public void setTransactionIsolation(int level) throws SQLException

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

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

Parameters:

level - одна из следующих констант, перечисленных в порядке возрастания: Connection.TRANSACTION_NONE, Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE

Throws:

SQLException - если заданный параметр не является одной из констант Connection

See Also:

getTypeMap

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

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

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

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

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

setTypeMap

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

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

Parameters:: 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. Если предел превышен, избыточные данные будут безмолвно отброшены.

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

setMaxFieldSize

public void setMaxFieldSize(int max) throws SQLException

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

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

getMaxRows

public int getMaxRows() throws SQLException

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

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

setMaxRows

public void setMaxRows(int max) throws SQLException

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

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

setEscapeProcessing

public void setEscapeProcessing(boolean enable) throws SQLException

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

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

Parameters:: enable - true для включения обработки экранирования; false для её отключения
Throws:: SQLException - если произошла ошибка при установлении обработки синтаксиса экранирования в драйвере underlying JDBC технологии

getQueryTimeout

public int getQueryTimeout() throws SQLException

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

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

setQueryTimeout

public void setQueryTimeout(int seconds) throws SQLException

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

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

getShowDeleted

public boolean getShowDeleted() throws SQLException

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

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

Returns:

true, если строки, помеченные для удаления, отображаются; false в противном случае

Throws:

SQLException - если произошла ошибка при определении отображения строк, помеченных для удаления

See Also:

setShowDeleted(boolean)

setShowDeleted

public void setShowDeleted(boolean value) throws SQLException

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

Parameters:

value - true, если строки, помеченные для удаления, должны быть показаны; false в противном случае

Throws:

SQLException - если при установке видимости строк, помеченных для удаления, произошла ошибка

See Also:

getShowDeleted()

getEscapeProcessing

public boolean getEscapeProcessing() throws SQLException

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

Returns:: true, если обработка escape включена; false в противном случае
Throws:: SQLException - если при определении включения обработки escape произошла ошибка или внутренний триггер обработки escape не был включён

setFetchDirection

public void setFetchDirection(int direction) throws SQLException

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

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

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

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

Parameters:

direction - одно из значений ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN

Throws:

SQLException - если (1) тип RowSet равен TYPE_FORWARD_ONLY, а заданное направление извлечения не равно FETCH_FORWARD, или (2) заданное направление извлечения не равно ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN

See Also:

getFetchDirection()

getFetchDirection

public int getFetchDirection() throws SQLException

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

Returns:

одно из значений ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN

Throws:

SQLException - если при определении текущего направления извлечения для извлечения строк произошла ошибка

See Also:

setFetchDirection(int)

setFetchSize

public void setFetchSize(int rows) throws SQLException

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

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

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

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

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

Parameters:

rows - количество строк для извлечения; 0, чтобы позволить драйверу самому определить оптимальный размер извлечения; должно быть не меньше 0 и не больше максимального количества строк, разрешенного для этого объекта RowSet (количество, возвращаемое методом getMaxRows())

Throws:

SQLException - если указанный размер извлечения меньше 0 или больше лимита максимального количества строк

See Also:

getFetchSize()

getFetchSize

public int getFetchSize() throws SQLException

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

Returns:

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

Throws:

SQLException - если при определении количества строк в текущем размере извлечения произошла ошибка

See Also:

setFetchSize(int)

getConcurrency

public int getConcurrency() throws SQLException

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

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

Returns:

тип конкуретности для этого объекта RowSet, который должен быть одним из следующих: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

Throws:

SQLException - если при получении конкуретности этого объекта RowSet произошла ошибка

See Also:

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.

Parameters:

parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который нужно установить. Первый параметр - 1, второй - 2 и так далее; должен быть 1 или больше

sqlType - int, являющийся одним из кодов SQL типа, определённых в классе Types. Если нестандартный sqlType предоставлен, этот метод не будет выбрасывать SQLException. Это позволяет неявно поддерживать нестандартные SQL типы.

Throws:

SQLException - если произошла ошибка доступа к базе данных или указанный индекс параметра находится вне границ

See Also:

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. В случае типа, определённого пользователем, имя является именем типа самого параметра. Для параметра REF имя — это имя типа ссылаемого типа. Если драйвер, поддерживающий JDBC-технологию, не нуждается в информации о коде или имени типа, он может её игнорировать.

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

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

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

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

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

Parameters:

parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который должен быть установлен. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше

sqlType - значение из java.sql.Types

typeName - полное квалифицированное имя SQL-типа, определённого пользователем, которое игнорируется, если параметр не является типом, определённым пользователем, или значением REF

Throws:

SQLException - если произошла ошибка или заданный индекс параметра находится вне допустимого диапазона

See Also:

getParams()

setBoolean

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

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

getParams()

setByte

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

getParams()

setShort

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

getParams()

setInt

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

getParams()

setLong

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

getParams()

setFloat

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

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра вне диапазона

See Also:

getParams()

setDouble

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра вне диапазона

See Also:

getParams()

setBigDecimal

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра вне диапазона

See Also:

getParams()

setString

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра вне диапазона

See Also:

getParams()

setBytes

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

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

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

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра вне диапазона

See Also:

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.

Parameters:

x - значение параметра

Throws:

SQLException - если произошла ошибка или индекс параметра вне диапазона

See Also:

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.

Parameters:

x - объект java.sql.Time, который должен быть установлен в качестве значения для параметра-заполнителя parameterIndex

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

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.

Parameters:

x - объект java.sql.Timestamp

Throws:

SQLException - если произошла ошибка или индекс параметра находится вне допустимого диапазона

See Also:

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, имеет индекс parameterIndex -1.

Parameters:

x - входной поток Java, содержащий значение параметра ASCII

length - количество байтов в потоке. Это количество байтов, которое драйвер отправит в СУБД; значения 0 или меньше не определены, но приведут к исключению неверной длины в базовом JDBC-драйвере.

Throws:

SQLException - если произошла ошибка, индекс параметра находится вне допустимого диапазона или при подключении к источнику данных, количество байтов, считанных и отправленных драйвером в базу данных, не равно количеству байтов, указанному в length

See Also:

getParams()

setAsciiStream

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

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

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

Parameters:: parameterIndex - первый параметр — 1, второй — 2 и т. д.; x - входной поток Java, содержащий значение параметра ASCII
Throws:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта PreparedStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:: 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 Virtual Machine.

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

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

Parameters:

x - объект java.io.InputStream, содержащий значение UNICODE-параметра

length - количество байтов во входном потоке

Throws:

SQLException - если произошла ошибка, индекс параметра находится вне границ или количество байтов, прочитанных и отправленных драйвером в базу данных, не равно количеству байтов, указанных в length

See Also:

getParams()

УстановитьПотокСимволов

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

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

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

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

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

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

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

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

Параметры:

parameterIndex - порядковый номер параметра заполнителя в команде этого объекта RowSet, который необходимо установить. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше

reader - объект Reader, содержащий данные Юникода

length - количество символов в потоке; длины 0 или меньше не определены, но приведут к исключению недействительной длины в базовом драйвере JDBC.

Исключения:

SQLException - если произошла ошибка, индекс параметра находится за пределами допустимого диапазона или при подключении к источнику данных, количество байтов, прочитанных и отправленных драйвером в базу данных, не равно количеству байтов, указанному в length

См. также:

getParams()

УстановитьПотокСимволов

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

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

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

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

УстановитьОбъект

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

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

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

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

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

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

Параметры:

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)

, за исключением того, что он предполагает масштаб ноль.

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

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

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

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

Parameters:

parameterIndex - порядковый номер параметра-заполнителя в команде объекта RowSet, который нужно установить. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше

x - объект Object, содержащий значение входного параметра; должен быть типа Object

targetSqlType - тип SQL (как определён в java.sql.Types), который должен быть отправлен в базу данных. Если предоставлен нестандартный targetSqlType, этот метод не выбросит SQLException. Это позволяет неявную поддержку нестандартных типов SQL.

Throws:

SQLException - если произошла ошибка или номер параметра выходит за пределы границ

See Also:

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:

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:

ref - объект Ref, представляющий значение SQL REF; не может быть null

Throws:

SQLException - если произошла ошибка; номер параметра выходит за пределы границ, или объект Ref равен null; или объект Ref возвращает имя базового типа null.

See Also:

setBlob

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

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

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

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

Parameters:

x - объект Blob, представляющий значение SQL BLOB

Throws:

SQLException - если произошла ошибка или номер параметра выходит за пределы границ

See Also:

УстановитьClob

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

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

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

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

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

Параметры:

parameterIndex - порядковый номер параметра-заполнителя в командном объекте этого объекта RowSet, который необходимо установить. Первый параметр — 1, второй — 2 и так далее; должен быть 1 или больше

x - объект Clob, представляющий значение SQL CLOB; не может быть null

Исключения:

SQLException - если произошла ошибка; индекс параметра вне диапазона или Clob имеет значение null

См. также:

УстановитьМассив

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

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

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

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

Параметры:

array - объект Array, представляющий значение SQL ARRAY; не может быть null. Объект Array, переданный в этот метод, должен возвращать ненулевой объект для всех вызовов метода getArray(). Значение null вызовет исключение SQLException.

Исключения:

SQLException - если произошла ошибка; индекс параметра вне диапазона или ARRAY имеет значение null

См. также:

УстановитьДату

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

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

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

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

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

Параметры:

x - объект java.sql.Date, представляющий значение SQL DATE

cal - объект java.util.Calendar, используемый при построении даты

Исключения:

SQLException - если произошла ошибка или индекс параметра находится вне диапазона

См. также:

getParams()

УстановитьВремя

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

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

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

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

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

Параметры:

x - объект java.sql.Time

cal - объект java.util.Calendar, который драйвер может использовать для построения времени

Исключения:

SQLException - если произошла ошибка или индекс параметра находится вне диапазона

См. также:

getParams()

УстановитьОтметкуВремени

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

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

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

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

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

Параметры:

parameterIndex - порядковый номер параметра-заполнителя в команде этого объекта RowSet, который необходимо установить. Первый параметр — 1, второй — 2 и т. д.; должно быть 1 или больше

x - объект java.sql.Timestamp

cal - объект java.util.Calendar, который драйвер может использовать для построения отметки времени

Исключения:

SQLException - если произошла ошибка или индекс параметра вне допустимого диапазона

См. также:

getParams()

ОчиститьПараметры

public void clearParameters() throws SQLException

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

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

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

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

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

ПолучитьПараметры

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 или если не все параметры были установлены

УстановитьNull

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

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

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

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

УстановитьNull

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

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

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

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

УстановитьБулево

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объекта CallableStatement

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

См. также:

getParams()

УстановитьБайт

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

См. также:

getParams()

УстановитьКороткий

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод

См. также:

getParams()

setInt

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

setLong

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

setFloat

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

setDouble

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

setBigDecimal

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

setString

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

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 в формат char базы данных.

Примечание: Этот объект потока может быть как стандартным объектом 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-драйвер не поддерживает этот метод

УстановитьПотокASCII

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

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

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

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

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

УстановитьПотокБинарныхДанных

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

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

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

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

УстановитьПотокСимволов

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

УстановитьПотокСимволовN

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

УстановитьОбъект

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

УстановитьОбъект

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

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

Параметры:

parameterName - имя параметра

x - объект, содержащий значение входного параметра

targetSqlType - тип SQL (как определено в java.sql.Types), который должен быть отправлен в базу данных

Исключения:

SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement

См. также:

getParams()

УстановитьОбъект

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, иначе при выполнении PreparedStatement будет сгенерирована ошибка SQLException. Этот метод отличается от метода setBinaryStream (int, InputStream, int) тем, что сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGVARBINARY или как BLOB

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

setBlob

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

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

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

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

setBlob

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

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

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

setBlob

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

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

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

setBlob

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

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

setClob

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

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

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

setClob

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

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

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

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

setClob

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

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

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

УстановитьClob

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

УстановитьClob

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

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

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

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

УстановитьDate

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

УстановитьDate

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

УстановитьTime

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

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

Параметры:

parameterName - имя параметра

x - значение параметра

Исключения:

SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement

SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

См. также:

getParams()

УстановитьTime

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

УстановитьTimestamp

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

УстановитьSQLXML

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

УстановитьSQLXML

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

УстановитьRowId

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

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

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

END_OF_DOCUMENT_MARKER

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

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

setNClob

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

Устанавливает указанный параметр в объект типа java.sql.NClob. Драйвер преобразует этот объект в значение 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 - если параметр не соответствует маркерам параметра в 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, 2021, 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/17/docs/api/java.sql.rowset/javax/sql/rowset/BaseRowSet.html