Интерфейс ResultSet

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

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

public interface ResultSet extends Wrapper, AutoCloseable

Таблица данных, представляющая результирующий набор базы данных, который обычно создаётся при выполнении оператора, запрашивающего данные из базы данных.

Объект ResultSet хранит курсор, указывающий на текущую строку данных. Изначально курсор находится перед первой строкой. Метод next перемещает курсор к следующей строке и возвращает false, если в объекте ResultSet больше нет строк. Поэтому его можно использовать в цикле while для перебора результирующего набора.

Объект ResultSet по умолчанию не поддерживает обновление и имеет курсор, который перемещается только вперёд. Таким образом, его можно перебрать только один раз и только от первой строки до последней. Можно создавать объекты ResultSet с прокруткой и/или поддержкой обновления. В следующем фрагменте кода, где con — допустимый объект Connection, показано, как создать результирующий набор с прокруткой, нечувствительный к обновлениям, выполненным другими, и поддерживающий обновление. Другие варианты см. в полях ResultSet.


       Statement stmt = con.createStatement(
                                      ResultSet.TYPE_SCROLL_INSENSITIVE,
                                      ResultSet.CONCUR_UPDATABLE);
       ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2");
       // rs will be scrollable, will not show changes made by others,
       // and will be updatable

Интерфейс ResultSet предоставляет методы получения (getBoolean, getLong и т. д.) для извлечения значений столбцов из текущей строки. Значения можно извлекать по индексу столбца или по его имени. Как правило, использование индекса столбца более эффективно. Нумерация столбцов начинается с 1. Для максимальной переносимости следует считывать столбцы результирующего набора в каждой строке слева направо, причём каждый столбец следует считывать только один раз.

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

Имена столбцов, передаваемые методам получения, не учитывают регистр. Если метод получения вызывается с именем столбца, совпадающим с именами нескольких столбцов, возвращается значение первого подходящего столбца. Вариант с именем столбца предназначен для случаев, когда в SQL-запросе, создавшем результирующий набор, используются имена столбцов. Для столбцов, которым в запросе НЕ присвоены явные имена, лучше использовать номера столбцов. Если используются имена столбцов, программист должен позаботиться о том, чтобы они однозначно указывали на нужные столбцы; этого можно добиться с помощью предложения SQL AS.

В API JDBC 2.0 (Java 2 SDK, Standard Edition, версия 1.2) в этот интерфейс был добавлен набор методов обновления. Комментарии о параметрах методов получения также применимы к параметрам методов обновления.

Методы обновления можно использовать двумя способами:

для обновления значения столбца в текущей строке. В объекте ResultSet с прокруткой курсор можно перемещать назад и вперёд, в абсолютную позицию или в позицию относительно текущей строки. В следующем фрагменте кода обновляется столбец NAME в пятой строке объекта ResultSet rs, а затем с помощью метода updateRow обновляется таблица-источник данных, из которой был получен объект rs.
```
       rs.absolute(5); // moves the cursor to the fifth row of rs
       rs.updateString("NAME", "AINSWORTH"); // updates the
          // NAME column of row 5 to be AINSWORTH
       rs.updateRow(); // updates the row in the data source

 
```
для вставки значений столбцов в строку вставки. Объект ResultSet с поддержкой обновления имеет связанную с ним специальную строку, которая служит промежуточной областью для формирования вставляемой строки. В следующем фрагменте кода курсор перемещается к строке вставки, формируется строка из трёх столбцов, а затем она вставляется в rs и в таблицу-источник данных с помощью метода insertRow.
```
       rs.moveToInsertRow(); // moves cursor to the insert row
       rs.updateString(1, "AINSWORTH"); // updates the
          // first column of the insert row to be AINSWORTH
       rs.updateInt(2,35); // updates the second column to be 35
       rs.updateBoolean(3, true); // updates the third column to true
       rs.insertRow();
       rs.moveToCurrentRow();

 
```

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

Количество, типы и свойства столбцов объекта ResultSet предоставляет объект ResultSetMetaData, возвращаемый методом ResultSet.getMetaData.

С версии:

1.1

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`CLOSE_CURSORS_AT_COMMIT`	Константа, указывающая, что открытые объекты `ResultSet` с таким режимом сохранения будут закрыты при фиксации текущей транзакции.
`static final int`	`CONCUR_READ_ONLY`	Константа, указывающая режим параллельного доступа для объекта `ResultSet`, который НЕ может быть обновлён.
`static final int`	`CONCUR_UPDATABLE`	Константа, указывающая режим параллельного доступа для объекта `ResultSet`, который может быть обновлён.
`static final int`	`FETCH_FORWARD`	Константа, указывающая, что строки результирующего набора будут обрабатываться в прямом направлении: от первой к последней.
`static final int`	`FETCH_REVERSE`	Константа, указывающая, что строки результирующего набора будут обрабатываться в обратном направлении: от последней к первой.
`static final int`	`FETCH_UNKNOWN`	Константа, указывающая, что порядок обработки строк результирующего набора неизвестен.
`static final int`	`HOLD_CURSORS_OVER_COMMIT`	Константа, указывающая, что открытые объекты `ResultSet` с таким режимом сохранения останутся открытыми при фиксации текущей транзакции.
`static final int`	`TYPE_FORWARD_ONLY`	Константа, указывающая тип объекта `ResultSet`, курсор которого может перемещаться только вперёд.
`static final int`	`TYPE_SCROLL_INSENSITIVE`	Константа, указывающая тип объекта `ResultSet` с прокруткой, который обычно не чувствителен к изменениям данных, лежащих в основе `ResultSet`.
`static final int`	`TYPE_SCROLL_SENSITIVE`	Константа, указывающая тип объекта `ResultSet` с прокруткой, который обычно чувствителен к изменениям данных, лежащих в основе `ResultSet`.

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

