Интерфейс RowSet

Все суперинтерфейсы:: AutoCloseable, ResultSet, Wrapper

Все известные подинтерфейсы:: CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet

public interface RowSet extends ResultSet

Интерфейс, добавляющий поддержку модели компонентов JavaBeans в API JDBC. Набор строк, который можно использовать как компонент JavaBeans в среде визуальной разработки компонентов Bean, можно создать и настроить на этапе проектирования, а выполнить — во время выполнения.

Интерфейс RowSet предоставляет набор свойств JavaBeans, позволяющих настроить экземпляр RowSet для подключения к источнику данных JDBC и чтения данных из этого источника. Группа методов-сеттеров (setInt, setBytes, setString и т. д.) позволяет передавать входные параметры свойству команды набора строк. Эта команда представляет собой SQL-запрос, используемый набором строк для получения данных из реляционной базы данных, что обычно и происходит.

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

Интерфейс RowSet уникален тем, что предназначен для реализации с использованием остальных средств API JDBC. Иными словами, реализация RowSet — это программный слой, работающий «поверх» драйвера JDBC. Реализации интерфейса RowSet может предоставлять кто угодно, в том числе поставщики драйверов JDBC, желающие включить реализацию RowSet в состав своих продуктов JDBC.

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

С отключенным набором строк могут быть связаны Reader (объект RowSetReader) и средство записи (объект RowSetWriter). Средство Reader может быть реализовано различными способами для заполнения набора строк данными, включая получение данных из нереляционного источника. Средство записи также может быть реализовано различными способами для передачи изменений, внесенных в данные набора строк, обратно в базовый источник данных.

Наборы строк просты в использовании. Интерфейс RowSet расширяет стандартный интерфейс java.sql.ResultSet. Интерфейс RowSetMetaData расширяет интерфейс java.sql.ResultSetMetaData. Поэтому разработчикам, знакомым с API JDBC, потребуется изучить лишь небольшое количество новых API для работы с наборами строк. Кроме того, сторонние программные инструменты, работающие с объектами JDBC ResultSet, также будет легко адаптировать для работы с наборами строк.

Начиная с версии:: 1.4

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

Поля, объявленные в интерфейсе ResultSet

CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE

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

