Интерфейс RowSet

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

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

public interface RowSet
extends ResultSet

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

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

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

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

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

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

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

С:: 1.4

Поля

Поля, унаследованные от интерфейса java.sql.ResultSet

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

Методы

Модификатор и тип	Метод и описание
`void`	`addRowSetListener(RowSetListener listener)` Регистрирует заданный слушатель, чтобы он получал уведомления о событиях, которые происходят на этом `RowSet` объекте.
`void`	`clearParameters()` Очищает параметры, заданные для команды этого `RowSet` объекта.
`void`	`execute()` Заполняет этот `RowSet` объект данными.
`String`	`getCommand()` Возвращает свойство команды этого `RowSet` объекта.
`String`	`getDataSourceName()` Возвращает логическое имя, которое идентифицирует источник данных для этого `RowSet` объекта.
`boolean`	`getEscapeProcessing()` Возвращает, включена ли обработка экранирования для этого `RowSet` объекта.
`int`	`getMaxFieldSize()` Возвращает максимальное количество байтов, которые могут быть возвращены для некоторых значений столбцов.
`int`	`getMaxRows()` Возвращает максимальное количество строк, которое может содержать этот `RowSet` объект.
`String`	`getPassword()` Возвращает пароль, используемый для создания подключения к базе данных.
`int`	`getQueryTimeout()` Возвращает максимальное количество секунд, которое драйвер будет ждать выполнения запроса.
`int`	`getTransactionIsolation()` Возвращает уровень изоляции транзакции, установленный для этого `RowSet` объекта.
`Map<String,Class<?>>`	`getTypeMap()` Возвращает `Map` объект, связанный с этим `RowSet` объектом, который определяет пользовательские сопоставления SQL типов, если таковые имеются.
`String`	`getUrl()` Возвращает свойство url, которое будет использовать этот `RowSet` объект для создания подключения, если он использует `DriverManager` вместо `DataSource` объекта для установления подключения.
`String`	`getUsername()` Возвращает имя пользователя, используемое для создания подключения к базе данных для этого `RowSet` объекта.
`boolean`	`isReadOnly()` Возвращает, является ли этот `RowSet` объект только для чтения.
`void`	`removeRowSetListener(RowSetListener listener)` Удаляет указанного слушателя из списка компонентов, которые будут получать уведомления, когда на этом `RowSet` объекте произойдет событие.
`void`	`setArray(int i, Array x)` Устанавливает указанный параметр в команде этого `RowSet` объекта со значением `Array`.
`void`	`setAsciiStream(int parameterIndex, InputStream x)` Устанавливает указанный параметр в команде этого `RowSet` объекта на заданный поток ввода.
`void`	`setAsciiStream(int parameterIndex, InputStream x, int length)` Устанавливает указанный параметр в команде этого `RowSet` объекта на заданное значение `java.io.InputStream`.
`void`	`setAsciiStream(String parameterName, InputStream x)` Устанавливает указанный параметр на заданный поток ввода.
`void`	`setAsciiStream(String parameterName, InputStream x, int length)` Устанавливает указанный параметр на заданный поток ввода, который будет иметь указанное количество байтов.
`void`	`setBigDecimal(int parameterIndex, BigDecimal x)` Устанавливает указанный параметр в команде этого `RowSet` объекта на заданное значение `java.math.BigDeciaml`.
`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 i, Blob x)` Устанавливает указанный параметр в команде этого `RowSet` объекта со значением `Blob`.
`void`	`setBlob(int parameterIndex, InputStream inputStream)` Устанавливает указанный параметр на объект `InputStream`.
`void`	`setBlob(int parameterIndex, InputStream inputStream, long length)` Устанавливает указанный параметр на объект `InputStream`.
`void`	`setBlob(String parameterName, Blob x)` Устанавливает указанный параметр на заданный объект `java.sql.Blob`.
`void`	`setBlob(String parameterName, InputStream inputStream)` Устанавливает указанный параметр на объект `InputStream`.
`void`	`setBlob(String parameterName, InputStream inputStream, long length)` Устанавливает указанный параметр на объект `InputStream`.
`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 i, Clob x)` Устанавливает указанный параметр в команде этого `RowSet` объекта со значением `Clob`.
`void`	`setClob(int parameterIndex, Reader reader)` Устанавливает указанный параметр на объект `Reader`.
`void`	`setClob(int parameterIndex, Reader reader, long length)` Устанавливает указанный параметр на объект `Reader`.
`void`	`setClob(String parameterName, Clob x)` Устанавливает указанный параметр на заданный объект `java.sql.Clob`.
`void`	`setClob(String parameterName, Reader reader)` Устанавливает указанный параметр на объект `Reader`.
`void`	`setClob(String parameterName, Reader reader, long length)` Устанавливает указанный параметр на объект `Reader`.
`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, NClob value)` Устанавливает указанный параметр на объект `java.sql.NClob`.
`void`	`setNClob(int parameterIndex, Reader reader)` Устанавливает указанный параметр на объект `Reader`.
`void`	`setNClob(int parameterIndex, Reader reader, long length)` Устанавливает указанный параметр на объект `Reader`.
`void`	`setNClob(String parameterName, NClob value)` Устанавливает указанный параметр на объект `java.sql.NClob`.
`void`	`setNClob(String parameterName, Reader reader)` Устанавливает указанный параметр на объект `Reader`.
`void`	`setNClob(String parameterName, Reader reader, long length)` Устанавливает указанный параметр на заданный объект `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(int parameterIndex, URL x)` Устанавливает указанный параметр на заданное значение `java.net.URL`.
`void`	`setUrl(String url)` Устанавливает URL, который будет использовать объект `RowSet` при использовании `DriverManager` для создания соединения.
`void`	`setUsername(String name)` Устанавливает свойство имени пользователя для объекта `RowSet` на заданное значение `String`.

