Класс BaseRowSet

java.lang.Object

javax.sql.rowset.BaseRowSet

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

public abstract class BaseRowSet extends Object implements Serializable, Cloneable

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

1.0 Обзор

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

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

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

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

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

ПРИМЕЧАНИЕ: для использования объекта 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.
Не будет видеть несохранённые данные (создавать "грязные" чтения).
Обработка выхода включена.
Карта типов подключения установлена в null.
Имеет пустой объект Vector для хранения значений, установленных для параметра заполнителя в команде объекта RowSet .

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

    crs.setMaxRows(500);

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

Since:

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()`	Возвращает JDBC URL, который использует объект `RowSet` этого объекта `javax.sql.Reader` для подключения к реляционной базе данных с использованием драйвера, поддерживающего 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)`	Устанавливает свойство `RowSet` объекта `command` в заданный объект `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`.

`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

public void removeRowSetListener(RowSetListener listener)

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

Параметры:

listener - объект RowSetListener, который находится в списке слушателей для объекта RowSet

См. также:

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. Свойство команды содержит запрос, который будет выполнен для заполнения этого объекта RowSet.

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

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

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

Возвращает:

строку, которая является значением для свойства RowSet объекта String; может быть null

См. также:

setCommand

public void setCommand(String cmd) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getUrl

public String getUrl() throws SQLException

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

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

Возвращает:

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

Издаёт:

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

См. также:

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 (пустая строка)

См. также:

getDataSourceName

public String getDataSourceName()

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

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

Возвращает:

объект String, идентифицирующий объект DataSource для создания соединения; если логическое имя не было установлено, возвращается null.

См. также:

setDataSourceName

public void setDataSourceName(String name) throws SQLException

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

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

Параметры:

name - объект String, содержащий имя, которое может быть передано в службу именования на основе технологии JNDI для извлечения объекта DataSource, который можно использовать для получения соединения; может быть null, но не должен быть пустой строкой

Издаёт:

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

См. также:

getUsername

public String getUsername()

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

Возвращает:

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

См. также:

setUsername

public void setUsername(String name)

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

Параметры:

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

См. также:

getPassword

public String getPassword()

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

Возвращает:

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

См. также:

setPassword

public void setPassword(String pass)

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

Параметры:

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

См. также:

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

См. также:

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 произошла ошибка

См. также:

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

См. также:

isReadOnly

public boolean isReadOnly()

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

Возвращает:

true , если этот объект RowSet не может быть обновлён; false в противном случае

См. также:

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 на заданную константу. СУБД будет использовать этот уровень изоляции транзакций для транзакций, если это возможно.

Для реализаций 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 - если (1) при внутренней установке максимального ограничения размера столбца произошла ошибка или (2) установлен размер меньше 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

public void setShowDeleted(boolean value) throws SQLException

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

Parameters:

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

Throws:

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

See Also:

getEscapeProcessing

public boolean getEscapeProcessing() throws SQLException

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

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

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

public int getFetchDirection() throws SQLException

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

Returns:

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

Throws:

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

See Also:

setFetchSize

public void setFetchSize(int rows) throws SQLException

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

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

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

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

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

Parameters:

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

Throws:

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

See Also:

getFetchSize

public int getFetchSize() throws SQLException

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

Returns:

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

Throws:

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

See Also:

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:

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:

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:

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:

setByte

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

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

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

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

Parameters:

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

Throws:

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

See Also:

setShort

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

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

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

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

Parameters:

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

Throws:

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

See Also:

setInt

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

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

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

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

Parameters:

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

Throws:

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

See Also:

setLong

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

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

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

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

Parameters:

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

Throws:

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

See Also:

setFloat

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

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

setDouble

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setBigDecimal

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setString

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setBytes

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setDate

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

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setTime

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

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

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

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

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

Parameters:

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

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

Throws:

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

See Also:

setTimestamp

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

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

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

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

Parameters:

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

Throws:

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

See Also:

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.

Parameters:

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

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

Throws:

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

See Also:

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:

setBinaryStream

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

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

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

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

setUnicodeStream

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

Deprecated.

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

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

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

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

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

Parameters:

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

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

Throws:

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

See Also:

setCharacterStream

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

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

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

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

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

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

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

Parameters:

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

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

Throws:

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

See Also:

setCharacterStream

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

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

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

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

setObject

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.

Parameters:

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

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

scale - для типов java.sql.Types.DECIMAL и java.sql.Types.NUMERIC, это количество цифр после десятичной точки. Для всех остальных типов это значение будет проигнорировано.

Throws:

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

See Also:

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:

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.

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

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

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

Parameters:

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

Throws:

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

See Also:

setRef

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

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

ПРИМЕЧАНИЕ: 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 для обеспечения сериализуемости.

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

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

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

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

Параметры:

array - объект Array , представляющий значение SQL ARRAY ; не может быть null. Объект Array , переданный в этот метод, должен возвращать не null значение для всех вызовов метода 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 не указан, драйвер использует часовой пояс виртуальной машины, выполняющей приложение.

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

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

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

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

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

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

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

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

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

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

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

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

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

Параметры:

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

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

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

Исключения:

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

См. также:

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

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

См. также:

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

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

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

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setInt

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setLong

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setFloat

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setDouble

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setBigDecimal

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setString

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setBytes

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setTimestamp

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setAsciiStream

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

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

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

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

setBinaryStream

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

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

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

setCharacterStream

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

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

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

setAsciiStream

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

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

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

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

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

setBinaryStream

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

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

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

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

setCharacterStream

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

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

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

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

setNCharacterStream

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

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

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

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

setObject

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

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

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

Parameters:

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

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

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

scale - для типов java.sql.Types.DECIMAL или java.sql.Types.NUMERIC, это количество цифр после десятичной точки. Для всех других типов это значение будет проигнорировано.

Throws:

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

SQLFeatureNotSupportedException - если targetSqlType является ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT типом данных, и драйвер JDBC не поддерживает этот тип данных

See Also:

setObject

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

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

Parameters:

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

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

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

Throws:

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

See Also:

setObject

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

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

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

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

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

Parameters:

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

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

Throws:

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

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

See Also:

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-запросе, если заданное значение length меньше нуля или если количество байтов в InputStream не соответствует заданному значению length.; 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, которая принимает параметр length.

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-запросе или если указанное значение length меньше нуля, если количество байтов в InputStream не соответствует заданному значению length, если произошла ошибка доступа к базе данных или если этот метод вызван для закрытого 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

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

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

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

setClob

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

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

Parameters:: parameterIndex - индекс первого параметра равен 1, второго - 2 и т.д.; reader - Объект, содержащий данные для установки значения параметра.; length - количество символов в данных параметра.
Throws:: SQLException - если произошла ошибка доступа к базе данных, этот метод вызван для закрытого PreparedStatement, если параметр parameterIndex не соответствует марке параметра в SQL-запросе или если заданное значение length меньше нуля.; 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, которая принимает параметр length.

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-запросе, если указанное значение length меньше нуля, произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement.; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:: 1.6

setClob

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

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

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

setClob

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

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

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

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

setDate

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

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

Parameters:

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

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

Throws:

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

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

See Also:

setDate

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

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

Parameters:

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

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

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

Throws:

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

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

See Also:

setTime

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

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

Parameters:

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

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

Throws:

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

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

See Also:

setTime

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

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

Parameters:

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

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

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

Throws:

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

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

See Also:

setTimestamp

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

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

Parameters:

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

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

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

Throws:

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

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

See Also:

setSQLXML

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

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

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

setSQLXML

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

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

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

setRowId

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

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

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

END_OF_DOCUMENT_MARKER

setRowId

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

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

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

setNString

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

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

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

setNString

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

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

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

setNCharacterStream

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

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

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

setNCharacterStream

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

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

setNCharacterStream

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

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

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

setNClob

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

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

Parameters:: parameterName - имя столбца, который нужно установить; value - значение параметра
Throws:: SQLException - если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает, что может произойти ошибка преобразования данных; или если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:: 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.

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

setNClob

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

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

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

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

setNClob

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

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

Parameters:: parameterIndex - индекс параметра (1 для первого, 2 для второго и т.д.); reader - Объект, содержащий данные для установки значения параметра.; length - количество символов в данных параметра.
Throws:: SQLException - если parameterIndex не соответствует метке параметра в SQL-запросе; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных, или этот метод вызван на закрытом PreparedStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:: 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 - если parameterIndex не соответствует марке параметра в SQL-запросе; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого PreparedStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С тех пор:: 1.6

setURL

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

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

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

© 1993, 2023, 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/21/docs/api/java.sql.rowset/javax/sql/rowset/BaseRowSet.html