Интерфейс 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 может установить соединение с источником данных и поддерживать это соединение на протяжении всего своего жизненного цикла, в этом случае он называется подключённым набором строк. Набор строк также может установить соединение с источником данных, получить данные из него и затем закрыть соединение. Такой набор строк называется отключённым набором строк. Отключённый набор строк может вносить изменения в свои данные, пока он отключён, и затем отправлять изменения обратно в исходный источник данных, но для этого он должен возобновить соединение.

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

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

С тех пор как:: 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`.

`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)`	Устанавливает свойство username для этого объекта `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, либо имя источника данных, какое из них было установлено последним в не-null значении.

Параметры:

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

Исключения:

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

См. также:

getDataSourceName

String getDataSourceName()

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

Возвращает:

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

См. также:

setDataSourceName

void setDataSourceName(String name) throws SQLException

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

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

Параметры:

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

Исключения:

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

См. также:

getUsername

String getUsername()

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

Возвращает:

свойство username

См. также:

setUsername

void setUsername(String name) throws SQLException

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

Параметры:

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

Исключения:

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

См. также:

getPassword

String getPassword()

Возвращает пароль, используемый для создания подключения к базе данных. Свойство password устанавливается во время выполнения перед вызовом метода 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()

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

Возвращает:

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

См. также:

setCommand

void setCommand(String cmd) throws SQLException

Устанавливает свойство command этого 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-типов, определённых пользователем (UDT), и параметров типа REF. Примеры UDT включают: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов.

Примечание: Для обеспечения переносимости приложения должны указывать код SQL-типа и полное квалифицированное имя SQL-типа при указании параметра NULL UDT или REF параметра. В случае UDT имя является именем типа самого параметра. Для REF параметра имя является именем типа ссылаемого типа. Если JDBC-драйверу не нужна информация о коде типа или имени типа, он может её проигнорировать. Хотя она предназначена для параметров UDT и REF, этот метод может быть использован для установки параметра null любого 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-типа, заданное имя типа игнорируется.

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

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

setDouble

void setDouble(String parameterName, double x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С тех пор:

1.4

См. также:

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

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

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

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С тех пор:

1.4

См. также:

setString

void setString(int parameterIndex, String x) throws SQLException

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

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

setString

void setString(String parameterName, String x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С тех пор:

1.4

См. также:

setBytes

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

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

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

setBytes

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

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

Параметры:

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

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

Исключения:

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

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

С тех пор:

1.4

См. также:

setDate

void setDate(int parameterIndex, Date x) throws SQLException

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

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

setTime

void setTime(int parameterIndex, Time x) throws SQLException

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

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

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

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

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

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

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

Параметры:

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

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

Исключения:

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

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

С тех пор:

1.4

См. также:

setAsciiStream

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

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

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

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

setAsciiStream

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

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

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

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

setBinaryStream

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

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

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

setBinaryStream

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

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

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

setCharacterStream

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

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

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

setCharacterStream

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

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

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

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

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

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

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

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

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

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

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

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

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

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

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

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

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

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

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

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

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

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

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

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

setObject

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

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

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

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

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

Параметры:

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

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

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

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

Исключения:

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

См. также:

setObject

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

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

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

Параметры:

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

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

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

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

Исключения:

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

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

С момента:

1.4

См. также:

setObject

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

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

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

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

setObject

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

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

Параметры:

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

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

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

Исключения:

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

С:

1.4

См. также:

setObject

void setObject(String parameterName, Object x) throws SQLException

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

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

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

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

Параметры:

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

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

Исключения:

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

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

С:

1.4

См. также:

setObject

void setObject(int parameterIndex, Object x) throws SQLException

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

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

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

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

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

setRef

void setRef(int i, Ref x) throws SQLException

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

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

setBlob

void setBlob(int i, Blob x) throws SQLException

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

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

setBlob

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

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

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

setBlob

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

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

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

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

setBlob

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

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

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

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

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

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 будет сгенерирована ошибка. Этот метод отличается от метода 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 будет сгенерирована ошибка. Этот метод отличается от метода 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

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

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

END_OF_DOCUMENT_MARKER

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) для заполнения себя данными. В этом случае с этим объектом RowSet был зарегистрирован обработчик Reader, и метод execute вызовет метод readData обработчика Reader в рамках своей реализации.

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

addRowSetListener

void addRowSetListener(RowSetListener listener)

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

Parameters:

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

See Also:

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

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

Параметры:

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

См. также:

setSQLXML

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

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

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

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

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

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

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

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

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

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

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

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

setNString

void setNString(int parameterIndex, String value) throws SQLException

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

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

setNString

void setNString(String parameterName, String value) throws SQLException

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

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

setNCharacterStream

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

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

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

setNCharacterStream

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

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

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

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

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

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

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

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

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

setNClob

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

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

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

setNClob

void setNClob(String parameterName, Reader reader) throws SQLException

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

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

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

setNClob

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

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

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

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

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

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

setNClob

void setNClob(int parameterIndex, Reader reader) throws SQLException

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

setURL

void setURL(int parameterIndex, URL x) throws SQLException

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

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

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql/javax/sql/RowSet.html