Методы, унаследованные от интерфейса java.sql.ResultSet

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

Методы, унаследованные от интерфейса java.sql.Wrapper

isWrapperFor, unwrap

Методы

getUrl

String getUrl()
       throws SQLException

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

Возвращает:: строку url
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: setUrl(java.lang.String)

setUrl

void setUrl(String url)
     throws SQLException

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

Параметры:: url — строковое значение; может быть null
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getUrl()

getDataSourceName

String getDataSourceName()

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

Возвращает:: имя источника данных
См. также:: setDataSourceName(java.lang.String), setUrl(java.lang.String)

setDataSourceName

void setDataSourceName(String name)
                throws SQLException

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

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

Параметры:: name — логическое имя источника данных для объекта RowSet; может быть null
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getDataSourceName()

getUsername

String getUsername()

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

Возвращает:: свойство имени пользователя
См. также:: setUsername(java.lang.String)

setUsername

void setUsername(String name)
          throws SQLException

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

Параметры:: name — имя пользователя
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getUsername()

getPassword

String getPassword()

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

Возвращает:: пароль для подключения к базе данных
См. также:: setPassword(java.lang.String)

setPassword

void setPassword(String password)
          throws SQLException

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

Параметры:: password — строка пароля
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getPassword()

getTransactionIsolation

int getTransactionIsolation()

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

Возвращает:: уровень изоляции транзакций; одно из Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, или Connection.TRANSACTION_SERIALIZABLE
См. также:: setTransactionIsolation(int)

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 — если произошла ошибка доступа к базе данных
См. также:: getTransactionIsolation()

getTypeMap

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

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

Возвращает:: объект java.util.Map, содержащий имена пользовательских типов SQL и Java-классы, которым они должны быть сопоставлены
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)

setTypeMap

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

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

Параметры:: map — объект java.util.Map, содержащий имена пользовательских типов SQL и Java-классы, которым они должны быть сопоставлены
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getTypeMap()

getCommand

String getCommand()

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

Возвращает:: строка команды; может быть null
См. также:: setCommand(java.lang.String)

setCommand

void setCommand(String cmd)
         throws SQLException

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

Параметры:: cmd — запрос SQL, который будет использоваться для получения данных для этого объекта RowSet; может быть null
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getCommand()

isReadOnly

boolean isReadOnly()

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

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

Возвращает:: true если этот объект RowSet только для чтения; false если он обновляемый
См. также:: setReadOnly(boolean)

setReadOnly

void setReadOnly(boolean value)
          throws SQLException

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

Параметры:: value — true если только для чтения; false если обновляемый
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: isReadOnly()

getMaxFieldSize

int getMaxFieldSize()
             throws SQLException

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

Возвращает:: текущий предел размера столбца; ноль означает, что ограничения нет
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max)
              throws SQLException

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

Параметры:: max — новый предел максимального размера столбца в байтах; ноль означает неограниченный
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: getMaxFieldSize()

getMaxRows

int getMaxRows()
        throws SQLException

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

Возвращает:: текущее максимальное количество строк, которое может содержать этот объект RowSet; ноль означает неограниченное количество
Исключение:: SQLException — если произошла ошибка доступа к базе данных
См. также:: setMaxRows(int)

setMaxRows

void setMaxRows(int max)
         throws SQLException

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