Модификатор и тип	Метод	Описание
`void`	`addRowSetListener(RowSetListener listener)`	Регистрирует указанный слушатель, чтобы он получал уведомления о событиях, происходящих с этим объектом `RowSet`.
`void`	`clearParameters()`	Очищает параметры, заданные для команды этого объекта `RowSet`.
`void`	`execute()`	Заполняет этот объект `RowSet` данными.
`String`	`getCommand()`	Возвращает свойство команды этого объекта `RowSet`.
`String`	`getDataSourceName()`	Возвращает логическое имя, идентифицирующее источник данных для этого объекта `RowSet`.
`boolean`	`getEscapeProcessing()`	Возвращает сведения о том, включена ли обработка escape-последовательностей для этого объекта `RowSet`.
`int`	`getMaxFieldSize()`	Возвращает максимальное количество байтов, которое может быть возвращено для определенных значений столбцов.
`int`	`getMaxRows()`	Возвращает максимальное количество строк, которое может содержать этот объект `RowSet`.
`String`	`getPassword()`	Возвращает пароль, использованный для создания подключения к базе данных.
`int`	`getQueryTimeout()`	Возвращает максимальное время в секундах, в течение которого драйвер будет ожидать выполнения оператора.
`int`	`getTransactionIsolation()`	Возвращает уровень изоляции транзакций, заданный для этого объекта `RowSet`.
`Map<String,Class<?>>`	`getTypeMap()`	Возвращает объект `Map`, связанный с этим объектом `RowSet` и задающий пользовательское сопоставление типов SQL, определенных пользователем, если оно имеется.
`String`	`getUrl()`	Возвращает свойство URL, которое этот объект `RowSet` будет использовать для создания подключения, если для установления подключения он использует `DriverManager` вместо объекта `DataSource`.
`String`	`getUsername()`	Возвращает имя пользователя, использованное для создания подключения к базе данных для этого объекта `RowSet`.
`boolean`	`isReadOnly()`	Возвращает сведения о том, доступен ли этот объект `RowSet` только для чтения.
`void`	`removeRowSetListener(RowSetListener listener)`	Удаляет указанный слушатель из списка компонентов, которые будут получать уведомления о событиях, происходящих с этим объектом `RowSet`.
`void`	`setArray(int i, Array x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `Array`.
`void`	`setAsciiStream(int parameterIndex, InputStream x)`	Задает указанный параметр команды этого объекта `RowSet` переданным входным потоком.
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `java.io.InputStream`.
`void`	`setAsciiStream(String parameterName, InputStream x)`	Задает указанный параметр переданным входным потоком.
`void`	`setAsciiStream(String parameterName, InputStream x, int length)`	Задает указанный параметр переданным входным потоком, содержащим указанное количество байтов.
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `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)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `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 i, Blob x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `Blob`.
`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)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `boolean`.
`void`	`setBoolean(String parameterName, boolean x)`	Задает указанный параметр переданным значением Java `boolean`.
`void`	`setByte(int parameterIndex, byte x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `byte`.
`void`	`setByte(String parameterName, byte x)`	Задает указанный параметр переданным значением Java `byte`.
`void`	`setBytes(int parameterIndex, byte[] x)`	Задает указанный параметр команды этого объекта `RowSet` переданным массивом Java значений `byte`.
`void`	`setBytes(String parameterName, byte[] x)`	Задает указанный параметр переданным массивом байтов Java.
`void`	`setCharacterStream(int parameterIndex, Reader reader)`	Задает указанный параметр команды этого объекта `RowSet` переданным объектом `Reader`.
`void`	`setCharacterStream(int parameterIndex, Reader reader, int length)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `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 i, Clob x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `Clob`.
`void`	`setClob(String parameterName, Reader reader)`	Задает указанный параметр объектом `Reader`.
`void`	`setClob(String parameterName, Reader reader, long length)`	Задает указанный параметр объектом `Reader`.
`void`	`setClob(String parameterName, Clob x)`	Задает указанный параметр переданным объектом `java.sql.Clob`.
`void`	`setCommand(String cmd)`	Задает свойству команды этого объекта `RowSet` переданный SQL-запрос.
`void`	`setConcurrency(int concurrency)`	Задает для этого объекта `RowSet` указанный уровень параллелизма.
`void`	`setDataSourceName(String name)`	Задает свойству имени источника данных этого объекта `RowSet` переданное значение `String`.
`void`	`setDate(int parameterIndex, Date x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `java.sql.Date`.
`void`	`setDate(int parameterIndex, Date x, Calendar cal)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `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)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `double`.
`void`	`setDouble(String parameterName, double x)`	Задает указанный параметр переданным значением Java `double`.
`void`	`setEscapeProcessing(boolean enable)`	Включает или отключает обработку escape-последовательностей для этого объекта `RowSet`.
`void`	`setFloat(int parameterIndex, float x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `float`.
`void`	`setFloat(String parameterName, float x)`	Задает указанный параметр переданным значением Java `float`.
`void`	`setInt(int parameterIndex, int x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `int`.
`void`	`setInt(String parameterName, int x)`	Задает указанный параметр переданным значением Java `int`.
`void`	`setLong(int parameterIndex, long x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `long`.
`void`	`setLong(String parameterName, long x)`	Задает указанный параметр переданным значением Java `long`.
`void`	`setMaxFieldSize(int max)`	Задает максимальное количество байтов, возвращаемое для значения столбца, равным переданному количеству байтов.
`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-команды этого объекта `RowSet` значением SQL `NULL`.
`void`	`setNull(int paramIndex, int sqlType, String typeName)`	Задает указанный параметр SQL-команды этого объекта `RowSet` значением 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)`	Задает указанный параметр команды этого объекта `RowSet` значением Java `Object`.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType)`	Задает указанный параметр команды этого объекта `RowSet` значением Java `Object`.
`void`	`setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `Object`.
`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 password)`	Задает для этого объекта `RowSet` пароль базы данных, указав значение `String`.
`void`	`setQueryTimeout(int seconds)`	Задает максимальное время в секундах, в течение которого драйвер будет ожидать выполнения оператора, указав переданное число секунд.
`void`	`setReadOnly(boolean value)`	Задает режим доступа этого объекта `RowSet` только для чтения в соответствии с переданным значением `boolean`.
`void`	`setRef(int i, Ref x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `Ref`.
`void`	`setRowId(int parameterIndex, RowId x)`	Задает указанный параметр переданным объектом `java.sql.RowId`.
`void`	`setRowId(String parameterName, RowId x)`	Задает указанный параметр переданным объектом `java.sql.RowId`.
`void`	`setShort(int parameterIndex, short x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `short`.
`void`	`setShort(String parameterName, short x)`	Задает указанный параметр переданным значением Java `short`.
`void`	`setSQLXML(int parameterIndex, SQLXML xmlObject)`	Задает указанный параметр переданным объектом `java.sql.SQLXML`.
`void`	`setSQLXML(String parameterName, SQLXML xmlObject)`	Задает указанный параметр переданным объектом `java.sql.SQLXML`.
`void`	`setString(int parameterIndex, String x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением Java `String`.
`void`	`setString(String parameterName, String x)`	Задает указанный параметр переданным значением Java `String`.
`void`	`setTime(int parameterIndex, Time x)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `java.sql.Time`.
`void`	`setTime(int parameterIndex, Time x, Calendar cal)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `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)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `java.sql.Timestamp`.
`void`	`setTimestamp(int parameterIndex, Timestamp x, Calendar cal)`	Задает указанный параметр команды этого объекта `RowSet` переданным значением `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)`	Задает уровень изоляции транзакций для этого объекта `RowSet`.
`void`	`setType(int type)`	Задает для этого объекта `RowSet` указанный тип.
`void`	`setTypeMap(Map<String,Class<?>> map)`	Устанавливает переданный объект `java.util.Map` в качестве карты типов по умолчанию для этого объекта `RowSet`.
`void`	`setUrl(String url)`	Задает URL, который этот объект `RowSet` будет использовать при создании подключения с помощью `DriverManager`.
`void`	`setURL(int parameterIndex, URL x)`	Задает указанный параметр переданным значением `java.net.URL`.
`void`	`setUsername(String name)`	Задает свойству имени пользователя этого объекта `RowSet` переданное значение `String`.

Методы, объявленные в интерфейсе ResultSet

absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull

Методы, объявленные в интерфейсе Wrapper

isWrapperFor, unwrap

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

getUrl

String getUrl() throws SQLException

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

Возвращает:

строковый URL

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

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

См. также:

setUrl

void setUrl(String url) throws SQLException

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

Параметры:

url — строковое значение; может быть null

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

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

См. также:

getDataSourceName

String getDataSourceName()

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

Возвращает:

имя источника данных

См. также:

setDataSourceName

void setDataSourceName(String name) throws SQLException

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

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

Параметры:

name — логическое имя источника данных для этого объекта RowSet; может быть null

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

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

См. также:

getUsername

String getUsername()

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

Возвращает:

свойство имени пользователя

См. также:

setUsername

void setUsername(String name) throws SQLException

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

Параметры:

name — имя пользователя

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

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

См. также:

getPassword

String getPassword()

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

Возвращает:

пароль для создания соединения с базой данных

См. также:

setPassword

void setPassword(String password) throws SQLException

Задает свойству пароля базы данных этого объекта RowSet указанное значение String.

Параметры:

password — строка пароля

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

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

См. также:

getTransactionIsolation

int getTransactionIsolation()

Возвращает уровень изоляции транзакций, заданный для этого объекта RowSet.

Возвращает:

уровень изоляции транзакций: Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE

См. также:

setTransactionIsolation

void setTransactionIsolation(int level) throws SQLException

Задает уровень изоляции транзакций для этого объекта RowSet.

Параметры:

level — уровень изоляции транзакций: Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ или Connection.TRANSACTION_SERIALIZABLE

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

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

См. также:

getTypeMap

Map<String,Class<?>> getTypeMap() throws SQLException

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

Возвращает:

объект java.util.Map, содержащий имена типов SQL, определенных пользователем, и классы Java, которым они должны быть сопоставлены

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

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

См. также:

setTypeMap

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

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

Параметры:

map — объект java.util.Map, содержащий имена типов SQL, определенных пользователем, и классы Java, которым они должны быть сопоставлены

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

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

См. также:

getCommand

String getCommand()

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

Возвращает:

строка команды; может быть null

См. также:

setCommand

void setCommand(String cmd) throws SQLException

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

Параметры:

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

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

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

См. также:

isReadOnly

boolean isReadOnly()

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

Попытка обновить набор строк, доступный только для чтения, приведет к выбрасыванию исключения SQLException.

Возвращает:

true, если этот объект RowSet доступен только для чтения; false, если он допускает обновление

См. также:

setReadOnly

void setReadOnly(boolean value) throws SQLException

Задает, доступен ли этот объект RowSet только для чтения, используя указанное значение boolean.

Параметры:

value — true, если доступен только для чтения; false, если допускает обновление

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

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

См. также:

getMaxFieldSize

int getMaxFieldSize() throws SQLException

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

Возвращает:

текущее ограничение максимального размера столбца; ноль означает отсутствие ограничения

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

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

См. также:

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

Задает максимальное количество байтов, возвращаемое для значения столбца, равным указанному количеству байтов. Это ограничение применяется только к столбцам BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR и NVARCHAR. Если ограничение превышено, лишние данные отбрасываются без уведомления. Для обеспечения максимальной переносимости используйте значения больше 256.

Параметры:

max — новое ограничение максимального размера столбца в байтах; ноль означает отсутствие ограничения

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

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

См. также:

getMaxRows

int getMaxRows() throws SQLException

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

Возвращает:

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

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

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

См. также:

setMaxRows

void setMaxRows(int max) throws SQLException

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

Параметры:

max — новое максимальное количество строк; ноль означает отсутствие ограничения

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

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

См. также:

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

Возвращает информацию о том, включена ли обработка escape-последовательностей для этого объекта RowSet. Если проверка escape-последовательностей включена (по умолчанию), драйвер заменит escape-последовательности перед отправкой SQL-оператора в базу данных.

Возвращает:

true, если обработка escape-последовательностей включена; false, если она отключена

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

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

См. также:

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

Включает или отключает обработку escape-последовательностей для этого объекта RowSet. Если проверка escape-последовательностей включена (по умолчанию), драйвер заменит escape-последовательности перед отправкой SQL-оператора в базу данных.

Параметры:

enable — true, чтобы включить обработку escape-последовательностей; false, чтобы отключить ее

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

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

См. также:

getQueryTimeout

int getQueryTimeout() throws SQLException

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

Возвращает:

текущее ограничение времени ожидания запроса в секундах; ноль означает отсутствие ограничения

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

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

См. также:

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

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

Параметры:

seconds — новое ограничение времени ожидания запроса в секундах; ноль означает отсутствие ограничения

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

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

См. также:

setType

void setType(int type) throws SQLException

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

Параметры:

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

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

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

См. также:

setConcurrency

void setConcurrency(int concurrency) throws SQLException

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

Параметры:

concurrency — одна из констант ResultSet, задающая уровень параллелизма: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE

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

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

См. также:

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

Задает указанному параметру SQL-команды этого объекта RowSet значение SQL NULL.

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; sqlType — код типа SQL, определенный в java.sql.Types
Выбрасывает:: SQLException — если возникает ошибка доступа к базе данных

setNull

void setNull(String parameterName, int sqlType) throws SQLException

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

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

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

setNull

void setNull(int paramIndex, int sqlType, String typeName) throws SQLException

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

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

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

setNull

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

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

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

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

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра
Выбрасывает:: SQLException — если возникает ошибка доступа к базе данных

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

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

Параметры:

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

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

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

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

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

Начиная с версии:

1.4

См. также:

setByte

void setByte(int parameterIndex, byte x) throws SQLException

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра
Выбрасывает:: SQLException — если возникает ошибка доступа к базе данных

setByte

void setByte(String parameterName, byte x) throws SQLException

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

Параметры:

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

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

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

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

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

Начиная с версии:

1.4

См. также:

setShort

void setShort(int parameterIndex, short x) throws SQLException

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра
Выбрасывает:: SQLException — если возникает ошибка доступа к базе данных

setShort

void setShort(String parameterName, short x) throws SQLException

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

Параметры:

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

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

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

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

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

Начиная с версии:

1.4

См. также:

setInt

void setInt(int parameterIndex, int x) throws SQLException

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра
Выбрасывает:: SQLException — если возникает ошибка доступа к базе данных

setInt

void setInt(String parameterName, int x) throws SQLException

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

Параметры:

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

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

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

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

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

Начиная с версии:

1.4

См. также:

setLong

void setLong(int parameterIndex, long x) throws SQLException

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

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

setLong

void setLong(String parameterName, long x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

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

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

setFloat

void setFloat(String parameterName, float x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

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

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

setDouble

void setDouble(String parameterName, double x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

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

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

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setString

void setString(int parameterIndex, String x) throws SQLException

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

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

setString

void setString(String parameterName, String x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setBytes

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

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

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

setBytes

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

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setDate

void setDate(int parameterIndex, Date x) throws SQLException

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

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

setTime

void setTime(int parameterIndex, Time x) throws SQLException

Устанавливает для указанного параметра в команде этого объекта RowSet заданное значение java.sql.Time. Перед отправкой в базу данных драйвер преобразует его в значение SQL TIME, используя часовой пояс по умолчанию java.util.Calendar для вычисления значения.

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

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

Устанавливает для указанного параметра в команде этого объекта RowSet заданное значение java.sql.Timestamp. Перед отправкой в базу данных драйвер преобразует его в значение SQL TIMESTAMP, используя часовой пояс по умолчанию java.util.Calendar для вычисления значения.

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

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с:

1.4

См. также:

setAsciiStream

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

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

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

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

setAsciiStream

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

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

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

setBinaryStream

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

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — входной поток Java, содержащий двоичное значение параметра; length — количество байтов в потоке
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setBinaryStream

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

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

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

setCharacterStream

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

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; reader — объект Reader, содержащий задаваемые данные UNICODE; length — количество символов в потоке
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setCharacterStream

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 не поддерживает этот метод
Начиная с:: 1.4

setAsciiStream

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

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

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

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

setBinaryStream

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

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

setCharacterStream

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

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

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

setNCharacterStream

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

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

Устанавливает заданный параметр команды объекта RowSet с указанным Java-значением Object. Для целочисленных значений следует использовать соответствующие объекты-эквиваленты java.lang (например, экземпляр класса Integer для int). Если второй аргумент — InputStream, поток должен содержать указанное в scaleOrLength число байтов. Если второй аргумент — Reader, Reader должно содержать указанное в scaleOrLength число символов. Если эти условия не выполняются, при выполнении подготовленного оператора драйвер сгенерирует SQLException.

Перед отправкой в базу данных указанный объект Java будет преобразован в targetSqlType.

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

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

Параметры:

parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.

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

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

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

Исключения:

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

См. также:

setObject

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-драйвер не поддерживает этот тип данных

Начиная с версии:

1.4

См. также:

setObject

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

Устанавливает заданный параметр команды объекта RowSet с помощью значения Java Object. Для целочисленных значений следует использовать соответствующие объекты-эквиваленты java.lang. Этот метод аналогичен описанному выше setObject, однако используется масштаб второго параметра. Скалярные значения имеют масштаб, равный нулю. Литералы имеют масштаб, заданный в литерале.

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

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

setObject

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

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

Параметры:

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

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

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

Исключения:

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

Начиная с версии:

1.4

См. также:

setObject

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-драйвер не поддерживает этот метод

Начиная с версии:

1.4

См. также:

setObject

void setObject(int parameterIndex, Object x) throws SQLException

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

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

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

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

setRef

void setRef(int i, Ref x) throws SQLException

Устанавливает заданный параметр команды объекта RowSet с помощью указанного значения Ref. Драйвер преобразует его в соответствующее значение REF(<structured-type>).

Параметры:: i — первый параметр имеет номер 1, второй — 2 и т. д.; x — объект, представляющий данные типа SQL REF
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setBlob

void setBlob(int i, Blob x) throws SQLException

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

Параметры:: i — первый параметр имеет номер 1, второй — 2 и т. д.; x — объект, представляющий BLOB
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setBlob

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

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

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

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

void setBlob(String parameterName, InputStream inputStream) throws SQLException

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

setClob

void setClob(int i, Clob x) throws SQLException

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

Параметры:: i — первый параметр имеет номер 1, второй — 2 и т. д.; x — объект, представляющий CLOB
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setClob

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

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

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

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

void setClob(String parameterName, Reader reader) throws SQLException

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

setArray

void setArray(int i, Array x) throws SQLException

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

Параметры:: i — первый параметр имеет номер 1, второй — 2 и т. д.; x — объект, представляющий массив SQL
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setDate

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

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра; cal — объект java.util.Calendar, используемый для вычисления даты
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setDate

void setDate(String parameterName, Date x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

Начиная с версии:

1.4

См. также:

setDate

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 не поддерживает этот метод

С версии:

1.4

См. также:

setTime

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

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра; cal — объект java.util.Calendar, используемый для вычисления времени
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setTime

void setTime(String parameterName, Time x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С версии:

1.4

См. также:

setTime

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 не поддерживает этот метод

С версии:

1.4

См. также:

setTimestamp

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

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

Параметры:: parameterIndex — первый параметр имеет номер 1, второй — 2 и т. д.; x — значение параметра; cal — объект java.util.Calendar, используемый для вычисления метки времени
Исключения:: SQLException — если произошла ошибка доступа к базе данных

setTimestamp

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 не поддерживает этот метод

С версии:

1.4

См. также:

clearParameters

void clearParameters() throws SQLException

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

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

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

execute

void execute() throws SQLException

Заполняет этот объект RowSet данными.

Метод execute может использовать следующие свойства для создания соединения для чтения данных: URL, имя источника данных, имя пользователя, пароль, уровень изоляции транзакций и карту типов. Метод execute может использовать следующие свойства для создания оператора, выполняющего команду: команда, режим «только чтение», максимальный размер поля, максимальное количество строк, обработка escape-последовательностей и время ожидания запроса.

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

Если этот объект RowSet не поддерживает постоянное соединение с источником данных, он может использовать Reader (объект RowSetReader) для заполнения данными. В этом случае для этого объекта RowSet будет зарегистрирован Reader, а метод execute в рамках своей реализации вызовет метод readData объекта Reader.

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

addRowSetListener

void addRowSetListener(RowSetListener listener)

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

Параметры:

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

См. также:

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

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

Параметры:

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

См. также:

setSQLXML

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.
С версии:: 1.6

setSQLXML

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.
С версии:: 1.6

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

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

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

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

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

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

setNString

void setNString(int parameterIndex, String value) throws SQLException

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

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

setNString

void setNString(String parameterName, String value) throws SQLException

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

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

setNCharacterStream

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

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

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

setNCharacterStream

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

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

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

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

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

setNClob

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

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

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

setNClob

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

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

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

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

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

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

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

setNClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

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

setURL

void setURL(int parameterIndex, URL x) throws SQLException

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

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

© 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/javax/sql/RowSet.html