Интерфейс RowSet

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

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

public interface RowSet extends ResultSet

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

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

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

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

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

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

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

Since:: 1.4

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

Поля, объявленные в интерфейсе java.sql.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)`	Устанавливает свойство command объекта `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)`	Включает или выключает обработку экранирования для этого объекта `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`.

Методы, объявленные в интерфейсе java.sql.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

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

isWrapperFor, unwrap

Методы

getUrl

String getUrl() throws SQLException

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

Возвращает:

строку url

Исключения:

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

См. также:

setUrl(java.lang.String)

setUrl

void setUrl(String url) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getUrl()

getDataSourceName

String getDataSourceName()

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

Возвращает:

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

См. также:

setDataSourceName(java.lang.String)
setUrl(java.lang.String)

setDataSourceName

void setDataSourceName(String name) throws SQLException

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

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

Parameters:

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

Throws:

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

See Also:

getDataSourceName()

getUsername

String getUsername()

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

Returns:

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

See Also:

setUsername(java.lang.String)

setUsername

void setUsername(String name) throws SQLException

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

Parameters:

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

Throws:

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

See Also:

getUsername()

getPassword

String getPassword()

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

Returns:

пароль для подключения к базе данных

See Also:

setPassword(java.lang.String)

УстановитьПароль

void setPassword(String password) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getPassword()

ПолучитьИзоляциюТранзакции

int getTransactionIsolation()

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

Возвращает:

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

См. также:

setTransactionIsolation(int)

УстановитьИзоляциюТранзакции

void setTransactionIsolation(int level) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getTransactionIsolation()

ПолучитьКартуТипов

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

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

Возвращает:

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

Исключения:

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

См. также:

setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)

setTypeMap

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

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

Parameters:

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

Throws:

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

See Also:

getTypeMap()

getCommand

String getCommand()

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

Returns:

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

See Also:

setCommand(java.lang.String)

setCommand

void setCommand(String cmd) throws SQLException

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

Parameters:

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

Throws:

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

See Also:

getCommand()

isReadOnly

boolean isReadOnly()

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

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

Returns:

true, если этот объект RowSet только для чтения; false, если он обновляемый

See Also:

setReadOnly(boolean)

Установить только для чтения

void setReadOnly(boolean value) throws SQLException

Устанавливает, является ли этот RowSet объект только для чтения, в соответствии с заданным значением boolean.

Параметры:

value - true если только для чтения; false если изменяемый

Исключения:

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

См. также:

isReadOnly()

getMaxFieldSize

int getMaxFieldSize() throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getMaxFieldSize()

getMaxRows

int getMaxRows() throws SQLException

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

Возвращает:

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

Имеет исключения:

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

См. также:

setMaxRows(int)

setMaxRows

void setMaxRows(int max) throws SQLException

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

Параметры:

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

Имеет исключения:

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

См. также:

getMaxRows()

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

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

Возвращает:

true, если обработка экранирования включена; false, если она отключена

Имеет исключения:

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

См. также:

setEscapeProcessing(boolean)

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

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

Параметры:

enable - true для включения обработки экранирования; false для отключения

Имеет исключения:

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

См. также:

getEscapeProcessing()

getQueryTimeout

int getQueryTimeout() throws SQLException

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

Returns:

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

Throws:

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

См. также:

setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

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

Parameters:

seconds - новый лимит таймаута запроса в секундах; ноль означает, что лимита нет

Throws:

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

См. также:

getQueryTimeout()

setType

void setType(int type) throws SQLException

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

Parameters:

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

Throws:

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

См. также:

ResultSet.getType()

setConcurrency

void setConcurrency(int concurrency) throws SQLException

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

Parameters:

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

Throws:

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

См. также:

ResultSet.getConcurrency()

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 и именованные массивы типов.

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

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

setNull

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

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

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

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

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

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

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

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С:

1.4

См. также:

ResultSet.getBoolean(int)

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

См. также:

ResultSet.getByte(int)

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

См. также:

ResultSet.getShort(int)

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. Драйвер преобразует это в значение SQL, когда отправляет его в базу данных.

Параметры:

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

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

Исключения:

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

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

С:

1.4

См. также:

ResultSet.getInt(int)

setLong

void setLong(int parameterIndex, long x) throws SQLException

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

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

setLong

void setLong(String parameterName, long x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С:

1.4

См. также:

ResultSet.getLong(int)

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

См. также:

ResultSet.getFloat(int)

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

См. также:

ResultSet.getDouble(int)

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

См. также:

ResultSet.getBigDecimal(int, int)

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

См. также:

ResultSet.getString(int)

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

См. также:

ResultSet.getBytes(int)

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

См. также:

ResultSet.getTimestamp(int)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

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

void setAsciiStream(String parameterName, InputStream x) throws SQLException

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

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

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

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

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

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

Установить двоичный поток

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

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

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

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

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

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

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

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

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

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

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

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

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

См. также:

Types

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

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

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

Указанный 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 выше, но масштаб, используемый, — масштаб второго параметра. Скалярные значения имеют масштаб ноль. Литеральные значения имеют масштаб, присутствующий в литерале.

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

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

setObject

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

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

Parameters:

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

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

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

Throws:

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

Since:

1.4

See Also:

ResultSet.getObject(int)

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

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

См. также:

ResultSet.getObject(int)

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

void setObject(int parameterIndex, Object x) throws SQLException

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

Спецификация JDBC предоставляет стандартное отображение типов Java-объектов в типы SQL. Драйвер преобразует заданный Java-объект в его стандартное SQL-отображение перед отправкой в базу данных.

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

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

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

установитьСсылка

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

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

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

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

УстановитьCLOB

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

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

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

УстановитьCLOB

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

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

setClob

void setClob(String parameterName, Clob x) throws SQLException

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

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

УстановитьClob

void setClob(String parameterName, Reader reader) throws SQLException

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

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

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

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

void setArray(int i, Array x) throws SQLException

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

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

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

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

См. также:

ResultSet.getDate(int)

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

См. также:

ResultSet.getDate(int)

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

См. также:

ResultSet.getTime(int)

setTime

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

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

Parameters:

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

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

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

Throws:

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

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

Since:

1.4

See Also:

ResultSet.getTime(int)

setTimestamp

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

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

Parameters:: parameterIndex - номер параметра (1 для первого, 2 для второго и т.д.); x - значение параметра; cal - объект java.util.Calendar для вычисления временной метки
Throws:: SQLException - если произошла ошибка доступа к базе данных

setTimestamp

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

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

Parameters:

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

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

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

Throws:

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

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

Since:

1.4

See Also:

ResultSet.getTimestamp(int)

clearParameters

void clearParameters() throws SQLException

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

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

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

выполнить

void execute() throws SQLException

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

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

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

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

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

addRowSetListener

void addRowSetListener(RowSetListener listener)

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

Параметры:

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

См. также:

removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

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

Параметры:

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

См. также:

addRowSetListener(javax.sql.RowSetListener)

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

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

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

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

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

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

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

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

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

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

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

УстановитьNClob

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

Parameters:: parameterName - имя параметра, который необходимо установить; reader - объект, содержащий данные для установки значения параметра.; length - количество символов в данных параметра.
Throws:: SQLException - если parameterIndex не соответствует марке параметра в операторе SQL; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
Since:: 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, иначе при выполнении PreparedStatement будет сгенерировано исключение SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int), поскольку он сообщает драйверу, что значение параметра должно быть отправлено на сервер в качестве NCLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительные действия, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или как NCLOB.

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

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

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

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

setNClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

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

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

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

setURL

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, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.sql/javax/sql/RowSet.html