Класс BaseRowSet

java.lang.Object

javax.sql.rowset.BaseRowSet

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

public abstract class BaseRowSet extends Object implements Serializable, Cloneable

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

1.0 Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4.0 Обработка параметров под капотом

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

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

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

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

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

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

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

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

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

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

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

Для объекта RowSet возможны три типа событий:

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

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

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

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

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

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

   crs.setMaxRows(500);

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

С версии:

1.5

См. также:

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

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

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

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

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

Модификатор и тип	Метод	Описание
`void`	`addRowSetListener(RowSetListener listener)`	Слушатель будет получать уведомление при возникновении любого события в этом объекте `RowSet`.
`void`	`clearParameters()`	Очищает все текущие значения параметров во внутреннем представлении параметров этого объекта `RowSet`, которые необходимо задать в команде этого объекта `RowSet` при ее выполнении.
`String`	`getCommand()`	Возвращает SQL-запрос, являющийся командой для этого объекта `RowSet`.
`int`	`getConcurrency()`	Возвращает режим конкурентного доступа для этого объекта `RowSet`.
`String`	`getDataSourceName()`	Возвращает логическое имя, которое при передаче службе именования, использующей API Java Naming and Directory Interface (JNDI), позволит получить объект `javax.sql.DataSource`.
`boolean`	`getEscapeProcessing()`	Проверяет, включена ли обработка escape-последовательностей для этого объекта `RowSet`.
`int`	`getFetchDirection()`	Возвращает текущее значение направления выборки для этого объекта `RowSet`.
`int`	`getFetchSize()`	Возвращает размер выборки для этого объекта `RowSet`.
`int`	`getMaxFieldSize()`	Возвращает максимальное число байтов, используемых для значения столбца в этом объекте `RowSet`.
`int`	`getMaxRows()`	Возвращает максимальное количество строк, которое может содержать этот объект `RowSet`.
`Object[]`	`getParams()`	Возвращает массив, содержащий значения параметров (объекты и примитивы), заданные для команды этого объекта `RowSet`, и выбрасывает объект `SQLException`, если заданы не все параметры.
`String`	`getPassword()`	Возвращает пароль, использованный для создания подключения к базе данных для этого объекта `RowSet`.
`int`	`getQueryTimeout()`	Возвращает максимальное количество секунд, в течение которых драйвер будет ожидать выполнения запроса.
`boolean`	`getShowDeleted()`	Возвращает объект `boolean`, указывающий, отображаются ли в наборе текущих строк строки, помеченные для удаления.
`int`	`getTransactionIsolation()`	Возвращает свойство уровня изоляции транзакций для подключения этого объекта `RowSet`.
`int`	`getType()`	Возвращает тип этого объекта `RowSet`.
`Map<String,Class<?>>`	`getTypeMap()`	Возвращает карту типов, связанную с объектом `Connection` для этого объекта `RowSet`.
`String`	`getUrl()`	Возвращает URL JDBC, который объект `javax.sql.Reader` этого объекта `RowSet` использует для подключения к реляционной базе данных с помощью драйвера, поддерживающего технологию JDBC.
`String`	`getUsername()`	Возвращает имя пользователя, использованное для создания подключения к базе данных.
`protected void`	`initParams()`	Выполняет необходимые внутренние настройки и инициализацию, чтобы любая реализация JDBC `RowSet` могла начать использовать стандартные средства, предоставляемые экземпляром `BaseRowSet`.
`boolean`	`isReadOnly()`	Возвращает объект `boolean`, указывающий, доступен ли этот объект `RowSet` только для чтения.
`protected void`	`notifyCursorMoved()`	Уведомляет всех слушателей, зарегистрированных в этом объекте `RowSet`, о перемещении курсора.
`protected void`	`notifyRowChanged()`	Уведомляет всех слушателей, зарегистрированных в этом объекте `RowSet`, об изменении одной из его строк.
`protected void`	`notifyRowSetChanged()`	Уведомляет всех слушателей, зарегистрированных в этом объекте `RowSet`, об изменении его содержимого.
`void`	`removeRowSetListener(RowSetListener listener)`	Удаляет указанный объект из списка слушателей этого объекта `RowSet`.
`void`	`setArray(int parameterIndex, Array array)`	Задает указанному параметру объект `Array` на языке программирования Java.
`void`	`setAsciiStream(int parameterIndex, InputStream x)`	Задает указанный параметр в команде этого объекта `RowSet` равным указанному входному потоку.
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)`	Задает указанному параметру указанный объект `java.io.InputStream` с заданным количеством байтов.
`void`	`setAsciiStream(String parameterName, InputStream x)`	Задает указанному параметру указанный входной поток.
`void`	`setAsciiStream(String parameterName, InputStream x, int length)`	Задает указанному параметру указанный входной поток с заданным количеством байтов.
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)`	Задает указанному параметру указанное значение `java.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`.
`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`, определяющее, будет ли драйвер искать escape-синтаксис и выполнять его подстановку перед отправкой SQL-операторов в базу данных.
`void`	`setFetchDirection(int direction)`	Предоставляет драйверу рекомендацию по производительности относительно направления обработки строк в этом объекте `RowSet`.
`void`	`setFetchSize(int rows)`	Задает размер выборки для этого объекта `RowSet` равным указанному количеству строк.
`void`	`setFloat(int parameterIndex, float x)`	Задает указанному параметру указанный объект `float` на языке программирования Java.
`void`	`setFloat(String parameterName, float x)`	Задает указанному параметру указанное значение Java `float`.
`void`	`setInt(int parameterIndex, int x)`	Задает указанному параметру объект `int` на языке программирования Java.
`void`	`setInt(String parameterName, int x)`	Задает указанному параметру указанное значение Java `int`.
`void`	`setLong(int parameterIndex, long x)`	Задает указанному параметру указанный объект `long` на языке программирования Java.
`void`	`setLong(String parameterName, long x)`	Задает указанному параметру указанное значение Java `long`.
`void`	`setMaxFieldSize(int max)`	Задает максимальное количество байтов, используемых для значения столбца в этом объекте `RowSet`, равным указанному числу.
`void`	`setMaxRows(int max)`	Задает максимальное количество строк, которое может содержать этот объект `RowSet`, равным указанному числу.
`void`	`setNCharacterStream(int parameterIndex, Reader value)`	Задает указанный параметр в команде этого объекта `RowSet` равным объекту `Reader`.
`void`	`setNCharacterStream(int parameterIndex, Reader value, long length)`	Задает указанному параметру объект `Reader`.
`void`	`setNCharacterStream(String parameterName, Reader value)`	Задает указанному параметру объект `Reader`.
`void`	`setNCharacterStream(String parameterName, Reader value, long length)`	Задает указанному параметру объект `Reader`.
`void`	`setNClob(int parameterIndex, Reader reader)`	Задает указанному параметру объект `Reader`.
`void`	`setNClob(int parameterIndex, Reader reader, long length)`	Задает указанному параметру объект `Reader`.
`void`	`setNClob(int parameterIndex, NClob value)`	Задает указанному параметру объект `java.sql.NClob`.
`void`	`setNClob(String parameterName, Reader reader)`	Задает указанному параметру объект `Reader`.
`void`	`setNClob(String parameterName, Reader reader, long length)`	Задает указанному параметру объект `Reader`.
`void`	`setNClob(String parameterName, NClob value)`	Задает указанному параметру объект `java.sql.NClob`.
`void`	`setNString(int parameterIndex, String value)`	Задает указанному параметру указанный объект `String`.
`void`	`setNString(String parameterName, String value)`	Задает указанному параметру указанный объект `String`.
`void`	`setNull(int parameterIndex, int sqlType)`	Задает указанному параметру значение SQL `NULL`.
`void`	`setNull(int parameterIndex, int sqlType, String typeName)`	Задает указанному параметру значение SQL `NULL`.
`void`	`setNull(String parameterName, int sqlType)`	Задает указанному параметру значение SQL `NULL`.
`void`	`setNull(String parameterName, int sqlType, String typeName)`	Задает указанному параметру значение SQL `NULL`.
`void`	`setObject(int parameterIndex, Object x)`	Задает указанному параметру объект `Object` на языке программирования Java.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType)`	Задает значение указанного параметра равным указанному значению `Object`.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType, int scale)`	Задает указанному параметру объект `Object` на языке программирования Java.
`void`	`setObject(String parameterName, Object x)`	Задает значение указанного параметра равным указанному объекту.
`void`	`setObject(String parameterName, Object x, int targetSqlType)`	Задает значение указанного параметра равным указанному объекту.
`void`	`setObject(String parameterName, Object x, int targetSqlType, int scale)`	Задает значение указанного параметра равным указанному объекту.
`void`	`setPassword(String pass)`	Задает пароль, использованный для создания подключения к базе данных для этого объекта `RowSet`, равным указанному объекту `String`.
`void`	`setQueryTimeout(int seconds)`	Задает максимальное количество секунд, в течение которых драйвер будет ожидать выполнения запроса, равным указанному числу.
`void`	`setReadOnly(boolean value)`	Задает свойству readOnly этого объекта `RowSet` указанное значение `boolean`.
`void`	`setRef(int parameterIndex, Ref ref)`	Задает указанному параметру указанный объект `Ref` на языке программирования Java.
`void`	`setRowId(int parameterIndex, RowId x)`	Задает указанному параметру указанный объект `java.sql.RowId`.
`void`	`setRowId(String parameterName, RowId x)`	Задает указанному параметру указанный объект `java.sql.RowId`.
`void`	`setShort(int parameterIndex, short x)`	Задает указанному параметру указанный объект `short` на языке программирования Java.
`void`	`setShort(String parameterName, short x)`	Задает указанному параметру указанное значение Java `short`.
`void`	`setShowDeleted(boolean value)`	Задает свойству `showDeleted` указанное значение `boolean`, определяющее, отображаются ли в наборе текущих строк строки, помеченные для удаления.
`void`	`setSQLXML(int parameterIndex, SQLXML xmlObject)`	Задает указанному параметру указанный объект `java.sql.SQLXML`.
`void`	`setSQLXML(String parameterName, SQLXML xmlObject)`	Задает указанному параметру указанный объект `java.sql.SQLXML`.
`void`	`setString(int parameterIndex, String x)`	Задает указанному параметру указанное значение `String`.
`void`	`setString(String parameterName, String x)`	Задает указанному параметру указанное значение Java `String`.
`void`	`setTime(int parameterIndex, Time x)`	Задает указанному параметру указанное значение `java.sql.Time`.
`void`	`setTime(int parameterIndex, Time x, Calendar cal)`	Задает указанному параметру указанный объект `java.sql.Time`.
`void`	`setTime(String parameterName, Time x)`	Задает указанному параметру указанное значение `java.sql.Time`.
`void`	`setTime(String parameterName, Time x, Calendar cal)`	Задает указанному параметру указанное значение `java.sql.Time` с использованием указанного объекта `Calendar`.
`void`	`setTimestamp(int parameterIndex, Timestamp x)`	Задает указанному параметру указанное значение `java.sql.Timestamp`.
`void`	`setTimestamp(int parameterIndex, Timestamp x, Calendar cal)`	Задает указанному параметру указанный объект `java.sql.Timestamp`.
`void`	`setTimestamp(String parameterName, Timestamp x)`	Задает указанному параметру указанное значение `java.sql.Timestamp`.
`void`	`setTimestamp(String parameterName, Timestamp x, Calendar cal)`	Задает указанному параметру указанное значение `java.sql.Timestamp` с использованием указанного объекта `Calendar`.
`void`	`setTransactionIsolation(int level)`	Задает свойство уровня изоляции транзакций для этого объекта JDBC `RowSet` равным указанной константе.
`void`	`setType(int type)`	Задает для этого объекта `RowSet` указанный тип.
`void`	`setTypeMap(Map<String,Class<?>> map)`	Устанавливает указанный объект `java.util.Map` как карту типов, связанную с объектом `Connection` для этого объекта `RowSet`.
`void`	`setUnicodeStream(int parameterIndex, InputStream x, int length)`	Устарел. Вместо него следует использовать getCharacterStream
`void`	`setUrl(String url)`	Задает для свойства Url этого объекта `RowSet` указанный объект `String` и задает свойству имени dataSource значение `null`.
`void`	`setURL(int parameterIndex, URL x)`	Задает указанному параметру указанное значение `java.net.URL`.
`void`	`setUsername(String name)`	Задает свойству имени пользователя этого объекта `RowSet` указанное имя пользователя.

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

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

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

