Интерфейс RowSet

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

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

public interface RowSet extends ResultSet

Интерфейс, который добавляет поддержку модели компонентов JavaBeans к API JDBC. Набор строк (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 может иметь связанный с ним чтец (объект RowSetReader) и писателя (объект RowSetWriter). Чтец может быть реализован различными способами для заполнения rowset данными, включая получение данных из нереляционного источника данных. Писатель также может быть реализован различными способами для распространения изменений, внесённых в данные rowset, обратно в базовый источник данных.

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

С:: 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()`	Извлекает информацию о том, включена ли обработка экранирования для этого объекта `RowSet`.
`int`	`getMaxFieldSize()`	Извлекает максимальное количество байтов, которые могут быть возвращены для определенных значений столбцов.
`int`	`getMaxRows()`	Извлекает максимальное количество строк, которое может содержать этот объект `RowSet`.
`String`	`getPassword()`	Извлекает пароль, используемый для создания соединения с базой данных.
`int`	`getQueryTimeout()`	Извлекает максимальное количество секунд, в течение которых драйвер будет ожидать выполнения оператора.
`int`	`getTransactionIsolation()`	Извлекает уровень изоляции транзакций, установленный для этого объекта `RowSet`.
`Map<String,Class<?>>`	`getTypeMap()`	Извлекает объект `Map`, связанный с этим объектом `RowSet`, который указывает пользовательское сопоставление типов SQL, если таковое имеется.
`String`	`getUrl()`	Извлекает свойство url, которое этот объект `RowSet` будет использовать для создания соединения, если он использует `DriverManager` вместо объекта `DataSource` для установления соединения.
`String`	`getUsername()`	Извлекает имя пользователя, используемое для создания соединения с базой данных для этого объекта `RowSet`.
`boolean`	`isReadOnly()`	Извлекает информацию о том, является ли этот объект `RowSet` доступным только для чтения.
`void`	`removeRowSetListener(RowSetListener listener)`	Удаляет указанный прослушиватель из списка компонентов, которые будут получать уведомления о возникновении события в этом объекте `RowSet`.
`void`	`setArray(int i, Array x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` с заданным значением `Array`.
`void`	`setAsciiStream(int parameterIndex, InputStream x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданный входной поток.
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` со значением `java.io.InputStream`.
`void`	`setAsciiStream(String parameterName, InputStream x)`	Устанавливает назначенный параметр в заданный входной поток.
`void`	`setAsciiStream(String parameterName, InputStream x, int length)`	Устанавливает назначенный параметр в заданный входной поток, который будет иметь указанное количество байтов.
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` со значением `java.math.BigDecimal`.
`void`	`setBigDecimal(String parameterName, BigDecimal x)`	Устанавливает назначенный параметр в значение `java.math.BigDecimal`.
`void`	`setBinaryStream(int parameterIndex, InputStream x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданный входной поток.
`void`	`setBinaryStream(int parameterIndex, InputStream x, int length)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` со значением `java.io.InputStream`.
`void`	`setBinaryStream(String parameterName, InputStream x)`	Устанавливает назначенный параметр в заданный входной поток.
`void`	`setBinaryStream(String parameterName, InputStream x, int length)`	Устанавливает назначенный параметр в заданный входной поток, который будет иметь указанное количество байтов.
`void`	`setBlob(int parameterIndex, InputStream inputStream)`	Устанавливает назначенный параметр в объект `InputStream`.
`void`	`setBlob(int parameterIndex, InputStream inputStream, long length)`	Устанавливает назначенный параметр в объект `InputStream`.
`void`	`setBlob(int i, Blob x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` с заданным значением `Blob`.
`void`	`setBlob(String parameterName, InputStream inputStream)`	Устанавливает назначенный параметр в объект `InputStream`.
`void`	`setBlob(String parameterName, InputStream inputStream, long length)`	Устанавливает назначенный параметр в объект `InputStream`.
`void`	`setBlob(String parameterName, Blob x)`	Устанавливает назначенный параметр в заданный объект `java.sql.Blob`.
`void`	`setBoolean(int parameterIndex, boolean x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданное значение Java `boolean`.
`void`	`setBoolean(String parameterName, boolean x)`	Устанавливает назначенный параметр в заданное значение Java `boolean`.
`void`	`setByte(int parameterIndex, byte x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданное значение Java `byte`.
`void`	`setByte(String parameterName, byte x)`	Устанавливает назначенный параметр в заданное значение Java `byte`.
`void`	`setBytes(int parameterIndex, byte[] x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданный массив Java значений `byte`.
`void`	`setBytes(String parameterName, byte[] x)`	Устанавливает назначенный параметр в заданный массив байтов Java.
`void`	`setCharacterStream(int parameterIndex, Reader reader)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданный объект `Reader`.
`void`	`setCharacterStream(int parameterIndex, Reader reader, int length)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданное значение `java.io.Reader`.
`void`	`setCharacterStream(String parameterName, Reader reader)`	Устанавливает назначенный параметр в заданный объект `Reader`.
`void`	`setCharacterStream(String parameterName, Reader reader, int length)`	Устанавливает назначенный параметр в заданный объект `Reader`, длина которого составляет заданное количество символов.
`void`	`setClob(int parameterIndex, Reader reader)`	Устанавливает назначенный параметр в объект `Reader`.
`void`	`setClob(int parameterIndex, Reader reader, long length)`	Устанавливает назначенный параметр в объект `Reader`.
`void`	`setClob(int i, Clob x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` с заданным значением `Clob`.
`void`	`setClob(String parameterName, Reader reader)`	Устанавливает назначенный параметр в объект `Reader`.
`void`	`setClob(String parameterName, Reader reader, long length)`	Устанавливает назначенный параметр в объект `Reader`.
`void`	`setClob(String parameterName, Clob x)`	Устанавливает назначенный параметр в заданный объект `java.sql.Clob`.
`void`	`setCommand(String cmd)`	Устанавливает свойство команды этого объекта `RowSet` в заданный SQL-запрос.
`void`	`setConcurrency(int concurrency)`	Устанавливает уровень параллелизма этого объекта `RowSet` на заданный уровень.
`void`	`setDataSourceName(String name)`	Устанавливает свойство имени источника данных для этого объекта `RowSet` в заданное `String`.
`void`	`setDate(int parameterIndex, Date x)`	Устанавливает назначенный параметр в команде этого объекта `RowSet` в заданное значение `java.sql.Date`.

`void`	`setDate(int parameterIndex, Date x, Calendar cal)`	Устанавливает указанный параметр в команде этого объекта `RowSet` с заданным значением `java.sql.Date`.
`void`	`setDate(String parameterName, Date x)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`, используя по умолчанию часовой пояс виртуальной машины, на которой выполняется приложение.
`void`	`setDate(String parameterName, Date x, Calendar cal)`	Устанавливает указанный параметр в заданное значение `java.sql.Date`, используя указанный объект `Calendar`.
`void`	`setDouble(int parameterIndex, double x)`	Устанавливает указанный параметр в команде этого объекта `RowSet` в заданное значение Java `double`.
`void`	`setDouble(String parameterName, double x)`	Устанавливает указанный параметр в заданное значение Java `double`.
`void`	`setEscapeProcessing(boolean enable)`	Включает или отключает обработку экранирования для этого объекта `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`.

END_OF_DOCUMENT_MARKER

`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

void setUrl(String url) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getDataSourceName

String getDataSourceName()

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

Возвращает:

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

См. также:

setDataSourceName

void setDataSourceName(String name) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getUsername

String getUsername()

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

Возвращает:

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

См. также:

setUsername

void setUsername(String name) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getPassword

String getPassword()

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

Возвращает:

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

См. также:

setPassword

void setPassword(String password) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getTransactionIsolation

int getTransactionIsolation()

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

Возвращает:

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

См. также:

setTransactionIsolation

void setTransactionIsolation(int level) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getTypeMap

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

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

Возвращает:

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

Исключения:

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

См. также:

setTypeMap

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

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

Параметры:

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

Исключения:

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

См. также:

getCommand

String getCommand()

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

Возвращает:

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

См. также:

setCommand

void setCommand(String cmd) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

isReadOnly

boolean isReadOnly()

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

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

Возвращает:

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

См. также:

setReadOnly

void setReadOnly(boolean value) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getMaxFieldSize

int getMaxFieldSize() throws SQLException

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

Возвращает:

текущий максимальный предел размера столбца; ноль означает, что предела нет

Исключения:

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

См. также:

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getMaxRows

int getMaxRows() throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setMaxRows

void setMaxRows(int max) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getQueryTimeout

int getQueryTimeout() throws SQLException

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

Возвращает:

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

Исключения:

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

См. также:

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

setType

void setType(int type) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

setConcurrency

void setConcurrency(int concurrency) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

Устанавливает назначенный параметр в операторе SQL этого объекта RowSet в SQL NULL.

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

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

setNull

void setNull(String parameterName, int sqlType) throws SQLException

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

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

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

setNull

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

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

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

Параметры:: paramIndex - первый параметр - 1, второй - 2 и т. д.; sqlType - значение из java.sql.Types; typeName - полное квалифицированное имя SQL UDT или имя типа SQL структурированного типа, на который ссылается параметр REF типа; игнорируется, если параметр не является UDT или REF типом
Исключения:: 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 значение перед отправкой в базу данных.

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setByte

void setByte(int parameterIndex, byte x) throws SQLException

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

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

setByte

void setByte(String parameterName, byte x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setShort

void setShort(int parameterIndex, short x) throws SQLException

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

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

setShort

void setShort(String parameterName, short x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setInt

void setInt(int parameterIndex, int x) throws SQLException

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

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

setInt

void setInt(String parameterName, int x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setLong

void setLong(int parameterIndex, long x) throws SQLException

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

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

setLong

void setLong(String parameterName, long x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

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

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

setFloat

void setFloat(String parameterName, float x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

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

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

setDouble

void setDouble(String parameterName, double x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

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

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

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setString

void setString(int parameterIndex, String x) throws SQLException

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

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

setString

void setString(String parameterName, String x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setBytes

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

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

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

setBytes

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

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setDate

void setDate(int parameterIndex, Date x) throws SQLException

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

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

setTime

void setTime(int parameterIndex, Time x) throws SQLException

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

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

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

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

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

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setAsciiStream

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

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

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

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

setAsciiStream

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

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

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

setBinaryStream

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

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

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

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

setBinaryStream

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

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

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

setCharacterStream

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

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

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

setCharacterStream

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

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

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

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

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

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

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

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

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

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

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

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

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

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

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

УстановитьПотокНациональныхСимволов

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

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

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

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

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

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

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

Указанный Java-объект будет преобразован в целевой тип targetSqlType перед отправкой в базу данных.

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

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

Параметры:

parameterIndex - номер параметра (1 для первого, 2 для второго и т.д.)

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

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

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

Исключения:

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

См. также:

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

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

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

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

Параметры:

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

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

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

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

Исключения:

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

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

С тех пор:

1.4

См. также:

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

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

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

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

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

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

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

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

Параметры:

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

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

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

Исключения:

С тех пор:

1.4

См. также:

setObject

void setObject(String parameterName, Object x) throws SQLException

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

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

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

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setObject

void setObject(int parameterIndex, Object x) throws SQLException

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

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

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

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

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

setRef

void setRef(int i, Ref x) throws SQLException

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

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

setBlob

void setBlob(int i, Blob x) throws SQLException

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

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

setBlob

void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException

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

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

setBlob

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

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

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

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

setBlob

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

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

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

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

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

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

setBlob

void setBlob(String parameterName, InputStream inputStream) throws SQLException

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

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

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

setClob

void setClob(int i, Clob x) throws SQLException

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

Parameters:: i - индекс параметра (1 для первого, 2 для второго и т. д.); x - объект, представляющий CLOB
Throws:: SQLException - если произошла ошибка доступа к базе данных

setClob

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

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

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

setClob

void setClob(int parameterIndex, Reader reader) throws SQLException

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

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

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

setClob

void setClob(String parameterName, Reader reader) throws SQLException

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

setArray

void setArray(int i, Array x) throws SQLException

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

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

setDate

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

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

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

setDate

void setDate(String parameterName, Date x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

setDate

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

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

Parameters:

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

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

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

Throws:

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

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

Since:

1.4

See Also:

setTime

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

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

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

setTime

void setTime(String parameterName, Time x) throws SQLException

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

Parameters:

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

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

Throws:

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

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

Since:

1.4

See Also:

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:

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:

clearParameters

void clearParameters() throws SQLException

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

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

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

execute

void execute() throws SQLException

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

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

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

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

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

addRowSetListener

void addRowSetListener(RowSetListener listener)

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

Parameters:

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

See Also:

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

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

Parameters:

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

See Also:

setSQLXML

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

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

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

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

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

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

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

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

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

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

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

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

setNString

void setNString(int parameterIndex, String value) throws SQLException

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

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

setNString

void setNString(String parameterName, String value) throws SQLException

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

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

setNCharacterStream

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

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

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

setNCharacterStream

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

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

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

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

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

setNClob

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

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

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

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException

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

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

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

Установка NClob

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

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

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

Установка NClob

void setNClob(int parameterIndex, NClob value) throws SQLException

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

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

Установка NClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

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

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

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

Установка URL

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