Параметры:: max - новое максимальное число строк; ноль означает неограниченное количество
Исключения:: SQLException - если произошла ошибка доступа к базе данных
См. также:: getMaxRows()

getEscapeProcessing

boolean getEscapeProcessing()
                     throws SQLException

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

Возвращает:: true если обработка экранирования включена; false если она отключена
Исключения:: SQLException - если произошла ошибка доступа к базе данных
См. также:: setEscapeProcessing(boolean)

setEscapeProcessing

void setEscapeProcessing(boolean enable)
                  throws SQLException

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

Параметры:: enable - true для включения обработки экранирования; false для её отключения
Исключения:: SQLException - если произошла ошибка доступа к базе данных
См. также:: getEscapeProcessing()

getQueryTimeout

int getQueryTimeout()
             throws SQLException

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

Возвращает:: текущий предел таймаута запроса в секундах; ноль означает неограниченный
Исключения:: SQLException - если произошла ошибка доступа к базе данных
См. также:: setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds)
              throws SQLException

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

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

setType

void setType(int type)
      throws SQLException

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

Параметры:: type - одно из значений констант ResultSet , определяющих тип: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, или ResultSet.TYPE_SCROLL_SENSITIVE
Исключения:: SQLException - если произошла ошибка доступа к базе данных
См. также:: ResultSet.getType()

setConcurrency

void setConcurrency(int concurrency)
             throws SQLException

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

Параметры:: concurrency - одно из значений констант ResultSet , определяющих уровень параллельности: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE
Исключения:: SQLException - если произошла ошибка доступа к базе данных
См. также:: ResultSet.getConcurrency()

setNull

void setNull(int parameterIndex,
             int sqlType)
      throws SQLException

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

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

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

setNull

void setNull(String parameterName,
             int sqlType)
      throws SQLException

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

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

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

setNull

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

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

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

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

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
         throws SQLException

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

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

setBoolean

void setBoolean(String parameterName,
                boolean x)
         throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getBoolean(int)

setByte

void setByte(int parameterIndex,
             byte x)
      throws SQLException

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

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

setByte

void setByte(String parameterName,
             byte x)
      throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getByte(int)

setShort

void setShort(int parameterIndex,
              short x)
       throws SQLException

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

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

setShort

void setShort(String parameterName,
              short x)
       throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getShort(int)

setInt

void setInt(int parameterIndex,
            int x)
     throws SQLException

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

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

setInt

void setInt(String parameterName,
            int x)
     throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getInt(int)

setLong

void setLong(int parameterIndex,
             long x)
      throws SQLException

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

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

setLong

void setLong(String parameterName,
             long x)
      throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getLong(int)

setFloat

void setFloat(int parameterIndex,
              float x)
       throws SQLException

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

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

setFloat

void setFloat(String parameterName,
              float x)
       throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getFloat(int)

setDouble

void setDouble(int parameterIndex,
               double x)
        throws SQLException

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

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

setDouble

void setDouble(String parameterName,
               double x)
        throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getDouble(int)

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal x)
            throws SQLException

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

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

setBigDecimal

void setBigDecimal(String parameterName,
                   BigDecimal x)
            throws SQLException

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

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

setString

void setString(int parameterIndex,
               String x)
        throws SQLException

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

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

setString

void setString(String parameterName,
               String x)
        throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getString(int)

setBytes

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

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

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

setBytes

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

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getBytes(int)

setDate

void setDate(int parameterIndex,
             Date x)
      throws SQLException

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

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

setTime

void setTime(int parameterIndex,
             Time x)
      throws SQLException

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

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

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp x)
           throws SQLException

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

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

setTimestamp

void setTimestamp(String parameterName,
                  Timestamp x)
           throws SQLException

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

Параметры:: parameterName - имя параметра; x - значение параметра
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объекта CallableStatement; SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
С момента:: 1.4
См. также:: ResultSet.getTimestamp(int)

setAsciiStream

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

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

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

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

setAsciiStream

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

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

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

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

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

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream x)
              throws SQLException

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

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

Примечание: Обратитесь к документации драйвера 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, rowset должен вызвать метод 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 - если произошла ошибка доступа к базе данных
См. также:: Types

setObject

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

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

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