UNICODE_STREAM_PARAM

public static final int UNICODE_STREAM_PARAM

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

См. также:

BINARY_STREAM_PARAM

public static final int BINARY_STREAM_PARAM

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

См. также:

ASCII_STREAM_PARAM

public static final int ASCII_STREAM_PARAM

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

См. также:

binaryStream

protected InputStream binaryStream

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

unicodeStream

protected InputStream unicodeStream

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

asciiStream

protected InputStream asciiStream

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

charStream

protected Reader charStream

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

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

BaseRowSet

public BaseRowSet()

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

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

initParams

protected void initParams()

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

addRowSetListener

public void addRowSetListener(RowSetListener listener)

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

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

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

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

Параметры:

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

См. также:

removeRowSetListener

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.

Возвращает:

объект String, являющийся значением свойства command объекта RowSet; может иметь значение null

См. также:

setCommand

public void setCommand(String cmd) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getUrl

public String getUrl() throws SQLException

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

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

Возвращает:

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

Исключения:

SQLException — если при получении значения URL происходит ошибка

См. также:

setUrl

public void setUrl(String url) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getDataSourceName

public String getDataSourceName()

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

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

Возвращает:

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

См. также:

setDataSourceName

public void setDataSourceName(String name) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getUsername

public String getUsername()

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