Модификатор и тип	Метод	Описание
`boolean`	`absolute(int row)`	Перемещает курсор на указанную строку этого объекта `ResultSet`.
`void`	`afterLast()`	Перемещает курсор в конец этого объекта `ResultSet`, сразу после последней строки.
`void`	`beforeFirst()`	Перемещает курсор в начало этого объекта `ResultSet`, непосредственно перед первой строкой.
`void`	`cancelRowUpdates()`	Отменяет изменения, внесенные в текущую строку этого объекта `ResultSet`.
`void`	`clearWarnings()`	Удаляет все предупреждения, зарегистрированные для этого объекта `ResultSet`.
`void`	`close()`	Немедленно освобождает ресурсы базы данных и JDBC этого объекта `ResultSet` вместо того, чтобы ждать их автоматического освобождения при закрытии объекта.
`void`	`deleteRow()`	Удаляет текущую строку из этого объекта `ResultSet` и из базовой базы данных.
`int`	`findColumn(String columnLabel)`	Сопоставляет указанную метку столбца `ResultSet` с индексом столбца `ResultSet`.
`boolean`	`first()`	Перемещает курсор на первую строку этого объекта `ResultSet`.
`Array`	`getArray(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Array` в языке программирования Java.
`Array`	`getArray(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Array` в языке программирования Java.
`InputStream`	`getAsciiStream(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` в виде потока символов ASCII.
`InputStream`	`getAsciiStream(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` в виде потока символов ASCII.
`BigDecimal`	`getBigDecimal(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `java.math.BigDecimal` с полной точностью.
`BigDecimal`	`getBigDecimal(int columnIndex, int scale)`	Устарел. Используйте `getBigDecimal(int columnIndex)` или `getBigDecimal(String columnLabel)`
`BigDecimal`	`getBigDecimal(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `java.math.BigDecimal` с полной точностью.
`BigDecimal`	`getBigDecimal(String columnLabel, int scale)`	Устарел. Используйте `getBigDecimal(int columnIndex)` или `getBigDecimal(String columnLabel)`
`InputStream`	`getBinaryStream(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` в виде потока необработанных байтов.
`InputStream`	`getBinaryStream(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` в виде потока необработанных символов `byte`.
`Blob`	`getBlob(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Blob` в языке программирования Java.
`Blob`	`getBlob(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Blob` в языке программирования Java.
`boolean`	`getBoolean(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `boolean` в языке программирования Java.
`boolean`	`getBoolean(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `boolean` в языке программирования Java.
`byte`	`getByte(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `byte` в языке программирования Java.
`byte`	`getByte(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `byte` в языке программирования Java.
`byte[]`	`getBytes(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как массив `byte` в языке программирования Java.
`byte[]`	`getBytes(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как массив `byte` в языке программирования Java.
`Reader`	`getCharacterStream(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.io.Reader`.
`Reader`	`getCharacterStream(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.io.Reader`.
`Clob`	`getClob(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Clob` в языке программирования Java.
`Clob`	`getClob(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Clob` в языке программирования Java.
`int`	`getConcurrency()`	Возвращает режим параллельного доступа этого объекта `ResultSet`.
`String`	`getCursorName()`	Возвращает имя курсора SQL, используемого этим объектом `ResultSet`.
`Date`	`getDate(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Date` в языке программирования Java.
`Date`	`getDate(int columnIndex, Calendar cal)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Date` в языке программирования Java.
`Date`	`getDate(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Date` в языке программирования Java.
`Date`	`getDate(String columnLabel, Calendar cal)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Date` в языке программирования Java.
`double`	`getDouble(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `double` в языке программирования Java.
`double`	`getDouble(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `double` в языке программирования Java.
`int`	`getFetchDirection()`	Возвращает направление выборки для этого объекта `ResultSet`.
`int`	`getFetchSize()`	Возвращает размер выборки для этого объекта `ResultSet`.
`float`	`getFloat(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `float` в языке программирования Java.
`float`	`getFloat(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `float` в языке программирования Java.
`int`	`getHoldability()`	Возвращает режим сохранения курсора этого объекта `ResultSet`
`int`	`getInt(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `int` в языке программирования Java.
`int`	`getInt(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `int` в языке программирования Java.
`long`	`getLong(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `long` в языке программирования Java.
`long`	`getLong(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `long` в языке программирования Java.
`ResultSetMetaData`	`getMetaData()`	Возвращает количество, типы и свойства столбцов этого объекта `ResultSet`.
`Reader`	`getNCharacterStream(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.io.Reader`.
`Reader`	`getNCharacterStream(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.io.Reader`.
`NClob`	`getNClob(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `NClob` в языке программирования Java.
`NClob`	`getNClob(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `NClob` в языке программирования Java.
`String`	`getNString(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `String` в языке программирования Java.
`String`	`getNString(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `String` в языке программирования Java.
`Object`	`getObject(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `Object` в языке программирования Java.
`<T> T`	`getObject(int columnIndex, Class<T> type)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` и преобразует значение из типа SQL столбца в запрошенный тип данных Java, если преобразование поддерживается.
`Object`	`getObject(int columnIndex, Map<String,Class<?>> map)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `Object` в языке программирования Java.
`Object`	`getObject(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `Object` в языке программирования Java.
`<T> T`	`getObject(String columnLabel, Class<T> type)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` и преобразует значение из типа SQL столбца в запрошенный тип данных Java, если преобразование поддерживается.
`Object`	`getObject(String columnLabel, Map<String,Class<?>> map)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `Object` в языке программирования Java.
`Ref`	`getRef(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Ref` в языке программирования Java.
`Ref`	`getRef(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `Ref` в языке программирования Java.
`int`	`getRow()`	Возвращает номер текущей строки.
`RowId`	`getRowId(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.RowId` в языке программирования Java.
`RowId`	`getRowId(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.RowId` в языке программирования Java.
`short`	`getShort(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `short` в языке программирования Java.
`short`	`getShort(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `short` в языке программирования Java.
`SQLXML`	`getSQLXML(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.SQLXML` в языке программирования Java.
`SQLXML`	`getSQLXML(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.SQLXML` в языке программирования Java.
`Statement`	`getStatement()`	Возвращает объект `Statement`, создавший этот объект `ResultSet`.
`String`	`getString(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `String` в языке программирования Java.
`String`	`getString(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как `String` в языке программирования Java.
`Time`	`getTime(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Time` в языке программирования Java.
`Time`	`getTime(int columnIndex, Calendar cal)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Time` в языке программирования Java.
`Time`	`getTime(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Time` в языке программирования Java.
`Time`	`getTime(String columnLabel, Calendar cal)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Time` в языке программирования Java.
`Timestamp`	`getTimestamp(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Timestamp` в языке программирования Java.
`Timestamp`	`getTimestamp(int columnIndex, Calendar cal)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Timestamp` в языке программирования Java.
`Timestamp`	`getTimestamp(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Timestamp` в языке программирования Java.
`Timestamp`	`getTimestamp(String columnLabel, Calendar cal)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.sql.Timestamp` в языке программирования Java.
`int`	`getType()`	Возвращает тип этого объекта `ResultSet`.
`InputStream`	`getUnicodeStream(int columnIndex)`	Устарел. используйте `getCharacterStream` вместо `getUnicodeStream`
`InputStream`	`getUnicodeStream(String columnLabel)`	Устарел. используйте вместо него `getCharacterStream`
`URL`	`getURL(int columnIndex)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.net.URL` в языке программирования Java.
`URL`	`getURL(String columnLabel)`	Возвращает значение указанного столбца в текущей строке этого объекта `ResultSet` как объект `java.net.URL` в языке программирования Java.
`SQLWarning`	`getWarnings()`	Возвращает первое предупреждение, зарегистрированное вызовами для этого объекта `ResultSet`.
`void`	`insertRow()`	Вставляет содержимое строки вставки в этот объект `ResultSet` и в базу данных.
`boolean`	`isAfterLast()`	Возвращает признак того, что курсор находится после последней строки этого объекта `ResultSet`.
`boolean`	`isBeforeFirst()`	Возвращает признак того, что курсор находится перед первой строкой этого объекта `ResultSet`.
`boolean`	`isClosed()`	Возвращает признак того, что этот объект `ResultSet` закрыт.
`boolean`	`isFirst()`	Возвращает признак того, что курсор находится на первой строке этого объекта `ResultSet`.
`boolean`	`isLast()`	Возвращает признак того, что курсор находится на последней строке этого объекта `ResultSet`.
`boolean`	`last()`	Перемещает курсор на последнюю строку этого объекта `ResultSet`.
`void`	`moveToCurrentRow()`	Перемещает курсор в запомненную позицию, обычно на текущую строку.
`void`	`moveToInsertRow()`	Перемещает курсор на строку вставки.
`boolean`	`next()`	Перемещает курсор на одну строку вперед от текущей позиции.
`boolean`	`previous()`	Перемещает курсор на предыдущую строку этого объекта `ResultSet`.
`void`	`refreshRow()`	Обновляет текущую строку, используя ее последнее значение из базы данных.
`boolean`	`relative(int rows)`	Перемещает курсор на относительное число строк вперед или назад.
`boolean`	`rowDeleted()`	Возвращает признак того, что строка была удалена.
`boolean`	`rowInserted()`	Возвращает признак того, что в текущую строку была выполнена вставка.
`boolean`	`rowUpdated()`	Возвращает признак того, что текущая строка была обновлена.
`void`	`setFetchDirection(int direction)`	Дает подсказку о направлении обработки строк в этом объекте `ResultSet`.
`void`	`setFetchSize(int rows)`	Дает драйверу JDBC подсказку о количестве строк, которые следует извлечь из базы данных при необходимости получить дополнительные строки для этого объекта `ResultSet`.
`void`	`updateArray(int columnIndex, Array x)`	Обновляет указанный столбец значением `java.sql.Array`.
`void`	`updateArray(String columnLabel, Array x)`	Обновляет указанный столбец значением `java.sql.Array`.
`void`	`updateAsciiStream(int columnIndex, InputStream x)`	Обновляет указанный столбец значением потока ASCII.
`void`	`updateAsciiStream(int columnIndex, InputStream x, int length)`	Обновляет указанный столбец значением потока ASCII заданной длины в байтах.
`void`	`updateAsciiStream(int columnIndex, InputStream x, long length)`	Обновляет указанный столбец значением потока ASCII заданной длины в байтах.
`void`	`updateAsciiStream(String columnLabel, InputStream x)`	Обновляет указанный столбец значением потока ASCII.
`void`	`updateAsciiStream(String columnLabel, InputStream x, int length)`	Обновляет указанный столбец значением потока ASCII заданной длины в байтах.
`void`	`updateAsciiStream(String columnLabel, InputStream x, long length)`	Обновляет указанный столбец значением потока ASCII заданной длины в байтах.
`void`	`updateBigDecimal(int columnIndex, BigDecimal x)`	Обновляет указанный столбец значением `java.math.BigDecimal`.
`void`	`updateBigDecimal(String columnLabel, BigDecimal x)`	Обновляет указанный столбец значением `java.sql.BigDecimal`.
`void`	`updateBinaryStream(int columnIndex, InputStream x)`	Обновляет указанный столбец значением двоичного потока.
`void`	`updateBinaryStream(int columnIndex, InputStream x, int length)`	Обновляет указанный столбец значением двоичного потока заданной длины в байтах.
`void`	`updateBinaryStream(int columnIndex, InputStream x, long length)`	Обновляет указанный столбец значением двоичного потока заданной длины в байтах.
`void`	`updateBinaryStream(String columnLabel, InputStream x)`	Обновляет указанный столбец значением двоичного потока.
`void`	`updateBinaryStream(String columnLabel, InputStream x, int length)`	Обновляет указанный столбец значением двоичного потока заданной длины в байтах.
`void`	`updateBinaryStream(String columnLabel, InputStream x, long length)`	Обновляет указанный столбец значением двоичного потока заданной длины в байтах.
`void`	`updateBlob(int columnIndex, InputStream inputStream)`	Обновляет указанный столбец, используя заданный входной поток.
`void`	`updateBlob(int columnIndex, InputStream inputStream, long length)`	Обновляет указанный столбец, используя заданный входной поток длиной в указанное количество байтов.
`void`	`updateBlob(int columnIndex, Blob x)`	Обновляет указанный столбец значением `java.sql.Blob`.
`void`	`updateBlob(String columnLabel, InputStream inputStream)`	Обновляет указанный столбец, используя заданный входной поток.
`void`	`updateBlob(String columnLabel, InputStream inputStream, long length)`	Обновляет указанный столбец, используя заданный входной поток длиной в указанное количество байтов.

`void`	`updateBlob(String columnLabel, Blob x)`	Обновляет указанный столбец значением `java.sql.Blob`.
`void`	`updateBoolean(int columnIndex, boolean x)`	Обновляет указанный столбец значением `boolean`.
`void`	`updateBoolean(String columnLabel, boolean x)`	Обновляет указанный столбец значением `boolean`.
`void`	`updateByte(int columnIndex, byte x)`	Обновляет указанный столбец значением `byte`.
`void`	`updateByte(String columnLabel, byte x)`	Обновляет указанный столбец значением `byte`.
`void`	`updateBytes(int columnIndex, byte[] x)`	Обновляет указанный столбец значением массива `byte`.
`void`	`updateBytes(String columnLabel, byte[] x)`	Обновляет указанный столбец значением массива байтов.
`void`	`updateCharacterStream(int columnIndex, Reader x)`	Обновляет указанный столбец значением символьного потока.
`void`	`updateCharacterStream(int columnIndex, Reader x, int length)`	Обновляет указанный столбец значением символьного потока заданной длины в байтах.
`void`	`updateCharacterStream(int columnIndex, Reader x, long length)`	Обновляет указанный столбец значением символьного потока заданной длины в байтах.
`void`	`updateCharacterStream(String columnLabel, Reader reader)`	Обновляет указанный столбец значением символьного потока.
`void`	`updateCharacterStream(String columnLabel, Reader reader, int length)`	Обновляет указанный столбец значением символьного потока заданной длины в байтах.
`void`	`updateCharacterStream(String columnLabel, Reader reader, long length)`	Обновляет указанный столбец значением символьного потока заданной длины в байтах.
`void`	`updateClob(int columnIndex, Reader reader)`	Обновляет указанный столбец с помощью переданного объекта `Reader`.
`void`	`updateClob(int columnIndex, Reader reader, long length)`	Обновляет указанный столбец с помощью переданного объекта `Reader` заданной длины в символах.
`void`	`updateClob(int columnIndex, Clob x)`	Обновляет указанный столбец значением `java.sql.Clob`.
`void`	`updateClob(String columnLabel, Reader reader)`	Обновляет указанный столбец с помощью переданного объекта `Reader`.
`void`	`updateClob(String columnLabel, Reader reader, long length)`	Обновляет указанный столбец с помощью переданного объекта `Reader` заданной длины в символах.
`void`	`updateClob(String columnLabel, Clob x)`	Обновляет указанный столбец значением `java.sql.Clob`.
`void`	`updateDate(int columnIndex, Date x)`	Обновляет указанный столбец значением `java.sql.Date`.
`void`	`updateDate(String columnLabel, Date x)`	Обновляет указанный столбец значением `java.sql.Date`.
`void`	`updateDouble(int columnIndex, double x)`	Обновляет указанный столбец значением `double`.
`void`	`updateDouble(String columnLabel, double x)`	Обновляет указанный столбец значением `double`.
`void`	`updateFloat(int columnIndex, float x)`	Обновляет указанный столбец значением `float`.
`void`	`updateFloat(String columnLabel, float x)`	Обновляет указанный столбец значением `float`.
`void`	`updateInt(int columnIndex, int x)`	Обновляет указанный столбец значением `int`.
`void`	`updateInt(String columnLabel, int x)`	Обновляет указанный столбец значением `int`.
`void`	`updateLong(int columnIndex, long x)`	Обновляет указанный столбец значением `long`.
`void`	`updateLong(String columnLabel, long x)`	Обновляет указанный столбец значением `long`.
`void`	`updateNCharacterStream(int columnIndex, Reader x)`	Обновляет указанный столбец значением символьного потока.
`void`	`updateNCharacterStream(int columnIndex, Reader x, long length)`	Обновляет указанный столбец значением символьного потока заданной длины в байтах.
`void`	`updateNCharacterStream(String columnLabel, Reader reader)`	Обновляет указанный столбец значением символьного потока.
`void`	`updateNCharacterStream(String columnLabel, Reader reader, long length)`	Обновляет указанный столбец значением символьного потока заданной длины в байтах.
`void`	`updateNClob(int columnIndex, Reader reader)`	Обновляет указанный столбец с помощью переданного `Reader`. Данные будут считываться из потока по мере необходимости до достижения конца потока.
`void`	`updateNClob(int columnIndex, Reader reader, long length)`	Обновляет указанный столбец с помощью переданного объекта `Reader` заданной длины в символах.
`void`	`updateNClob(int columnIndex, NClob nClob)`	Обновляет указанный столбец значением `java.sql.NClob`.
`void`	`updateNClob(String columnLabel, Reader reader)`	Обновляет указанный столбец с помощью переданного объекта `Reader`.
`void`	`updateNClob(String columnLabel, Reader reader, long length)`	Обновляет указанный столбец с помощью переданного объекта `Reader` заданной длины в символах.
`void`	`updateNClob(String columnLabel, NClob nClob)`	Обновляет указанный столбец значением `java.sql.NClob`.
`void`	`updateNString(int columnIndex, String nString)`	Обновляет указанный столбец значением `String`.
`void`	`updateNString(String columnLabel, String nString)`	Обновляет указанный столбец значением `String`.
`void`	`updateNull(int columnIndex)`	Обновляет указанный столбец значением `null`.
`void`	`updateNull(String columnLabel)`	Обновляет указанный столбец значением `null`.
`void`	`updateObject(int columnIndex, Object x)`	Обновляет указанный столбец значением `Object`.
`void`	`updateObject(int columnIndex, Object x, int scaleOrLength)`	Обновляет указанный столбец значением `Object`.
`default void`	`updateObject(int columnIndex, Object x, SQLType targetSqlType)`	Обновляет указанный столбец значением `Object`.
`default void`	`updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength)`	Обновляет указанный столбец значением `Object`.
`void`	`updateObject(String columnLabel, Object x)`	Обновляет указанный столбец значением `Object`.
`void`	`updateObject(String columnLabel, Object x, int scaleOrLength)`	Обновляет указанный столбец значением `Object`.
`default void`	`updateObject(String columnLabel, Object x, SQLType targetSqlType)`	Обновляет указанный столбец значением `Object`.
`default void`	`updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength)`	Обновляет указанный столбец значением `Object`.
`void`	`updateRef(int columnIndex, Ref x)`	Обновляет указанный столбец значением `java.sql.Ref`.
`void`	`updateRef(String columnLabel, Ref x)`	Обновляет указанный столбец значением `java.sql.Ref`.
`void`	`updateRow()`	Обновляет базу данных, записывая в неё новое содержимое текущей строки этого объекта `ResultSet`.
`void`	`updateRowId(int columnIndex, RowId x)`	Обновляет указанный столбец значением `RowId`.
`void`	`updateRowId(String columnLabel, RowId x)`	Обновляет указанный столбец значением `RowId`.
`void`	`updateShort(int columnIndex, short x)`	Обновляет указанный столбец значением `short`.
`void`	`updateShort(String columnLabel, short x)`	Обновляет указанный столбец значением `short`.
`void`	`updateSQLXML(int columnIndex, SQLXML xmlObject)`	Обновляет указанный столбец значением `java.sql.SQLXML`.
`void`	`updateSQLXML(String columnLabel, SQLXML xmlObject)`	Обновляет указанный столбец значением `java.sql.SQLXML`.
`void`	`updateString(int columnIndex, String x)`	Обновляет указанный столбец значением `String`.
`void`	`updateString(String columnLabel, String x)`	Обновляет указанный столбец значением `String`.
`void`	`updateTime(int columnIndex, Time x)`	Обновляет указанный столбец значением `java.sql.Time`.
`void`	`updateTime(String columnLabel, Time x)`	Обновляет указанный столбец значением `java.sql.Time`.
`void`	`updateTimestamp(int columnIndex, Timestamp x)`	Обновляет указанный столбец значением `java.sql.Timestamp`.
`void`	`updateTimestamp(String columnLabel, Timestamp x)`	Обновляет указанный столбец значением `java.sql.Timestamp`.
`boolean`	`wasNull()`	Сообщает, имел ли последний считанный столбец значение SQL `NULL`.

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

isWrapperFor, unwrap

Подробное описание полей

FETCH_FORWARD

static final int FETCH_FORWARD

Константа, указывающая, что строки в результирующем наборе будут обрабатываться в прямом порядке — от первой к последней. Эта константа используется методом setFetchDirection как подсказка для драйвера, которую драйвер может проигнорировать.

Начиная с:

1.2

См. также:

FETCH_REVERSE

static final int FETCH_REVERSE

Константа, указывающая, что строки в результирующем наборе будут обрабатываться в обратном порядке — от последней к первой. Эта константа используется методом setFetchDirection как подсказка для драйвера, которую драйвер может проигнорировать.

Начиная с:

1.2

См. также:

FETCH_UNKNOWN

static final int FETCH_UNKNOWN

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

См. также:

TYPE_FORWARD_ONLY

static final int TYPE_FORWARD_ONLY

Константа, указывающая тип объекта ResultSet, курсор которого может перемещаться только вперёд.

Начиная с:

1.2

См. также:

TYPE_SCROLL_INSENSITIVE

static final int TYPE_SCROLL_INSENSITIVE

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

Начиная с:

1.2

См. также:

TYPE_SCROLL_SENSITIVE

static final int TYPE_SCROLL_SENSITIVE

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

Начиная с:

1.2

См. также:

CONCUR_READ_ONLY

static final int CONCUR_READ_ONLY

Константа, указывающая режим параллелизма для объекта ResultSet, который нельзя обновлять.

Начиная с:

1.2

См. также:

CONCUR_UPDATABLE

static final int CONCUR_UPDATABLE

Константа, указывающая режим параллелизма для объекта ResultSet, который можно обновлять.

Начиная с:

1.2

См. также:

HOLD_CURSORS_OVER_COMMIT

static final int HOLD_CURSORS_OVER_COMMIT

Константа, указывающая, что открытые объекты ResultSet с таким режимом удержания останутся открытыми после фиксации текущей транзакции.

Начиная с:

1.4

См. также:

CLOSE_CURSORS_AT_COMMIT

static final int CLOSE_CURSORS_AT_COMMIT

Константа, указывающая, что открытые объекты ResultSet с таким режимом удержания будут закрыты после фиксации текущей транзакции.

Начиная с:

1.4

См. также:

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

boolean next() throws SQLException

Перемещает курсор на одну строку вперёд от текущей позиции. Изначально курсор ResultSet находится перед первой строкой; первый вызов метода next делает текущей первую строку; второй вызов — вторую строку и так далее.

Когда вызов метода next возвращает false, курсор устанавливается после последней строки. Любой вызов метода ResultSet, которому требуется текущая строка, приведёт к выбросу SQLException. Если тип результирующего набора — TYPE_FORWARD_ONLY, поставщик определяет, вернёт ли реализация JDBC-драйвера false или выбросит SQLException при последующем вызове next.

Если для текущей строки открыт входной поток, вызов метода next неявно закроет его. Цепочка предупреждений объекта ResultSet очищается при чтении новой строки.

Возвращает:: true, если новая текущая строка является допустимой; false, если строк больше нет
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

close

void close() throws SQLException

Немедленно освобождает ресурсы базы данных и JDBC, связанные с этим объектом ResultSet, вместо того чтобы ждать их автоматического освобождения.

Закрытие объекта ResultSet не закрывает объекты Blob, Clob или NClob, созданные объектом ResultSet. Объекты Blob, Clob или NClob остаются действительными как минимум в течение транзакции, в которой они созданы, если не вызвать их метод free.

При закрытии ResultSet все экземпляры ResultSetMetaData, созданные вызовом метода getMetaData, остаются доступными.

Примечание: Объект ResultSet автоматически закрывается объектом Statement, который его создал, если этот объект Statement закрывается, выполняется повторно или используется для получения следующего результата из последовательности нескольких результатов.

Вызов метода close для уже закрытого объекта ResultSet не приводит к каким-либо действиям.

Определено в:: close в интерфейсе AutoCloseable
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных

wasNull

boolean wasNull() throws SQLException

Сообщает, имело ли значение последнего прочитанного столбца значение SQL NULL. Обратите внимание: сначала необходимо вызвать один из методов получения значения столбца, чтобы попытаться прочитать его, а затем вызвать метод wasNull, чтобы проверить, было ли прочитанное значение SQL NULL.

Возвращает:: true, если значение последнего прочитанного столбца было SQL NULL, и false в противном случае
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getString

String getString(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде String в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getBoolean

boolean getBoolean(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде boolean в языке программирования Java.

Если тип данных указанного столбца — CHAR или VARCHAR и он содержит «0» либо тип данных — BIT, TINYINT, SMALLINT, INTEGER или BIGINT и столбец содержит 0, возвращается значение false. Если тип данных указанного столбца — CHAR или VARCHAR и он содержит «1» либо тип данных — BIT, TINYINT, SMALLINT, INTEGER или BIGINT и столбец содержит 1, возвращается значение true.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается false
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getByte

byte getByte(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде byte в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getShort

short getShort(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде short в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getInt

int getInt(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде int в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getLong

long getLong(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде long в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getFloat

float getFloat(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде float в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getDouble

double getDouble(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде double в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getBigDecimal

@Deprecated(since="1.2") BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException

Устарело.

Используйте getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде java.sql.BigDecimal в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.; scale — количество цифр после десятичной точки
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

getBytes

byte[] getBytes(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде массива byte в языке программирования Java. Байты представляют собой необработанные значения, возвращаемые драйвером.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getDate

Date getDate(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Date в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getTime

Time getTime(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Time в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getTimestamp

Timestamp getTimestamp(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Timestamp в языке программирования Java.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getAsciiStream

InputStream getAsciiStream(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока символов ASCII. Значение можно считывать из потока фрагментами. Этот метод особенно подходит для получения больших значений LONGVARCHAR. JDBC-драйвер при необходимости преобразует данные из формата базы данных в ASCII.

Примечание: Все данные из возвращённого потока необходимо прочитать до получения значения любого другого столбца. Следующий вызов метода получения значения неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода InputStream.available независимо от наличия данных.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: входной поток Java, предоставляющий значение столбца базы данных в виде потока однобайтовых символов ASCII; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getUnicodeStream

@Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException

Устарело.

используйте getCharacterStream вместо getUnicodeStream

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока трёх двухбайтовых символов. Первый байт — старший, второй — младший. Значение можно считывать из потока фрагментами. Этот метод особенно подходит для получения больших значений LONGVARCHAR. JDBC-драйвер при необходимости преобразует данные из формата базы данных в Unicode.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: входной поток Java, предоставляющий значение столбца базы данных в виде потока двухбайтовых символов Unicode; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если JDBC-драйвер не поддерживает этот метод

getBinaryStream

InputStream getBinaryStream(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока необработанных байтов. Значение можно считывать из потока фрагментами. Этот метод особенно подходит для получения больших значений LONGVARBINARY.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2 и т. д.
Возвращает:: входной поток Java, предоставляющий значение столбца базы данных в виде потока необработанных байтов; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если индекс столбца недопустим, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getString

String getString(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращается null
Выбрасывает:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getBoolean

boolean getBoolean(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращается false
Выбрасывает:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getByte

byte getByte(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getShort

short getShort(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getInt

int getInt(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getLong

long getLong(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращается 0
Выбрасывает:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора

getFloat

float getFloat(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — 0
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getDouble

double getDouble(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — 0
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getBigDecimal

@Deprecated(since="1.2") BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException

Устарело.

Используйте getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде java.math.BigDecimal в языке программирования Java.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; scale — количество цифр после десятичной точки
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

getBytes

byte[] getBytes(String columnLabel) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде массива byte в языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getDate

Date getDate(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getTime

Time getTime(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getTimestamp

Timestamp getTimestamp(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца; если значение равно SQL NULL, возвращаемое значение — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getAsciiStream

InputStream getAsciiStream(String columnLabel) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока символов ASCII. Затем значение можно считывать из потока фрагментами. Этот метод особенно подходит для получения больших значений LONGVARCHAR. Драйвер JDBC выполнит необходимое преобразование из формата базы данных в ASCII.

Примечание: Все данные из возвращённого потока необходимо считать до получения значения любого другого столбца. Следующий вызов метода получения неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода available независимо от наличия доступных данных.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: входной поток Java, передающий значение столбца базы данных в виде потока однобайтовых символов ASCII. Если значение равно SQL NULL, возвращаемое значение — null.
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getUnicodeStream

@Deprecated(since="1.2") InputStream getUnicodeStream(String columnLabel) throws SQLException

Устарело.

вместо этого используйте getCharacterStream

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока двухбайтовых символов Unicode. Первый байт — старший, второй — младший. Затем значение можно считывать из потока фрагментами. Этот метод особенно подходит для получения больших значений LONGVARCHAR. Драйвер с поддержкой технологии JDBC выполнит необходимое преобразование из формата базы данных в Unicode.

Примечание: Все данные из возвращённого потока необходимо считать до получения значения любого другого столбца. Следующий вызов метода получения неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода InputStream.available независимо от наличия доступных данных.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: входной поток Java, передающий значение столбца базы данных в виде потока двухбайтовых символов Unicode. Если значение равно SQL NULL, возвращаемое значение — null.
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

getBinaryStream

InputStream getBinaryStream(String columnLabel) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока необработанных byte. Затем значение можно считывать из потока фрагментами. Этот метод особенно подходит для получения больших значений LONGVARBINARY.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: входной поток Java, передающий значение столбца базы данных в виде потока необработанных байтов; если значение равно SQL NULL, результат — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getWarnings

SQLWarning getWarnings() throws SQLException

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

Цепочка предупреждений автоматически очищается при каждом чтении новой строки. Этот метод нельзя вызывать для закрытого объекта ResultSet; такой вызов приведёт к выбросу SQLException.

Примечание: Эта цепочка предупреждений включает только предупреждения, вызванные методами ResultSet. Предупреждения, вызванные методами Statement (например, при чтении параметров OUT), будут связаны в цепочку с объектом Statement.

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

clearWarnings

void clearWarnings() throws SQLException

Очищает все предупреждения, зарегистрированные для этого объекта ResultSet. После вызова этого метода метод getWarnings возвращает null, пока для этого объекта ResultSet не будет зарегистрировано новое предупреждение.

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

getCursorName

String getCursorName() throws SQLException

Получает имя курсора SQL, используемого этим объектом ResultSet.

В SQL таблица результатов извлекается через именованный курсор. Текущую строку набора результатов можно обновить или удалить с помощью оператора позиционного обновления/удаления, ссылающегося на имя курсора. Чтобы обеспечить курсору надлежащий уровень изоляции для поддержки обновления, оператор SELECT курсора должен иметь вид SELECT FOR UPDATE. Если FOR UPDATE опущено, позиционные обновления могут завершиться ошибкой.

API JDBC поддерживает эту возможность SQL, предоставляя имя курсора SQL, используемого объектом ResultSet. Текущая строка объекта ResultSet также является текущей строкой этого курсора SQL.

Возвращает:: имя SQL-курсора этого объекта ResultSet
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод

getMetaData

ResultSetMetaData getMetaData() throws SQLException

Получает количество, типы и свойства столбцов этого объекта ResultSet.

Возвращает:: описание столбцов этого объекта ResultSet
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getObject

Object getObject(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде Object в языке программирования Java.

Этот метод возвращает значение заданного столбца как объект Java. Тип объекта Java соответствует типу объекта Java по умолчанию для типа SQL столбца согласно сопоставлению встроенных типов, определённому в спецификации JDBC. Если значение равно SQL NULL, драйвер возвращает объект Java null.

Этот метод также можно использовать для чтения абстрактных типов данных, специфичных для базы данных. В API JDBC 2.0 поведение метода getObject расширено для материализации данных пользовательских типов SQL.

Если Connection.getTypeMap не выбрасывает SQLFeatureNotSupportedException, то для столбца со структурированным или различаемым значением этот метод ведёт себя так, как если бы был вызван: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()). Если Connection.getTypeMap выбрасывает SQLFeatureNotSupportedException, структурированные значения не поддерживаются, а различаемые значения сопоставляются с классом Java по умолчанию, определяемым базовым типом SQL типа DISTINCT.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.
Возвращает:: объект java.lang.Object, содержащий значение столбца
Вызывает исключения:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getObject

Object getObject(String columnLabel) throws SQLException

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

В API JDBC 2.0 поведение метода getObject расширено для материализации данных пользовательских типов SQL. Для столбца со структурированным или различаемым значением этот метод ведёт себя так, как если бы был вызван: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()).

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: объект java.lang.Object, содержащий значение столбца
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

findColumn

int findColumn(String columnLabel) throws SQLException

Сопоставляет указанную метку столбца ResultSet с индексом столбца ResultSet.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: индекс столбца с указанным именем
Вызывает исключения:: SQLException — если объект ResultSet не содержит столбца с меткой columnLabel, произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getCharacterStream

Reader getCharacterStream(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.io.Reader.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.
Возвращает:: объект java.io.Reader, содержащий значение столбца; если значение равно SQL NULL, возвращаемое значение в языке программирования Java — null.
Вызывает исключения:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с версии:: 1.2

getCharacterStream

Reader getCharacterStream(String columnLabel) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.io.Reader.

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: объект java.io.Reader, содержащий значение столбца; если значение равно SQL NULL, возвращаемое значение в языке программирования Java — null
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с версии:: 1.2

getBigDecimal

BigDecimal getBigDecimal(int columnIndex) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде java.math.BigDecimal с полной точностью.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.
Возвращает:: значение столбца (с полной точностью); если значение равно SQL NULL, возвращаемое значение в языке программирования Java — null.
Вызывает исключения:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с версии:: 1.2

getBigDecimal

BigDecimal getBigDecimal(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца (с полной точностью); если значение равно SQL NULL, возвращаемое значение в языке программирования Java — null.
Вызывает исключения:: SQLException — если columnLabel недопустима; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с версии:: 1.2

isBeforeFirst

boolean isBeforeFirst() throws SQLException

Проверяет, находится ли курсор перед первой строкой этого объекта ResultSet.

Примечание:Поддержка метода isBeforeFirst необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY

Возвращает:: true, если курсор находится перед первой строкой; false, если курсор находится в любом другом положении или набор результатов не содержит строк
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

isAfterLast

boolean isAfterLast() throws SQLException

Проверяет, находится ли курсор после последней строки этого объекта ResultSet.

Примечание:Поддержка метода isAfterLast необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY

Возвращает:: true, если курсор находится после последней строки; false, если курсор находится в любом другом положении или набор результатов не содержит строк
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

isFirst

boolean isFirst() throws SQLException

Проверяет, находится ли курсор на первой строке этого объекта ResultSet.

Примечание:Поддержка метода isFirst необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY

Возвращает:: true, если курсор находится на первой строке; в противном случае — false
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

isLast

boolean isLast() throws SQLException

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

Примечание: Поддержка метода isLast необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY

Возвращает:: true, если курсор находится на последней строке; в противном случае — false
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

beforeFirst

void beforeFirst() throws SQLException

Перемещает курсор в начало этого объекта ResultSet, непосредственно перед первой строкой. Этот метод не действует, если набор результатов не содержит строк.

Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

afterLast

void afterLast() throws SQLException

Перемещает курсор в конец этого объекта ResultSet, непосредственно после последней строки. Этот метод не действует, если набор результатов не содержит строк.

Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

first

boolean first() throws SQLException

Перемещает курсор на первую строку этого объекта ResultSet.

Возвращает:: true, если курсор находится на допустимой строке; false, если набор результатов не содержит строк
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

last

boolean last() throws SQLException

Перемещает курсор на последнюю строку этого объекта ResultSet.

Возвращает:: true, если курсор находится на допустимой строке; false, если набор результатов не содержит строк
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных, этот метод вызван для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

getRow

int getRow() throws SQLException

Получает номер текущей строки. Первая строка имеет номер 1, вторая — номер 2 и т. д.

Примечание:Поддержка метода getRow необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY

Возвращает:: номер текущей строки; 0, если текущей строки нет
Вызывает исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

absolute

boolean absolute(int row) throws SQLException

Перемещает курсор на указанную строку в этом объекте ResultSet.

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

Если указанный номер строки отрицательный, курсор перемещается на абсолютную позицию строки относительно конца результирующего набора. Например, вызов метода absolute(-1) помещает курсор на последнюю строку; вызов метода absolute(-2) перемещает курсор на предпоследнюю строку и так далее.

Если указанный номер строки равен нулю, курсор перемещается перед первой строкой.

Попытка переместить курсор за пределы первой или последней строки результирующего набора оставляет курсор перед первой или после последней строки.

Примечание: Вызов absolute(1) эквивалентен вызову first(). Вызов absolute(-1) эквивалентен вызову last().

Параметры:: row — номер строки, на которую следует переместить курсор. Значение 0 означает, что курсор будет установлен перед первой строкой; положительное число указывает номер строки, отсчитываемый от начала результирующего набора; отрицательное число указывает номер строки, отсчитываемый от конца результирующего набора
Возвращает:: true, если курсор перемещен на позицию в этом объекте ResultSet; false, если курсор находится перед первой или после последней строки
Вызывает исключение:: SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого результирующего набора или тип результирующего набора — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

relative

boolean relative(int rows) throws SQLException

Перемещает курсор на относительное число строк, положительное или отрицательное. Попытка переместиться за пределы первой или последней строки результирующего набора устанавливает курсор перед первой или после последней строки. Вызов relative(0) допустим, но не изменяет положение курсора.

Примечание: вызов метода relative(1) эквивалентен вызову метода next(), а вызов метода relative(-1) эквивалентен вызову метода previous().

Параметры:: rows — int, указывающее число строк для перемещения от текущей строки; положительное число перемещает курсор вперед, отрицательное — назад
Возвращает:: true, если курсор находится на строке; в противном случае — false
Вызывает исключение:: SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого результирующего набора или тип результирующего набора — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

boolean previous() throws SQLException

Перемещает курсор на предыдущую строку в этом объекте ResultSet.

Если вызов метода previous возвращает false, курсор располагается перед первой строкой. Любой вызов метода ResultSet, которому требуется текущая строка, приведет к выбросу SQLException.

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

Возвращает:: true, если курсор теперь находится на допустимой строке; false, если курсор расположен перед первой строкой
Вызывает исключение:: SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого результирующего набора или тип результирующего набора — TYPE_FORWARD_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

setFetchDirection

void setFetchDirection(int direction) throws SQLException

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

Параметры:

direction — int, указывающее рекомендуемое направление выборки; одно из значений ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого результирующего набора, либо тип результирующего набора — TYPE_FORWARD_ONLY, а направление выборки не равно FETCH_FORWARD

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

1.2

См. также:

getFetchDirection

int getFetchDirection() throws SQLException

Возвращает направление выборки для этого объекта ResultSet.

Возвращает:

текущее направление выборки для этого объекта ResultSet

Вызывает исключение:

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

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

1.2

См. также:

setFetchSize

void setFetchSize(int rows) throws SQLException

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

Параметры:

rows — число строк для выборки

Вызывает исключение:

SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого результирующего набора или условие rows >= 0 не выполнено

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

1.2

См. также:

getFetchSize

int getFetchSize() throws SQLException

Возвращает размер выборки для этого объекта ResultSet.

Возвращает:

текущий размер выборки для этого объекта ResultSet

Вызывает исключение:

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

1.2

См. также:

getType

int getType() throws SQLException

Возвращает тип этого объекта ResultSet. Тип определяется объектом Statement, создавшим результирующий набор.

Возвращает:: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE или ResultSet.TYPE_SCROLL_SENSITIVE
Вызывает исключение:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора
Начиная с версии:: 1.2

getConcurrency

int getConcurrency() throws SQLException

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

Возвращает:: тип параллельного доступа: ResultSet.CONCUR_READ_ONLY или ResultSet.CONCUR_UPDATABLE
Вызывает исключение:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого результирующего набора
Начиная с версии:: 1.2

rowUpdated

boolean rowUpdated() throws SQLException

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

Примечание: Поддержка метода rowUpdated необязательна для результирующего набора с режимом параллельного доступа CONCUR_READ_ONLY

Возвращает:

true, если обнаружено, что текущая строка была явно обновлена владельцем или другим субъектом; в противном случае — false

Вызывает исключение:

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

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

1.2

См. также:

rowInserted

boolean rowInserted() throws SQLException

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

Примечание: Поддержка метода rowInserted необязательна для результирующего набора с режимом параллельного доступа CONCUR_READ_ONLY

Возвращает:

true, если обнаружено, что текущая строка была вставлена; в противном случае — false

Вызывает исключение:

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

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

1.2

См. также:

rowDeleted

boolean rowDeleted() throws SQLException

Возвращает сведения о том, была ли удалена строка. Удаленная строка может оставлять видимую «дыру» в результирующем наборе. Этот метод можно использовать для обнаружения таких дыр. Возвращаемое значение зависит от того, может ли этот объект ResultSet обнаруживать удаления.

Примечание: Поддержка метода rowDeleted необязательна для результирующего набора с режимом параллельного доступа CONCUR_READ_ONLY

Возвращает:

true, если обнаружено, что текущая строка была удалена владельцем или другим субъектом; в противном случае — false

Вызывает исключение:

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

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

1.2

См. также:

updateNull

void updateNull(int columnIndex) throws SQLException

Обновляет указанный столбец значением null. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBoolean

void updateBoolean(int columnIndex, boolean x) throws SQLException

Обновляет указанный столбец значением типа boolean. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateByte

void updateByte(int columnIndex, byte x) throws SQLException

Обновляет указанный столбец значением типа byte. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateShort

void updateShort(int columnIndex, short x) throws SQLException

Обновляет указанный столбец значением типа short. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateInt

void updateInt(int columnIndex, int x) throws SQLException

Обновляет указанный столбец значением типа int. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateLong

void updateLong(int columnIndex, long x) throws SQLException

Обновляет указанный столбец значением типа long. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateFloat

void updateFloat(int columnIndex, float x) throws SQLException

Обновляет указанный столбец значением типа float. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateDouble

void updateDouble(int columnIndex, double x) throws SQLException

Обновляет указанный столбец значением типа double. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBigDecimal

void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException

Обновляет указанный столбец значением типа java.math.BigDecimal. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateString

void updateString(int columnIndex, String x) throws SQLException

Обновляет указанный столбец значением типа String. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBytes

void updateBytes(int columnIndex, byte[] x) throws SQLException

Обновляет указанный столбец значением — массивом byte. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateDate

void updateDate(int columnIndex, Date x) throws SQLException

Обновляет указанный столбец значением типа java.sql.Date. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateTime

void updateTime(int columnIndex, Time x) throws SQLException

Обновляет указанный столбец значением типа java.sql.Time. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateTimestamp

void updateTimestamp(int columnIndex, Timestamp x) throws SQLException

Обновляет указанный столбец значением типа java.sql.Timestamp. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateAsciiStream

void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException

Обновляет указанный столбец значением в виде потока ASCII с указанным числом байтов. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца; length — длина потока
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBinaryStream

void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException

Обновляет указанный столбец значением в виде двоичного потока с указанным числом байтов. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца; length — длина потока
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateCharacterStream

void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException

Обновляет указанный столбец значением в виде символьного потока с указанным числом байтов. Методы обновления используются для изменения значений столбцов в текущей строке или в строке вставки. Методы обновления не изменяют базовую базу данных; для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца; length — длина потока
Вызывает исключение:: SQLException — если columnIndex недопустим; если произошла ошибка доступа к базе данных; если режим параллельного доступа результирующего набора — CONCUR_READ_ONLY или этот метод вызван для закрытого результирующего набора; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateObject

void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException

Обновляет указанную колонку значением Object. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Если второй аргумент является InputStream, поток должен содержать количество байтов, указанное в scaleOrLength. Если второй аргумент является Reader, объект reader должен содержать количество символов, указанное в scaleOrLength. Если эти условия не выполнены, при выполнении оператора драйвер сгенерирует SQLException.

Параметры:: columnIndex — первая колонка имеет номер 1, вторая — 2 и т. д.; x — новое значение колонки; scaleOrLength — для объекта java.math.BigDecimal это количество цифр после десятичной точки. Для типов объектов Java InputStream и Reader это длина данных в потоке или reader. Для всех остальных типов это значение игнорируется.
Исключения:: SQLException — если columnIndex имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateObject

void updateObject(int columnIndex, Object x) throws SQLException

Параметры:: columnIndex — первая колонка имеет номер 1, вторая — 2 и т. д.; x — новое значение колонки
Исключения:: SQLException — если columnIndex имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateNull

void updateNull(String columnLabel) throws SQLException

Обновляет указанную колонку значением null. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBoolean

void updateBoolean(String columnLabel, boolean x) throws SQLException

Обновляет указанную колонку значением boolean. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateByte

void updateByte(String columnLabel, byte x) throws SQLException

Обновляет указанную колонку значением byte. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateShort

void updateShort(String columnLabel, short x) throws SQLException

Обновляет указанную колонку значением short. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateInt

void updateInt(String columnLabel, int x) throws SQLException

Обновляет указанную колонку значением int. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateLong

void updateLong(String columnLabel, long x) throws SQLException

Обновляет указанную колонку значением long. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateFloat

void updateFloat(String columnLabel, float x) throws SQLException

Обновляет указанную колонку значением float. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateDouble

void updateDouble(String columnLabel, double x) throws SQLException

Обновляет указанную колонку значением double. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBigDecimal

void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException

Обновляет указанную колонку значением java.sql.BigDecimal. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateString

void updateString(String columnLabel, String x) throws SQLException

Обновляет указанную колонку значением String. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBytes

void updateBytes(String columnLabel, byte[] x) throws SQLException

Обновляет указанную колонку значением в виде массива байтов. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateDate

void updateDate(String columnLabel, Date x) throws SQLException

Обновляет указанную колонку значением java.sql.Date. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateTime

void updateTime(String columnLabel, Time x) throws SQLException

Обновляет указанную колонку значением java.sql.Time. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateTimestamp

void updateTimestamp(String columnLabel, Timestamp x) throws SQLException

Обновляет указанную колонку значением java.sql.Timestamp. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateAsciiStream

void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException

Обновляет указанную колонку значением в виде потока ASCII, содержащего указанное количество байтов. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки; length — длина потока
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateBinaryStream

void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException

Обновляет указанную колонку значением в виде двоичного потока, содержащего указанное количество байтов. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки; length — длина потока
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateCharacterStream

void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException

Обновляет указанную колонку значением в виде символьного потока, содержащего указанное количество байтов. Методы обновления используются для изменения значений колонок в текущей строке или строке вставки. Методы обновления не изменяют базу данных напрямую; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; reader — объект java.io.Reader, содержащий новое значение колонки; length — длина потока
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateObject

void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки; scaleOrLength — для объекта java.math.BigDecimal это количество цифр после десятичной точки. Для типов объектов Java InputStream и Reader это длина данных в потоке или reader. Для всех остальных типов это значение игнорируется.
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

updateObject

void updateObject(String columnLabel, Object x) throws SQLException

Параметры:: columnLabel — метка колонки, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, меткой является имя колонки; x — новое значение колонки
Исключения:: SQLException — если columnLabel имеет недопустимое значение; если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

insertRow

void insertRow() throws SQLException

Вставляет содержимое строки вставки в этот объект ResultSet и в базу данных. При вызове этого метода курсор должен находиться на строке вставки.

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

updateRow

void updateRow() throws SQLException

Обновляет базу данных новым содержимым текущей строки этого объекта ResultSet. Этот метод нельзя вызывать, когда курсор находится на строке вставки.

Исключения:: SQLException — если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY; если этот метод вызван для закрытого набора результатов или если при вызове метода курсор находится на строке вставки; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

deleteRow

void deleteRow() throws SQLException

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

Исключения:: SQLException — если произошла ошибка доступа к базе данных; если параллелизм набора результатов — CONCUR_READ_ONLY; если этот метод вызван для закрытого набора результатов или если при вызове метода курсор находится на строке вставки; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

refreshRow

void refreshRow() throws SQLException

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

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

Все значения повторно считываются с учетом уровня изоляции транзакции и чувствительности курсора. Если refreshRow вызван после вызова метода обновления, но до вызова метода updateRow, изменения строки будут потеряны. Частый вызов метода refreshRow, вероятно, снизит производительность.

Исключения:: SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого набора результатов; если тип набора результатов — TYPE_FORWARD_ONLY или если при вызове метода курсор находится на строке вставки; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод или если этот метод не поддерживается для указанного типа набора результатов и параллелизма набора результатов.
Начиная с версии:: 1.2

cancelRowUpdates

void cancelRowUpdates() throws SQLException

Отменяет изменения, внесенные в текущую строку этого объекта ResultSet. Этот метод можно вызвать после вызова одного или нескольких методов обновления и до вызова метода updateRow, чтобы отменить изменения строки. Если изменения не вносились или метод updateRow уже был вызван, этот метод ничего не делает.

Исключения:: SQLException — если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого набора результатов; если параллелизм набора результатов — CONCUR_READ_ONLY или если при вызове метода курсор находится на строке вставки; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.2

moveToInsertRow

void moveToInsertRow() throws SQLException

Перемещает курсор в строку вставки. Текущая позиция курсора запоминается, пока курсор находится в строке вставки. Строка вставки — это специальная строка, связанная с обновляемым набором результатов. По сути, это буфер, в котором можно создать новую строку, вызывая методы обновления перед вставкой строки в набор результатов. Когда курсор находится в строке вставки, можно вызывать только методы обновления, получения значений и insertRow. Перед вызовом insertRow при каждом вызове этого метода необходимо задать значения для всех столбцов набора результатов. Перед вызовом метода получения значения для столбца необходимо вызвать метод обновления.

Исключения:: SQLException — если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или параллелизм набора результатов равен CONCUR_READ_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

moveToCurrentRow

void moveToCurrentRow() throws SQLException

Перемещает курсор в запомненную позицию, обычно в текущую строку. Этот метод не действует, если курсор не находится в строке вставки.

Исключения:: SQLException — если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или параллелизм набора результатов равен CONCUR_READ_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getStatement

Statement getStatement() throws SQLException

Возвращает объект Statement, создавший этот объект ResultSet. Если набор результатов был создан другим способом, например методом DatabaseMetaData, этот метод может вернуть null.

Возвращает:: объект Statement, создавший этот объект ResultSet, или null, если набор результатов был создан другим способом
Исключения:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getObject

Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект Object в языке программирования Java. Если значение имеет тип SQL NULL, драйвер возвращает объект Java null. Этот метод использует заданный объект Map для пользовательского сопоставления извлекаемого структурированного или различимого типа SQL.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; map — объект java.util.Map, содержащий сопоставление имен типов SQL с классами языка программирования Java
Возвращает:: объект Object в языке программирования Java, представляющий значение SQL
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getRef

Ref getRef(int columnIndex) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект Ref в языке программирования Java.

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

getBlob

Blob getBlob(int columnIndex) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект Blob в языке программирования Java.

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

getClob

Clob getClob(int columnIndex) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект Clob в языке программирования Java.

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

getArray

Array getArray(int columnIndex) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект Array в языке программирования Java.

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

getObject

Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект Object в языке программирования Java. Если значение имеет тип SQL NULL, драйвер возвращает объект Java null. При необходимости этот метод использует указанный объект Map для пользовательского сопоставления.

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; map — объект java.util.Map, содержащий сопоставление имен типов SQL с классами языка программирования Java
Возвращает:: объект Object, представляющий значение SQL в указанном столбце
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getRef

Ref getRef(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: объект Ref, представляющий значение SQL REF в указанном столбце
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getBlob

Blob getBlob(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: объект Blob, представляющий значение SQL BLOB в указанном столбце
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getClob

Clob getClob(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: объект Clob, представляющий значение SQL CLOB в указанном столбце
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getArray

Array getArray(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: объект Array, представляющий значение SQL ARRAY в указанном столбце
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.2

getDate

Date getDate(int columnIndex, Calendar cal) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект java.sql.Date в языке программирования Java. Если базовая база данных не хранит сведения о часовом поясе, этот метод использует заданный календарь для вычисления подходящего значения даты в миллисекундах.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; cal — объект java.util.Calendar, используемый для создания даты
Возвращает:: значение столбца в виде объекта java.sql.Date; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getDate

Date getDate(String columnLabel, Calendar cal) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; cal — объект java.util.Calendar, используемый для создания даты
Возвращает:: значение столбца в виде объекта java.sql.Date; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getTime

Time getTime(int columnIndex, Calendar cal) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект java.sql.Time в языке программирования Java. Если базовая база данных не хранит сведения о часовом поясе, этот метод использует заданный календарь для вычисления подходящего значения времени в миллисекундах.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; cal — объект java.util.Calendar, используемый для создания времени
Возвращает:: значение столбца в виде объекта java.sql.Time; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getTime

Time getTime(String columnLabel, Calendar cal) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; cal — объект java.util.Calendar, используемый для создания времени
Возвращает:: значение столбца в виде объекта java.sql.Time; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getTimestamp

Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект java.sql.Timestamp в языке программирования Java. Если базовая база данных не хранит сведения о часовом поясе, этот метод использует заданный календарь для вычисления подходящего значения временной метки в миллисекундах.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; cal — объект java.util.Calendar, используемый для создания временной метки
Возвращает:: значение столбца в виде объекта java.sql.Timestamp; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getTimestamp

Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; cal — объект java.util.Calendar, используемый для создания даты
Возвращает:: значение столбца в виде объекта java.sql.Timestamp; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если метка столбца недопустима, произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Начиная с:: 1.2

getURL

URL getURL(int columnIndex) throws SQLException

Возвращает значение указанного столбца текущей строки этого объекта ResultSet как объект java.net.URL в языке программирования Java.

Параметры:: columnIndex — индекс столбца: 1 — первый, 2 — второй и т. д.
Возвращает:: значение столбца в виде объекта java.net.URL; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или URL имеет неверный формат; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

getURL

URL getURL(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
Возвращает:: значение столбца в виде объекта java.net.URL; если значение имеет тип SQL NULL, возвращаемое значение в языке программирования Java равно null
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или URL имеет неверный формат; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateRef

void updateRef(int columnIndex, Ref x) throws SQLException

Обновляет указанный столбец значением java.sql.Ref. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateRef

void updateRef(String columnLabel, Ref x) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; x — новое значение столбца
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateBlob

void updateBlob(int columnIndex, Blob x) throws SQLException

Обновляет указанный столбец значением java.sql.Blob. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateBlob

void updateBlob(String columnLabel, Blob x) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; x — новое значение столбца
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateClob

void updateClob(int columnIndex, Clob x) throws SQLException

Обновляет указанный столбец значением java.sql.Clob. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateClob

void updateClob(String columnLabel, Clob x) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; x — новое значение столбца
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateArray

void updateArray(int columnIndex, Array x) throws SQLException

Обновляет указанный столбец значением java.sql.Array. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; x — новое значение столбца
Исключения:: SQLException — если индекс столбца недопустим; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

updateArray

void updateArray(String columnLabel, Array x) throws SQLException

Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; x — новое значение столбца
Исключения:: SQLException — если метка столбца недопустима; произошла ошибка доступа к базе данных; параллелизм набора результатов равен CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

getRowId

RowId getRowId(int columnIndex) throws SQLException

Извлекает значение указанного столбца текущей строки этого объекта ResultSet в виде объекта java.sql.RowId на языке программирования Java.

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

getRowId

RowId getRowId(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца
Возвращает:: значение столбца; если это значение SQL NULL, возвращаемое значение — null
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateRowId

void updateRowId(int columnIndex, RowId x) throws SQLException

Обновляет указанный столбец значением RowId. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; x — значение столбца
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateRowId

void updateRowId(String columnLabel, RowId x) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; x — значение столбца
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

getHoldability

int getHoldability() throws SQLException

Возвращает режим сохранения этого объекта ResultSet

Возвращает:: либо ResultSet.HOLD_CURSORS_OVER_COMMIT, либо ResultSet.CLOSE_CURSORS_AT_COMMIT
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
С версии:: 1.6

isClosed

boolean isClosed() throws SQLException

Проверяет, был ли закрыт этот объект ResultSet. Объект ResultSet закрыт, если для него был вызван метод close или если он был закрыт автоматически.

Возвращает:: true, если этот объект ResultSet закрыт; false, если он всё ещё открыт
Выбрасывает:: SQLException — если произошла ошибка доступа к базе данных
С версии:: 1.6

updateNString

void updateNString(int columnIndex, String nString) throws SQLException

Обновляет указанный столбец значением String. Предназначен для обновления столбцов NCHAR, NVARCHAR и LONGNVARCHAR. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; nString — значение для обновляемого столбца
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если этот метод вызван для закрытого набора результатов; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateNString

void updateNString(String columnLabel, String nString) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; nString — значение для обновляемого столбца
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если этот метод вызван для закрытого набора результатов; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateNClob

void updateNClob(int columnIndex, NClob nClob) throws SQLException

Обновляет указанный столбец значением java.sql.NClob. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; nClob — значение для обновляемого столбца
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если этот метод вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateNClob

void updateNClob(String columnLabel, NClob nClob) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; nClob — значение для обновляемого столбца
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если этот метод вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

getNClob

NClob getNClob(int columnIndex) throws SQLException

Извлекает значение указанного столбца текущей строки этого объекта ResultSet в виде объекта NClob на языке программирования Java.

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

getNClob

NClob getNClob(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца
Возвращает:: объект NClob, представляющий значение SQL NCLOB в указанном столбце
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если этот метод вызван для закрытого набора результатов или если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

getSQLXML

SQLXML getSQLXML(int columnIndex) throws SQLException

Извлекает значение указанного столбца текущей строки этого объекта ResultSet в виде объекта java.sql.SQLXML на языке программирования Java.

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

getSQLXML

SQLXML getSQLXML(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца
Возвращает:: объект SQLXML, соответствующий значению SQL XML
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateSQLXML

void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException

Обновляет указанный столбец значением java.sql.SQLXML. Методы обновления используются для изменения значений столбцов в текущей строке или строке вставки. Методы обновления не изменяют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

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

updateSQLXML

void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; xmlObject — значение столбца
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных; если этот метод вызван для закрытого набора результатов; если java.xml.transform.Result, Writer или OutputStream не закрыт для объекта SQLXML; если при обработке значения XML произошла ошибка или конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY. Метод getCause исключения может предоставить более подробную информацию об исключении, например, если поток не содержит корректный XML.; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

getNString

String getNString(int columnIndex) throws SQLException

Извлекает значение указанного столбца текущей строки этого объекта ResultSet в виде String на языке программирования Java. Предназначен для доступа к столбцам NCHAR, NVARCHAR и LONGNVARCHAR.

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

getNString

String getNString(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца
Возвращает:: значение столбца; если значение — SQL NULL, возвращаемое значение — null
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

getNCharacterStream

Reader getNCharacterStream(int columnIndex) throws SQLException

Извлекает значение указанного столбца текущей строки этого объекта ResultSet в виде объекта java.io.Reader. Предназначен для доступа к столбцам NCHAR, NVARCHAR и LONGNVARCHAR.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...
Возвращает:: объект java.io.Reader, содержащий значение столбца; если значение — SQL NULL, возвращаемое значение — null на языке программирования Java.
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

getNCharacterStream

Reader getNCharacterStream(String columnLabel) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца
Возвращает:: объект java.io.Reader, содержащий значение столбца; если значение — SQL NULL, возвращаемое значение — null на языке программирования Java
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateNCharacterStream

void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException

Обновляет указанный столбец значением из символьного потока, содержащего указанное число байтов. Драйвер выполняет необходимое преобразование из символьного формата Java в национальный набор символов базы данных. Предназначен для обновления столбцов NCHAR, NVARCHAR и LONGNVARCHAR.

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

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; x — новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateNCharacterStream

void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; reader — объект java.io.Reader, содержащий новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateAsciiStream

void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException

Обновляет указанный столбец значением из потока ASCII, содержащего указанное число байтов.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; x — новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateBinaryStream

void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException

Обновляет указанный столбец значением из двоичного потока, содержащего указанное число байтов.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; x — новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateCharacterStream

void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException

Обновляет указанный столбец значением из символьного потока, содержащего указанное число байтов.

Параметры:: columnIndex — первый столбец имеет индекс 1, второй — 2, ...; x — новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnIndex недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateAsciiStream

void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException

Обновляет указанный столбец значением из потока ASCII, содержащего указанное число байтов.

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; x — новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateBinaryStream

void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException

Обновляет указанный столбец значением из двоичного потока, содержащего указанное число байтов.

Параметры:: columnLabel — метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не задано, меткой является имя столбца; x — новое значение столбца; length — длина потока
Выбрасывает:: SQLException — если значение columnLabel недопустимо; если произошла ошибка доступа к базе данных; если конкурентный доступ к набору результатов имеет режим CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
С версии:: 1.6

updateCharacterStream

void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException

Обновляет указанный столбец значением из символьного потока, содержащего указанное число байтов.

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

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

updateBlob

void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException

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

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

updateBlob

void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException

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

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

updateClob

void updateClob(int columnIndex, Reader reader, long length) throws SQLException

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

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

updateClob

void updateClob(String columnLabel, Reader reader, long length) throws SQLException

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

updateNClob

void updateNClob(int columnIndex, Reader reader, long length) throws SQLException

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

updateNClob

void updateNClob(String columnLabel, Reader reader, long length) throws SQLException

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

updateNCharacterStream

void updateNCharacterStream(int columnIndex, Reader x) throws SQLException

Обновляет указанный столбец значением из символьного потока. Данные будут считываться из потока по мере необходимости до достижения его конца. Драйвер выполняет необходимое преобразование из символьного формата Java в национальный набор символов базы данных. Метод предназначен для обновления столбцов NCHAR,NVARCHAR и LONGNVARCHAR.

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

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

updateNCharacterStream

void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException

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

updateAsciiStream

void updateAsciiStream(int columnIndex, InputStream x) throws SQLException

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

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

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

updateBinaryStream

void updateBinaryStream(int columnIndex, InputStream x) throws SQLException

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

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

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

updateCharacterStream

void updateCharacterStream(int columnIndex, Reader x) throws SQLException

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

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

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

updateAsciiStream

void updateAsciiStream(String columnLabel, InputStream x) throws SQLException

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

updateBinaryStream

void updateBinaryStream(String columnLabel, InputStream x) throws SQLException

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

updateCharacterStream

void updateCharacterStream(String columnLabel, Reader reader) throws SQLException

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

updateBlob

void updateBlob(int columnIndex, InputStream inputStream) throws SQLException

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

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

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

updateBlob

void updateBlob(String columnLabel, InputStream inputStream) throws SQLException

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

updateClob

void updateClob(int columnIndex, Reader reader) throws SQLException

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

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

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

updateClob

void updateClob(String columnLabel, Reader reader) throws SQLException

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

updateNClob

void updateNClob(int columnIndex, Reader reader) throws SQLException

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

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

updateNClob

void updateNClob(String columnLabel, Reader reader) throws SQLException

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

getObject

<T> T getObject(int columnIndex, Class<T> type) throws SQLException

Получает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует SQL-тип столбца в запрошенный тип данных Java, если такое преобразование поддерживается. Если преобразование не поддерживается или для типа указано значение null, выбрасывается SQLException.

Как минимум, реализация должна поддерживать преобразования, определённые в приложении B, таблице B-3, а также преобразование соответствующих пользовательских типов SQL в тип Java, реализующий SQLData или Struct. Могут поддерживаться и дополнительные преобразования, определяемые поставщиком.

Параметры типа:: T — тип класса, представленного этим объектом Class
Параметры:: columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.; type — класс, представляющий тип данных Java, в который следует преобразовать указанный столбец.
Возвращает:: экземпляр type, содержащий значение столбца
Выбрасывает:: SQLException — если преобразование не поддерживается, тип равен null или возникает другая ошибка. Метод getCause() исключения может предоставить более подробную информацию, например, если произошла ошибка преобразования; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.7

getObject

<T> T getObject(String columnLabel, Class<T> type) throws SQLException

Параметры типа:: T — тип класса, представленного этим объектом Class
Параметры:: columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца; type — класс, представляющий тип данных Java, в который следует преобразовать указанный столбец.
Возвращает:: экземпляр type, содержащий значение столбца
Выбрасывает:: SQLException — если преобразование не поддерживается, тип равен null или возникает другая ошибка. Метод getCause() исключения может предоставить более подробную информацию, например, если произошла ошибка преобразования; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с версии:: 1.7

updateObject

default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException

Обновляет указанный столбец значением Object. Методы обновления используются для обновления значений столбцов в текущей строке или в строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого для обновления базы данных вызываются методы updateRow или insertRow.

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

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException

Параметры:

columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.

x — новое значение столбца

targetSqlType — тип SQL, который будет передан базе данных

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

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

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

SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType

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

1.8

См. также:

updateObject

default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException

Параметры:

columnLabel — метка столбца, заданная предложением SQL AS. Если предложение SQL AS не указано, меткой является имя столбца

x — новое значение столбца

targetSqlType — тип SQL, который будет передан базе данных

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

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

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

1.8

См. также:

updateObject

default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException

Параметры:

columnIndex — первый столбец имеет номер 1, второй — 2 и т. д.

x — новое значение столбца

targetSqlType — тип SQL, который будет передан базе данных

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

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

1.8

См. также:

updateObject

default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException

Реализация по умолчанию выбрасывает SQLFeatureNotSupportedException

Параметры:

x — новое значение столбца

targetSqlType — тип SQL, который будет передан базе данных

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

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

1.8

См. также:

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