Класс BaseRowSet

java.lang.Object

javax.sql.rowset.BaseRowSet

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

public abstract class BaseRowSet extends Object implements Serializable, Cloneable

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

1.0 Обзор

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

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

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

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

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

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

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

Когда rowset получает данные из реляционной базы данных, он выполняет команду (запрос), которая производит объект ResultSet. Этот запрос является командой, которая устанавливается для свойства команды объекта RowSet. 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 использует их для установки значений параметров-заполнителей перед отправкой команды в DBMS для выполнения.

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


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

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


    "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. Второй элемент – значение для установки второго параметра-заполнителя и так далее.

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

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

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

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

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

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

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

Существует три возможных события для объекта RowSet:

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

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

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

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

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

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

    crs.setMaxRows(500);

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

С:

1.5

См. также:

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

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

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

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

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

Модификатор и тип	Метод	Описание
`void`	`addRowSetListener(RowSetListener listener)`	Слушатель будет уведомляться всякий раз, когда на этом объекте `RowSet` произойдёт событие.
`void`	`clearParameters()`	Очищает все текущие значения параметров во внутренней представлении параметров этого объекта `RowSet`, которые должны быть установлены в команде этого объекта `RowSet` при её выполнении.
`String`	`getCommand()`	Возвращает SQL запрос, являющийся командой для этого объекта `RowSet`.
`int`	`getConcurrency()`	Возвращает конкурентность для этого объекта `RowSet`.
`String`	`getDataSourceName()`	Возвращает логическое имя, которое, при передаче в службу именования, использующую API Java Naming and Directory Interface (JNDI), позволит получить объект `javax.sql.DataSource`.
`boolean`	`getEscapeProcessing()`	Определяет, включена ли обработка экранирования для этого объекта `RowSet`.
`int`	`getFetchDirection()`	Возвращает текущее значение параметра направления выборки для этого объекта `RowSet`.
`int`	`getFetchSize()`	Возвращает размер выборки для этого объекта `RowSet`.
`int`	`getMaxFieldSize()`	Возвращает максимальное количество байтов, которое может быть использовано для значения столбца в этом объекте `RowSet`.
`int`	`getMaxRows()`	Возвращает максимальное количество строк, которое может содержать этот объект `RowSet`.
`Object[]`	`getParams()`	Возвращает массив, содержащий значения параметров (как объекты, так и примитивные типы), которые были установлены для команды этого объекта `RowSet`, и выбрасывает объект `SQLException`, если не все параметры не были установлены.
`String`	`getPassword()`	Возвращает пароль, используемый для создания подключения к базе данных для этого объекта `RowSet`.
`int`	`getQueryTimeout()`	Возвращает максимальное количество секунд, которое драйвер будет ждать выполнения запроса.
`boolean`	`getShowDeleted()`	Возвращает `boolean`, указывающий, отображаются ли в наборе текущих строк строки, помеченные на удаление.
`int`	`getTransactionIsolation()`	Возвращает свойство изоляции транзакции для подключения этого объекта `RowSet`.
`int`	`getType()`	Возвращает тип этого объекта `RowSet`.
`Map<String,Class<?>>`	`getTypeMap()`	Возвращает карту типов, связанную с объектом `Connection` для этого объекта `RowSet`.
`String`	`getUrl()`	Возвращает 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.math.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`.

END_OF_DOCUMENT_MARKER

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

END_OF_DOCUMENT_MARKER

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

Методы, объявленные в классе java.lang.Object

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

Подробное описание полей

UNICODE_STREAM_PARAM

public static final int UNICODE_STREAM_PARAM

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

См. также:

BINARY_STREAM_PARAM

public static final int BINARY_STREAM_PARAM

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

См. также:

ASCII_STREAM_PARAM

public static final int ASCII_STREAM_PARAM

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

См. также:

binaryStream

protected InputStream binaryStream

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

unicodeStream

protected InputStream unicodeStream

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

asciiStream

protected InputStream asciiStream

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

charStream

protected Reader charStream

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

Подробное описание конструкторов

BaseRowSet

public BaseRowSet()

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

Подробное описание методов

initParams

protected void initParams()

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

addRowSetListener

public void addRowSetListener(RowSetListener listener)

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

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

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

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

Параметры:

listener - объект, реализовавший интерфейс javax.sql.RowSetListener и желающий получать уведомления о любых событиях, происходящих в этом объекте RowSet; Может быть null.

См. также:

removeRowSetListener

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

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

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

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

Возвращает:

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

См. также:

END_OF_DOCUMENT_MARKER

setCommand

public void setCommand(String cmd) throws SQLException

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

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

Parameters:

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

Throws:

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

See Also:

getUrl

public String getUrl() throws SQLException

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

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

Returns:

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

Throws:

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

See Also:

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 внутри для создания подключения к базе данных для чтения или записи данных.

Parameters:

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

Throws:

SQLException - если при установке свойства Url произошла ошибка или переданный параметр — это строка длиной 0 (пустая строка)

See Also:

getDataSourceName

public String getDataSourceName()

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

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

Returns:

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

See Also:

setDataSourceName

public void setDataSourceName(String name) throws SQLException

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

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

Parameters:

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

Throws:

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

See Also:

getUsername

public String getUsername()

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

Returns:

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

See Also:

setUsername

public void setUsername(String name)

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

Parameters:

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

See Also:

getPassword

public String getPassword()

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

Returns:

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

See Also:

setPassword

public void setPassword(String pass)

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

Parameters:

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

See Also:

setType

public void setType(int type) throws SQLException

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

Parameters:

type - одно из следующих констант: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

Throws:

SQLException - если переданный параметр не является одной из следующих констант: ResultSet.TYPE_FORWARD_ONLY или ResultSet.TYPE_SCROLL_INSENSITIVE ResultSet.TYPE_SCROLL_SENSITIVE

See Also:

getType

public int getType() throws SQLException

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

Returns:

тип этого JDBC-объекта RowSet, который должен быть одним из следующих: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE

Throws:

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

See Also:

END_OF_DOCUMENT_MARKER

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

Возвращает:

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

См. также:

setReadOnly

public void setReadOnly(boolean value)

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

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

getTransactionIsolation

public int getTransactionIsolation()

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

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

Возвращает:

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

См. также:

setTransactionIsolation

public void setTransactionIsolation(int level) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getTypeMap

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

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

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

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

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

setTypeMap

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

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

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

getMaxFieldSize

public int getMaxFieldSize() throws SQLException

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

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

setMaxFieldSize

public void setMaxFieldSize(int max) throws SQLException

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

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

getMaxRows

public int getMaxRows() throws SQLException

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

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

setMaxRows

public void setMaxRows(int max) throws SQLException

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

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

setEscapeProcessing

public void setEscapeProcessing(boolean enable) throws SQLException

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

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

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

getQueryTimeout

public int getQueryTimeout() throws SQLException

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

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

setQueryTimeout

public void setQueryTimeout(int seconds) throws SQLException

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

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

getShowDeleted

public boolean getShowDeleted() throws SQLException

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

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

Возвращает:

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

Выбрасывает:

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

См. также:

setShowDeleted

public void setShowDeleted(boolean value) throws SQLException

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

Параметры:

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

Выбрасывает:

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

См. также:

getEscapeProcessing

public boolean getEscapeProcessing() throws SQLException

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

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

setFetchDirection

public void setFetchDirection(int direction) throws SQLException

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

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

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

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

Параметры:

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

Выбрасывает:

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

См. также:

getFetchDirection

public int getFetchDirection() throws SQLException

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

Возвращает:

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

Выбрасывает:

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

См. также:

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.

Параметры:

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

Выбрасывает:

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

См. также:

getFetchSize

public int getFetchSize() throws SQLException

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

Возвращает:

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

Выбрасывает:

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

См. также:

getConcurrency

public int getConcurrency() throws SQLException

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

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

Возвращает:

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

Выбрасывает:

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

См. также:

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

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

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

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

Parameters:

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 при отправке в базу данных.

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

Parameters:

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

Throws:

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

See Also:

setShort

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

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

ПРИМЕЧАНИЕ: 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, так как он не определен в этом классе.

Параметры:

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

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

Исключения:

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

См. также:

setLong

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

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

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

Параметры:

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

Исключения:

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

См. также:

setFloat

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

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

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

Параметры:

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

Исключения:

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

См. также:

setDouble

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

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

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

Параметры:

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

Исключения:

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

См. также:

setBigDecimal

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

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

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

Параметры:

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

Исключения:

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

См. также:

setString

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

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

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

Параметры:

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

Исключения:

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

См. также:

setBytes

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

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

ПРИМЕЧАНИЕ: 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.

Parameters:

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

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

Throws:

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

See Also:

setTime

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

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

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

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

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

Parameters:

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

Throws:

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

See Also:

setTimestamp

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

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

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

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

Parameters:

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

Throws:

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

See Also:

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.

Параметры:

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

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

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

Исключения:

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

См. также:

setBinaryStream

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

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

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

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

setUnicodeStream

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

Устаревший.

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

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

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

Данный метод устарел; вместо него следует использовать метод getCharacterStream.

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

Параметры:

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

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

Исключения:

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

См. также:

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

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

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

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

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

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

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

Параметры:

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

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

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

Исключения:

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

См. также:

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

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

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

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

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

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

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

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

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

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

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

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

Параметры:

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

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

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

Исключения:

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

См. также:

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.

Параметры:

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

Исключения:

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

См. также:

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

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

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

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

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

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

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

Параметры:

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

setTimestamp

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.

Parameters:

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

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

Throws:

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

See Also:

clearParameters

public void clearParameters() throws SQLException

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

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

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

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

Throws:: SQLException - если при очистке параметров произошла ошибка

getParams

public Object[] getParams() throws SQLException

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

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

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

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

setNull

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

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

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

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

setNull

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

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

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

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

setBoolean

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

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

Parameters:

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

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

Throws:

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

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

See Also:

setByte

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

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

Parameters:

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

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

Throws:

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

See Also:

setShort

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

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

Parameters:

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

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

Throws:

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

See Also:

setInt

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setLong

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setFloat

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setDouble

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setBigDecimal

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setString

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

Устанавливает указанный параметр в заданное значение Java String. Драйвер преобразует его в значение SQL VARCHAR или 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 TIMESTAMP при отправке в базу данных.

Параметры:

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

Примечание: Обратитесь к документации вашего драйвера 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.

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

setBlob

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

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

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

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

setBlob

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

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

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

setBlob

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

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

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

setBlob

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

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

setClob

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

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

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

setClob

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

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

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

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

setClob

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

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

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

setClob

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

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

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

setClob

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

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

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

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

setDate

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setDate

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

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

Параметры:

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

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

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

Исключения:

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

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

См. также:

setTime

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

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

Параметры:

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

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

Исключения:

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

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

См. также:

setTime

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

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

Параметры:

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

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

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

Исключения:

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

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

См. также:

setTimestamp

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

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

Параметры:

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

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

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

Исключения:

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

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

См. также:

setSQLXML

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

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

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

setSQLXML

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

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

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

setRowId

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

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

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

END_OF_DOCUMENT_MARKER

setRowId

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

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

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

setNString

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

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

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

setNString

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

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

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

setNCharacterStream

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

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

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

setNCharacterStream

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

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

setNCharacterStream

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

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

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

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

setNClob

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

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

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

setNClob

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

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

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

setNClob

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

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

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

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

setNClob

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

Устанавливает указанный параметр в объект типа Reader. Чтение должно содержать количество символов, указанное в length, иначе при выполнении PreparedStatement будет сгенерирована ошибка SQLException. Этот метод отличается от метода 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 при отправке в базу данных.

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

setNClob

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

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

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

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

setURL

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

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

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

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.sql.rowset/javax/sql/rowset/BaseRowSet.html