Возвращает:

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

См. также:

setUsername

public void setUsername(String name)

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

Параметры:

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

См. также:

getPassword

public String getPassword()

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

Возвращает:

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

См. также:

setPassword

public void setPassword(String pass)

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

Параметры:

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

См. также:

setType

public void setType(int type) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getType

public int getType() throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setConcurrency

public void setConcurrency(int concurrency) throws SQLException

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

Параметры:

concurrency — одна из следующих констант: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

Исключения:

SQLException — если переданный параметр не является одной из следующих констант: ResultSet.CONCUR_UPDATABLE или ResultSet.CONCUR_READ_ONLY

См. также:

isReadOnly

public boolean isReadOnly()

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

Для реализаций 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

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

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

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

getQueryTimeout

public int getQueryTimeout() throws SQLException

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

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

setQueryTimeout

public void setQueryTimeout(int seconds) throws SQLException

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

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

getShowDeleted

public boolean getShowDeleted() throws SQLException

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

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

Возвращает:

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

Исключения:

SQLException — если при определении того, отображаются ли удаленные строки, произошла ошибка

См. также:

setShowDeleted

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 (далее — «драйвер 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. Значение по умолчанию для подключенных и отключенных объектов RowSet — CONCUR_UPDATABLE.

Приложение может в любое время вызвать метод 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.

Параметры:

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

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

Исключения:

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

См. также:

setNull

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

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

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

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

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

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

Параметры:

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

typeName — полное имя пользовательского типа SQL; игнорируется, если параметр не является пользовательским типом или значением REF

Исключения:

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

См. также:

setBoolean

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

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

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

Параметры:

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

Исключения:

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

См. также:

setByte

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

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

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

Параметры:

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

Исключения:

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

См. также:

setShort

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

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

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

Параметры:

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

Исключения:

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

См. также:

setInt

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

Задает указанному параметру значение int в языке программирования Java. При отправке значения в базу данных драйвер преобразует его в значение SQL INTEGER.

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

Параметры:

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.

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

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

Параметры:

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

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

Исключения:

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

См. также:

setString

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setBytes

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setDate

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

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setTime

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

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

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setTimestamp

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

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

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

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

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

Параметры:

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

Исключения:

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

См. также:

setAsciiStream

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

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

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

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

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

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

setAsciiStream

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

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

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

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

setBinaryStream

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

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

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

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

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

Параметры:

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

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

Исключения:

См. также:

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.

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

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

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

Параметры:

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

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

Исключения:

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

См. также:

setCharacterStream

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

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

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

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

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

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

Параметры:

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

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

Исключения:

См. также:

setCharacterStream

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

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

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

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

setObject

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

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

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

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

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

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

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

Параметры:

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

x — Object, содержащее входное значение параметра; должно иметь тип Object

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

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

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

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

См. также:

setObject

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

Устанавливает значение указанного параметра, используя заданное значение Object. Этот метод аналогичен

setObject(int parameterIndex, Object x, int
targetSqlType, int scale)

, но предполагает, что масштаб равен нулю.

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

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

Параметры:

x — Object, содержащее входное значение параметра; должно иметь тип Object

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

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

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

См. также:

setObject

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

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

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

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

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

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

Параметры:

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

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

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

См. также:

setRef

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

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

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

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

Параметры:

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

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

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

См. также:

setBlob

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

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

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

Параметры:

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

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

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

См. также:

setClob

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

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

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

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

Параметры:

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

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

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

См. также:

setArray

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

См. также:

setDate

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 — если произошла ошибка или индекс параметра выходит за допустимые границы

См. также:

setTime

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

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

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

Параметры:

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

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

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

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

См. также:

clearParameters

public void clearParameters() throws SQLException

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

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

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

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

Выбрасывает:: SQLException — если при удалении параметров произошла ошибка

getParams

public Object[] getParams() throws SQLException

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

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

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

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

setNull

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

Задаёт для указанного параметра значение SQL NULL.

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

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

setNull

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

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

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

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

setBoolean

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

Задаёт для указанного параметра переданное значение Java-типа boolean. При отправке значения в базу данных драйвер преобразует его в значение SQL типа BIT или BOOLEAN.

Параметры:

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

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

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

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

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

См. также:

setByte

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

Задаёт для указанного параметра переданное значение Java-типа byte. При отправке значения в базу данных драйвер преобразует его в значение SQL типа TINYINT.

Параметры:

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

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

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

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

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

См. также:

setShort

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

Задаёт для указанного параметра переданное значение Java-типа short. При отправке значения в базу данных драйвер преобразует его в значение SQL типа SMALLINT.

Параметры:

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

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

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

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

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

См. также:

setInt

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

Задаёт для указанного параметра переданное значение Java-типа 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

Задаёт для указанного параметра переданный входной поток, содержащий указанное число байтов. Если в параметр LONGVARCHAR передаётся очень большое значение ASCII, может быть удобнее передать его через 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, содержащий указанное число символов. Если в параметр LONGVARCHAR передаётся очень большое значение UNICODE, может быть удобнее передать его через объект 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

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

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

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

setBinaryStream

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

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

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

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

setCharacterStream

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

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

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

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

setNCharacterStream

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

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

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

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

setObject

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

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

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

Параметры:

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

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

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

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

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

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

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

См. также:

setObject

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

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

Параметры:

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

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

targetSqlType — тип SQL (определённый в java.sql.Types), передаваемый в базу данных

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

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

См. также:

setObject

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

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

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

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

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

Параметры:

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

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

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

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

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

См. также:

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 — имя устанавливаемого параметра, имя второго параметра — 2 и т. д.; inputStream — объект, содержащий данные, которыми следует установить значение параметра.; length — количество байтов в данных параметра.
Исключения:: SQLException — если parameterIndex не соответствует маркеру параметра в операторе SQL или если указанная длина меньше нуля; если количество байтов в InputStream не соответствует указанной длине; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.6

setBlob

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

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

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

setBlob

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

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

setClob

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

Устанавливает для указанного параметра объект Reader. 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

Параметры:: 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

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

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

setNClob

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

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

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

setNClob

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

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

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

setURL

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

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

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

© 1993, 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://docs.oracle.com/en/java/javase/25/docs/api/java.sql.rowset/javax/sql/rowset/BaseRowSet.html