Параметры:: parameterName - имя параметра; x - объект, содержащий значение входного параметра; targetSqlType - тип SQL (как определено в java.sql.Types), который должен быть отправлен в базу данных. Аргумент scale может дополнительно квалифицировать этот тип.; scale - для типов java.sql.Types.DECIMAL или java.sql.Types.NUMERIC это число цифр после десятичной точки. Для всех других типов это значение будет проигнорировано.
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если targetSqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных
С:: 1.4
См. также:: Types, ResultSet.getObject(int)

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; SQLFeatureNotSupportedException - если targetSqlType является типом ARRAY, BLOB, CLOB, DATALINK, JAVA_OBJECT, NCHAR, NCLOB, NVARCHAR, LONGNVARCHAR, REF, ROWID, SQLXML или STRUCT и драйвер JDBC не поддерживает этот тип данных
С:: 1.4
См. также:: ResultSet.getObject(int)

setObject

void setObject(String parameterName,
               Object x)
        throws SQLException

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

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

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

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

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

setObject

void setObject(int parameterIndex,
               Object x)
        throws SQLException

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

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

Обратите внимание, что этот метод может использоваться для передачи абстрактных типов данных, специфичных для базы данных, с помощью типа Java, специфичного для драйвера. Если объект реализует SQLData, SQLData.writeSQL должен вызвать метод 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. Поток ввода должен содержать указанное количество байтов, иначе при выполнении PreparedStatement будет сгенерировано исключение. Этот метод отличается от метода setBinaryStream (int, InputStream, int), потому что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как BLOB. Когда используется метод setBinaryStream, драйверу может потребоваться выполнить дополнительные действия для определения, следует ли отправлять данные параметра на сервер как LONGVARBINARY или BLOB.

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

setBlob

void setBlob(int parameterIndex,
             InputStream inputStream)
      throws SQLException

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

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

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

setBlob

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

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

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

setBlob

void setBlob(String parameterName,
             Blob x)
      throws SQLException

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

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

setBlob

void setBlob(String parameterName,
             InputStream inputStream)
      throws SQLException

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

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

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

setClob

void setClob(int i,
             Clob x)
      throws SQLException

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

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

setClob

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

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

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

setClob

void setClob(int parameterIndex,
             Reader reader)
      throws SQLException

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

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

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

setClob

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

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

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

setClob

void setClob(String parameterName,
             Clob x)
      throws SQLException

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

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

setClob

void setClob(String parameterName,
             Reader reader)
      throws SQLException

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

setArray

void setArray(int i,
              Array x)
       throws SQLException

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

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

setDate

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

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

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

setDate

void setDate(String parameterName,
             Date x)
      throws SQLException

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

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

setDate

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

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

Параметры:: parameterName - имя параметра; x - значение параметра; cal - объект Calendar, который драйвер будет использовать для построения даты
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getDate(int)

setTime

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

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

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

setTime

void setTime(String parameterName,
             Time x)
      throws SQLException

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

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

setTime

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

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

Параметры:: parameterName - имя параметра; x - значение параметра; cal - объект Calendar для построения времени
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getTime(int)

setTimestamp

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

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

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

setTimestamp

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

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

Параметры:: parameterName - имя параметра; x - значение параметра; cal - объект Calendar для построения метки времени
Исключения:: SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого CallableStatement; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:: 1.4
См. также:: ResultSet.getTimestamp(int)

clearParameters

void clearParameters()
              throws SQLException

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

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

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

execute

void execute()
      throws SQLException

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

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

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

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

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

addRowSetListener

void addRowSetListener(RowSetListener listener)

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

Параметры:: listener - компонент, реализовавший интерфейс RowSetListener и желающий получать уведомления о событиях в этом объекте RowSet
См. также:: removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

void removeRowSetListener(RowSetListener listener)

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

Параметры:: listener - компонент, зарегистрированный в качестве слушателя для этого объекта RowSet
См. также:: addRowSetListener(javax.sql.RowSetListener)

setSQLXML

void setSQLXML(int parameterIndex,
               SQLXML xmlObject)
        throws SQLException

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

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

setSQLXML

void setSQLXML(String parameterName,
               SQLXML xmlObject)
        throws SQLException

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

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

setRowId

void setRowId(int parameterIndex,
              RowId x)
       throws SQLException

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

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

setRowId

void setRowId(String parameterName,
              RowId x)
       throws SQLException

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

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

setNString

void setNString(int parameterIndex,
                String value)
         throws SQLException

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

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

setNString

void setNString(String parameterName,
                String value)
         throws SQLException

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

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

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

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

setNClob

void setNClob(String parameterName,
              Reader reader)
       throws SQLException

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

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

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

setNClob

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

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

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

setNClob

void setNClob(int parameterIndex,
              NClob value)
       throws SQLException

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

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

setNClob

void setNClob(int parameterIndex,
              Reader reader)
       throws SQLException

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

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

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

setURL

void setURL(int parameterIndex,
            URL x)
     throws SQLException

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

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

© 1993, 2020, 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.