Spec-Zone.ru › OpenJDK 24

Интерфейс 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 предоставляет методы getter (getBoolean, getLong и так далее) для извлечения значений столбцов из текущей строки. Значения можно извлечь, используя либо номер индекса столбца, либо имя столбца. В общем случае использование индекса столбца будет более эффективным. Столбцы нумеруются с 1. Для максимальной переносимости столбцы набора результатов в каждой строке должны считываться слева направо, и каждый столбец должен считываться только один раз.

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

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

В API JDBC 2.0 (Java 2 SDK, Standard Edition, версия 1.2) были добавлены набор методов updater. Комментарии относительно параметров методов getter также применяются к параметрам методов updater.

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

  1. для обновления значения столбца в текущей строке. В прокручиваемом объекте 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
    
     
  2. для вставки значений столбцов в строку вставки. Обновляемый объект 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
См. также:
  • Statement.executeQuery(java.lang.String)
  • Statement.getResultSet()
  • ResultSetMetaData

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

Модификатор и тип Поле Описание
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.
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.
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.

Методы, объявленные в интерфейсе java.sql.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
См. также:
  • Значения константных полей

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

next

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 - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов

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.

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

getByte

byte getByte(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа byte языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getShort

short getShort(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа short языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getInt

int getInt(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа int языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getLong

long getLong(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа long языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getFloat

float getFloat(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа float языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getDouble

double getDouble(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа double языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getBigDecimal

@Deprecated(since="1.2") BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
Устарело.
Используйте getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве значения типа java.sql.BigDecimal языка программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
scale - количество цифр после десятичной точки
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод

getBytes

byte[] getBytes(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве массива byte на языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getDate

Date getDate(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Date на языке программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getTime

Time getTime(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Time на языке программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getTimestamp

Timestamp getTimestamp(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Timestamp на языке программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getAsciiStream

InputStream getAsciiStream(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока ASCII-символов. Значение можно затем считывать из потока частями. Этот метод особенно подходит для получения больших значений LONGVARCHAR. JDBC-драйвер выполнит необходимую конвертацию из формата базы данных в ASCII.

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

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

getUnicodeStream

@Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException
Устарело.
используйте getCharacterStream вместо getUnicodeStream
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока двухбайтных 3 символов. Первый байт — старший байт, второй байт — младший байт. Значение можно затем считывать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARCHAR. Драйвер JDBC выполнит все необходимые преобразования из формата базы данных в Unicode.

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

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

getBinaryStream

InputStream getBinaryStream(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока неинтерпретированных байтов. Значение можно затем считывать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARBINARY.

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

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

getString

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

getBoolean

boolean getBoolean(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как булево значение в языке программирования Java.

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

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

getByte

byte getByte(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как байт в языке программирования Java.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца
Возвращает:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Издает:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов

getShort

short getShort(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как целое число с коротким типом в языке программирования Java.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца
Возвращает:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Издает:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов

getInt

int getInt(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как целое число в языке программирования Java.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца
Возвращает:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Издает:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов

getLong

long getLong(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как целое число с длинной точностью в языке программирования Java.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца
Возвращает:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Издает:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов

getFloat

float getFloat(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как число с плавающей точкой в языке программирования Java.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца
Возвращает:
значение столбца; если значение является SQL NULL, возвращаемое значение равно 0
Издает:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов

getDouble

double getDouble(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как число с двойной точностью в языке программирования Java.
Параметры:
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.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца
scale - количество цифр справа от десятичной точки
Возвращает:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Издает:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

getBytes

byte[] getBytes(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде массива byte в языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.
Parameters:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение является null
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getDate

Date getDate(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде объекта java.sql.Date в языке программирования Java.
Parameters:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение является null
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getTime

Time getTime(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде объекта java.sql.Time в языке программирования Java.
Parameters:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение является null
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getTimestamp

Timestamp getTimestamp(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде объекта java.sql.Timestamp в языке программирования Java.
Parameters:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение является null
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getAsciiStream

InputStream getAsciiStream(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде потока ASCII-символов. Значение затем можно читать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARCHAR. Драйвер JDBC выполнит необходимое преобразование из формата базы данных в ASCII.

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

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

getUnicodeStream

@Deprecated(since="1.2") InputStream getUnicodeStream(String columnLabel) throws SQLException
Устарело.
используйте getCharacterStream вместо этого
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде потока символов Unicode с двумя байтами. Первый байт — старший байт; второй байт — младший байт. Значение затем можно читать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARCHAR. Драйвер, поддерживающий JDBC, выполнит необходимое преобразование из формата базы данных в Unicode.

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

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

getBinaryStream

InputStream getBinaryStream(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта в виде потока неинтерпретированных byte. Значение затем можно читать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARBINARY.

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

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

getWarnings

SQLWarning getWarnings() throws SQLException
Извлекает первое предупреждение, сообщённое вызовами этого ResultSet объекта. Последующие предупреждения об этом ResultSet объекте будут присоединены к объекту SQLWarning, который возвращает этот метод.

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

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

Returns:
первый объект SQLWarning, сообщённый, или null, если их нет
Throws:
SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

clearWarnings

void clearWarnings() throws SQLException
Очищает все предупреждения, сообщённые этим ResultSet объектом. После вызова этого метода метод getWarnings возвращает null до тех пор, пока не будет сообщено новое предупреждение для этого ResultSet объекта.
Throws:
SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов

getCursorName

String getCursorName() throws SQLException
Возвращает имя SQL-курсора, используемого этим ResultSet объектом.

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

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

Returns:
SQL-имя курсора объекта ResultSet
Throws:
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, то при столбце со структурированным или distinct значением, поведение этого метода такое же, как и вызов: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()). Если Connection.getTypeMap вызывает SQLFeatureNotSupportedException, то структурированные значения не поддерживаются, а distinct значения отображаются в стандартный Java-класс, определяемый типом SQL DISTINCT.

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

getObject

Object getObject(String columnLabel) throws SQLException

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

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

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

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

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

findColumn

int findColumn(String columnLabel) throws SQLException
Сопоставляет заданное имя столбца ResultSet с его индексом столбца ResultSet.
Параметры:
columnLabel - имя столбца, указанное в SQL-оператор AS. Если опреатор AS не указан, именем столбца является имя столбца.
Возвращает:
индекс столбца данного имени столбца
Выбрасывает:
SQLException - если объект ResultSet не содержит столбец с именем columnLabel, произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов

getCharacterStream

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

getCharacterStream

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

getBigDecimal

BigDecimal getBigDecimal(int columnIndex) throws SQLException
Получает значение указанного столбца в текущей строке объекта ResultSet в виде java.math.BigDecimal с полной точностью.
Параметры:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Возвращает:
значение столбца (полная точность); если значение является SQL NULL, возвращается значение типа null языка программирования Java.
Выбрасывает:
SQLException - если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
Since:
1.2

getBigDecimal

BigDecimal getBigDecimal(String columnLabel) throws SQLException
Получает значение указанного столбца в текущей строке объекта ResultSet в виде java.math.BigDecimal с полной точностью.
Параметры:
columnLabel - имя столбца, указанное в SQL-оператор AS. Если опреатор AS не указан, именем столбца является имя столбца.
Возвращает:
значение столбца (полная точность); если значение является SQL NULL, возвращается значение типа null языка программирования Java.
Выбрасывает:
SQLException - если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
Since:
1.2

isBeforeFirst

boolean isBeforeFirst() throws SQLException
Определяет, находится ли курсор перед первой строкой в этом объекте ResultSet.

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

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

isAfterLast

boolean isAfterLast() throws SQLException
Определяет, находится ли курсор после последней строки в этом объекте ResultSet.

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

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

isFirst

boolean isFirst() throws SQLException
Определяет, находится ли курсор на первой строке в этом объекте ResultSet.

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

Возвращает:
true, если курсор на первой строке; false, в противном случае
Выбрасывает:
SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
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 - целое число, определяющее количество строк для перемещения от текущей строки; положительное число перемещает курсор вперед; отрицательное число перемещает курсор назад
Возвращает:
true, если курсор находится на строке; false в противном случае
Исключение:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

previous

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 - целое число, указывающее рекомендуемое направление выборки; одно из значений ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE или ResultSet.FETCH_UNKNOWN
Исключение:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY, и направление выборки не является FETCH_FORWARD
С:
1.2
См. также:
  • Statement.setFetchDirection(int)
  • getFetchDirection()

getFetchDirection

int getFetchDirection() throws SQLException
Получает направление выборки для этого объекта ResultSet.
Возвращает:
текущее направление выборки для этого объекта ResultSet
Исключение:
SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
С:
1.2
См. также:
  • setFetchDirection(int)

setFetchSize

void setFetchSize(int rows) throws SQLException
Даёт JDBC драйверу подсказку о количестве строк, которое следует извлечь из базы данных, когда для этого ResultSet объекта требуются дополнительные строки. Если указанный размер выборки равен нулю, JDBC драйвер игнорирует значение и свободен сам сделать лучшее предположение о том, каким должен быть размер выборки. Значение по умолчанию устанавливается объектом Statement, который создал набор результатов. Размер выборки может быть изменён в любое время.
Параметры:
rows - количество строк для извлечения
Исключения:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или условие rows >= 0 не выполняется
С:
1.2
См. также:
  • getFetchSize()

getFetchSize

int getFetchSize() throws SQLException
Возвращает размер выборки для этого ResultSet объекта.
Возвращает:
текущий размер выборки для этого ResultSet объекта
Исключения:
SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
С:
1.2
См. также:
  • setFetchSize(int)

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 в противном случае
Исключения:
SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:
1.2
См. также:
  • DatabaseMetaData.updatesAreDetected(int)

rowInserted

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

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

Возвращает:
true, если текущая строка была вставлена; false в противном случае
Исключения:
SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:
1.2
См. также:
  • DatabaseMetaData.insertsAreDetected(int)

rowDeleted

boolean rowDeleted() throws SQLException
Возвращает, была ли строка удалена. Удалённая строка может оставить видимую "дыру" в наборе результатов. Этот метод можно использовать для обнаружения дыр в наборе результатов. Возвращаемое значение зависит от того, может ли этот ResultSet объект обнаруживать удаления.

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

Возвращает:
true, если текущая строка была удалена владельцем или другим; false в противном случае
Исключения:
SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:
1.2
См. также:
  • DatabaseMetaData.deletesAreDetected(int)

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
END_OF_DOCUMENT_MARKER

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 для обновления базы данных.
Parameters:
columnIndex - первый столбец имеет значение 1, второй - 2 и т.д.
x - новое значение столбца
length - длина потока
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateObject

void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
Обновляет указанный столбец значением типа Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.

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

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

updateObject

void updateObject(int columnIndex, Object x) throws SQLException
Обновляет указанный столбец значением типа Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnIndex - первый столбец имеет значение 1, второй - 2 и т.д.
x - новое значение столбца
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateNull

void updateNull(String columnLabel) throws SQLException
Обновляет указанный столбец значением null. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateBoolean

void updateBoolean(String columnLabel, boolean x) throws SQLException
Обновляет указанный столбец значением типа boolean. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateByte

void updateByte(String columnLabel, byte x) throws SQLException
Обновляет указанный столбец значением типа byte. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateShort

void updateShort(String columnLabel, short x) throws SQLException
Обновляет указанный столбец значением типа short. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateInt

void updateInt(String columnLabel, int x) throws SQLException
Обновляет указанный столбец значением типа int. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateLong

void updateLong(String columnLabel, long x) throws SQLException
Обновляет указанный столбец значением типа long. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов - CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

обновитьВещественное

void updateFloat(String columnLabel, float x) throws SQLException
Обновляет указанный столбец значением типа float. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьДвойное

void updateDouble(String columnLabel, double x) throws SQLException
Обновляет указанный столбец значением типа double. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьBigDecimal

void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
Обновляет указанный столбец значением типа BigDecimal. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьСтроку

void updateString(String columnLabel, String x) throws SQLException
Обновляет указанный столбец значением типа String. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьБайты

void updateBytes(String columnLabel, byte[] x) throws SQLException
Обновляет указанный столбец значением типа byte array. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьДату

void updateDate(String columnLabel, Date x) throws SQLException
Обновляет указанный столбец значением типа Date. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьВремя

void updateTime(String columnLabel, Time x) throws SQLException
Обновляет указанный столбец значением типа Time. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьМаркерВремени

void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
Обновляет указанный столбец значением типа Timestamp. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

обновитьПотокAscii

void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
Обновляет указанный столбец значением типа ascii stream, которое будет содержать указанное количество байт. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
length - длина потока
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

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

void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
Обновляет указанный столбец значением типа binary stream, которое будет содержать указанное количество байт. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца
x - новое значение столбца
length - длина потока
Исключения:
SQLException - если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов является CONCUR_READ_ONLY или этот метод вызван на закрытом наборе результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
С:
1.2

updateCharacterStream

void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException
Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байт. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца
reader - объект java.io.Reader, содержащий новое значение столбца
length - длина потока
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатов является CONCUR_READ_ONLY или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateObject

void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException
Обновляет указанный столбец значением типа Object. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.

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

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

updateObject

void updateObject(String columnLabel, Object x) throws SQLException
Обновляет указанный столбец значением типа Object. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатов является CONCUR_READ_ONLY или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

insertRow

void insertRow() throws SQLException
Вставляет содержимое строки вставки в этот объект ResultSet и в базу данных. Курсор должен находиться на строке вставки при вызове этого метода.
Throws:
SQLException - если произошла ошибка доступа к базе данных; конвейер набора результатов является CONCUR_READ_ONLY, этот метод вызывается для закрытого набора результатов, если этот метод вызывается, когда курсор не находится на строке вставки, или если не все столбцы, не допускающие NULL, в строке вставки не получили значение не NULL
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

updateRow

void updateRow() throws SQLException
Обновляет базу данных новым содержимым текущей строки объекта ResultSet. Этот метод не может быть вызван, когда курсор находится на строке вставки.
Throws:
SQLException - если произошла ошибка доступа к базе данных; конвейер набора результатов является CONCUR_READ_ONLY; этот метод вызывается для закрытого набора результатов или если этот метод вызывается, когда курсор находится на строке вставки
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

deleteRow

void deleteRow() throws SQLException
Удаляет текущую строку из объекта ResultSet и из базы данных. Этот метод не может быть вызван, когда курсор находится на строке вставки.
Throws:
SQLException - если произошла ошибка доступа к базе данных; конвейер набора результатов является CONCUR_READ_ONLY; этот метод вызывается для закрытого набора результатов или если этот метод вызывается, когда курсор находится на строке вставки
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

refreshRow

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

Метод refreshRow предоставляет способ, чтобы приложение явно сообщило драйверу JDBC о необходимости повторного извлечения строки(ок) из базы данных. Приложение может вызвать refreshRow при кешировании или предварительном извлечении, выполняемом драйвером JDBC, для извлечения последнего значения строки из базы данных. Драйвер JDBC может фактически обновить сразу несколько строк, если размер извлечения больше единицы.

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

Throws:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов; тип набора результатов является TYPE_FORWARD_ONLY или если этот метод вызывается, когда курсор находится на строке вставки
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод или этот метод не поддерживается для указанного типа и конвейера набора результатов.
Since:
1.2

cancelRowUpdates

void cancelRowUpdates() throws SQLException
Отменяет обновления, внесенные в текущую строку в этом объекте ResultSet. Этот метод может быть вызван после вызова метода обновлителя(ей) и перед вызовом метода updateRow, чтобы откатить внесенные в строку изменения. Если не было сделано обновлений или updateRow уже был вызван, этот метод не окажет никакого влияния.
Throws:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов; конвейер набора результатов является CONCUR_READ_ONLY или если этот метод вызывается, когда курсор находится на строке вставки
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

moveToInsertRow

void moveToInsertRow() throws SQLException
Перемещает курсор в строку вставки. Текущая позиция курсора запоминается, пока курсор находится в строке вставки. Строка вставки — это специальная строка, связанная с обновляемым набором результатов. Это по сути буфер, где может быть построена новая строка путем вызова методов обновлителя перед вставкой строки в набор результатов. Когда курсор находится в строке вставки, могут вызываться только методы обновлителя, getter и insertRow. Все столбцы в наборе результатов должны получить значение каждый раз, когда вызывается этот метод, прежде чем вызывать insertRow. Метод обновлителя должен быть вызван перед тем, как можно будет вызвать метод getter для значения столбца.
Throws:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или конвейер набора результатов является CONCUR_READ_ONLY
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

moveToCurrentRow

void moveToCurrentRow() throws SQLException
Перемещает курсор в сохраненную позицию курсора, обычно в текущую строку. Этот метод не оказывает никакого влияния, если курсор не находится в строке вставки.
Throws:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или конвейер набора результатов является CONCUR_READ_ONLY
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

getStatement

Statement getStatement() throws SQLException
Возвращает объект Statement, который произвел этот объект ResultSet. Если набор результатов сгенерирован каким-то другим способом, например, методом DatabaseMetaData, этот метод может вернуть null.
Returns:
объект Statement, который произвел этот объект ResultSet или null, если набор результатов был получен другим способом
Throws:
SQLException - если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
Since:
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 - если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает данный метод
С:
1.2

getRef

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

getBlob

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

getClob

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

getArray

Array getArray(int columnIndex) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта как объект Array в языке программирования Java.
Параметры:
columnIndex - первый столбец — 1, второй — 2 и т. д.
Возвращает:
объект Array, представляющий значение SQL ARRAY в указанном столбце
Исключение:
SQLException - если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
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 - если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает данный метод
С:
1.2

getRef

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

getBlob

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

getClob

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

getArray

Array getArray(String columnLabel) throws SQLException
Извлекает значение указанного столбца в текущей строке этого ResultSet объекта как объект Array в языке программирования Java.
Параметры:
columnLabel - метка столбца, указанная с помощью SQL-запроса AS. Если SQL-запрос AS не был указан, метка — это имя столбца
Возвращает:
объект Array, представляющий значение SQL ARRAY в указанном столбце
Исключение:
SQLException - если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
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, возвращаемое значение — null в языке программирования Java
Исключение:
SQLException - если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
С:
1.2
END_OF_DOCUMENT_MARKER

getDate

Date getDate(String columnLabel, Calendar cal) throws SQLException
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Date языка программирования Java. Этот метод использует предоставленный календарь для построения соответствующего значения в миллисекундах для даты, если базовая база данных не хранит информацию о часовом поясе.
Параметры:
columnLabel - метка столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца
cal - объект java.util.Calendar, используемый для построения даты
Возвращает:
значение столбца в виде объекта java.sql.Date; если значение является SQL NULL, возвращаемое значение — null на языке программирования Java
Исключение:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
С:
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, возвращаемое значение — null на языке программирования Java
Исключение:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
С:
1.2

getTime

Time getTime(String columnLabel, Calendar cal) throws SQLException
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Time языка программирования Java. Этот метод использует предоставленный календарь для построения соответствующего значения в миллисекундах для времени, если базовая база данных не хранит информацию о часовом поясе.
Параметры:
columnLabel - метка столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца
cal - объект java.util.Calendar, используемый для построения времени
Возвращает:
значение столбца в виде объекта java.sql.Time; если значение является SQL NULL, возвращаемое значение — null на языке программирования Java
Исключение:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
С:
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, возвращаемое значение — null на языке программирования Java
Исключение:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
С:
1.2

getTimestamp

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

getURL

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

getURL

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

updateRef

void updateRef(int columnIndex, Ref x) throws SQLException
Обновляет указанный столбец значением java.sql.Ref. Методы обновляющего элемента используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего элемента не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnIndex - первый столбец — 1, второй — 2 и т. д.
x - новое значение столбца
Исключение:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов — CONCUR_READ_ONLY или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:
1.4

updateRef

void updateRef(String columnLabel, Ref x) throws SQLException
Обновляет указанный столбец значением java.sql.Ref. Методы обновляющего элемента используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего элемента не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца
x - новое значение столбца
Исключение:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов — 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 - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов — CONCUR_READ_ONLY или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:
1.4

updateBlob

void updateBlob(String columnLabel, Blob x) throws SQLException
Обновляет указанный столбец значением типа java.sql.Blob. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.4

updateClob

void updateClob(int columnIndex, Clob x) throws SQLException
Обновляет указанный столбец значением типа java.sql.Clob. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnIndex - первый столбец — 1, второй — 2 и т. д.
x - новое значение столбца
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.4

updateClob

void updateClob(String columnLabel, Clob x) throws SQLException
Обновляет указанный столбец значением типа java.sql.Clob. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.4

updateArray

void updateArray(int columnIndex, Array x) throws SQLException
Обновляет указанный столбец значением типа java.sql.Array. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnIndex - первый столбец — 1, второй — 2 и т. д.
x - новое значение столбца
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.4

updateArray

void updateArray(String columnLabel, Array x) throws SQLException
Обновляет указанный столбец значением типа java.sql.Array. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
x - новое значение столбца
Throws:
SQLException - если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.4

getRowId

RowId getRowId(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.RowId в языке программирования Java.
Parameters:
columnIndex - первый столбец — 1, второй — 2 и т. д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение — null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.6

getRowId

RowId getRowId(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.RowId в языке программирования Java.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение — null
Throws:
SQLException - если columnLabel недействительно; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.6

updateRowId

void updateRowId(int columnIndex, RowId x) throws SQLException
Обновляет указанный столбец значением типа RowId. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnIndex - первый столбец — 1, второй — 2 и т. д.
x - значение столбца
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.6

updateRowId

void updateRowId(String columnLabel, RowId x) throws SQLException
Обновляет указанный столбец значением типа RowId. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
x - значение столбца
Throws:
SQLException - если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов является CONCUR_READ_ONLY или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
1.6

getHoldability

int getHoldability() throws SQLException
Возвращает holdability этого объекта ResultSet
Returns:
либо ResultSet.HOLD_CURSORS_OVER_COMMIT, либо ResultSet.CLOSE_CURSORS_AT_COMMIT
Throws:
SQLException - если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
Since:
1.6

isClosed

boolean isClosed() throws SQLException
Возвращает, закрыт ли этот объект ResultSet. Объект ResultSet закрыт, если на нем вызван метод close или он закрывается автоматически.
Returns:
true, если объект ResultSet закрыт; false, если он открыт
Throws:
SQLException - если произошла ошибка доступа к базе данных
Since:
1.6
END_OF_DOCUMENT_MARKER

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
Обновляет указанный столбец значением типа String. Предназначено для обновления столбцов NCHAR,NVARCHAR и LONGNVARCHAR. Методы-обновлятели используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновлятели не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
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
Обновляет указанный столбец значением типа java.sql.NClob. Методы-обновлятели используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновлятели не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
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
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта NClob языка программирования Java.
Параметры:
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
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.SQLXML языка программирования Java.
Параметры:
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
Обновляет указанный столбец значением типа java.sql.SQLXML. Методы обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
xmlObject - значение столбца
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов; java.xml.transform.Result, Writer или OutputStream не были закрыты для объекта SQLXML; если произошла ошибка обработки значения XML или конкурентность набора результатов CONCUR_READ_ONLY. Метод getCause исключения может предоставить более подробное исключение, например, если поток не содержит допустимого XML.
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.6

getNString

String getNString(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде строки String языка программирования Java. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
Parameters:
columnIndex - первый столбец — 1, второй — 2 и т. д.
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение — null
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.6

getNString

String getNString(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде строки String языка программирования Java. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение — null
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.6

getNCharacterStream

Reader getNCharacterStream(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.io.Reader. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
Parameters:
columnIndex - первый столбец — 1, второй — 2 и т. д.
Returns:
объект java.io.Reader, содержащий значение столбца; если значение является SQL NULL, возвращаемое значение — null на языке программирования Java.
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.6

getNCharacterStream

Reader getNCharacterStream(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.io.Reader. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца
Returns:
объект java.io.Reader, содержащий значение столбца; если значение является SQL NULL, возвращаемое значение — null на языке программирования Java
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.6

updateNCharacterStream

void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
Обновляет указанный столбец значением потока символов, длина которого задана. Драйвер выполняет необходимую конвертацию из формата символов Java в национальный набор символов базы данных. Предназначено для обновления столбцов типа NCHAR, NVARCHAR и LONGNVARCHAR.

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

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

updateNCharacterStream

void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
Обновляет указанный столбец значением потока символов, длина которого задана. Драйвер выполняет необходимую конвертацию из формата символов Java в национальный набор символов базы данных. Предназначено для обновления столбцов типа NCHAR, NVARCHAR и LONGNVARCHAR.

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

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

updateAsciiStream

void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
Обновляет указанный столбец значением потока ASCII, длина которого задана.

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

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

updateBinaryStream

void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
Обновляет указанный столбец значением потока двоичных данных, длина которого задана.

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

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

updateCharacterStream

void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
Обновляет указанный столбец значением потока символов, длина которого будет указана в байтах.

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

Параметры:
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, длина которого будет указана в байтах.

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

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

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

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

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

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

updateBlob

void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
Обновляет указанный столбец с использованием предоставленного входного потока, длина которого будет указана в байтах.

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

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

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

Параметры:
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, длина которого равна указанному количеству символов. При вводе очень больших значений UNICODE в параметр LONGVARCHAR может быть удобнее передать их через объект java.io.Reader. JDBC-драйвер выполнит необходимую конвертацию из UNICODE в формат символов базы данных.

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

Параметры:
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
Обновляет указанный столбец с использованием предоставленного объекта Reader, длина которого равна указанному количеству символов. При вводе очень больших значений UNICODE в параметр LONGVARCHAR может быть удобнее передать их через объект java.io.Reader. JDBC-драйвер выполнит необходимую конвертацию из UNICODE в формат символов базы данных.

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

Параметры:
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
Обновляет указанный столбец с помощью заданного объекта Reader, длина которого равна заданному числу символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более целесообразно отправить его через объект java.io.Reader. Драйвер JDBC выполнит все необходимые преобразования из UNICODE в формат символов базы данных.

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

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

updateNClob

void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
Обновляет указанный столбец с помощью заданного объекта Reader, длина которого равна заданному числу символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более целесообразно отправить его через объект java.io.Reader. Драйвер JDBC выполнит все необходимые преобразования из UNICODE в формат символов базы данных.

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

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

updateNCharacterStream

void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока. Драйвер выполняет необходимое преобразование из формата символов Java в национальный набор символов базы данных. Он предназначен для обновления столбцов NCHAR, NVARCHAR и LONGNVARCHAR.

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

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

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

updateNCharacterStream

void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException
Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока. Драйвер выполняет необходимое преобразование из формата символов Java в национальный набор символов базы данных. Он предназначен для обновления столбцов NCHAR, NVARCHAR и LONGNVARCHAR.

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

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

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

updateAsciiStream

void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
Обновляет указанный столбец значением потока ASCII. Данные будут читаться из потока по мере необходимости до достижения конца потока.

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

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

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

updateBinaryStream

void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
Обновляет указанный столбец значением двоичного потока. Данные будут читаться из потока по мере необходимости до достижения конца потока.

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

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

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

updateCharacterStream

void updateCharacterStream(int columnIndex, Reader x) throws SQLException
Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока.

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

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

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

updateAsciiStream

void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
Обновляет указанный столбец значением потока ASCII. Данные будут считываться из потока по мере необходимости до достижения конца потока.

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

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

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

updateBinaryStream

void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
Обновляет указанный столбец значением двоичного потока. Данные будут считываться из потока по мере необходимости до достижения конца потока.

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

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

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

updateCharacterStream

void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
Обновляет указанный столбец значением потока символов. Данные будут считываться из потока по мере необходимости до достижения конца потока.

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

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

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

updateBlob

void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
Обновляет указанный столбец с помощью заданного входного потока. Данные будут считываться из потока по мере необходимости до достижения конца потока.

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

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

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

updateBlob

void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
Обновляет указанный столбец с помощью заданного входного потока. Данные будут считываться из потока по мере необходимости до достижения конца потока.

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

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

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

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

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

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

updateClob

void updateClob(String columnLabel, Reader reader) throws SQLException
Обновляет указанный столбец, используя заданный объект Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.

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

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

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

updateNClob

void updateNClob(int columnIndex, Reader reader) throws SQLException
Обновляет указанный столбец, используя заданный Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.

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

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

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

updateNClob

void updateNClob(String columnLabel, Reader reader) throws SQLException
Обновляет указанный столбец, используя предоставленный объект Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимую конвертацию из UNICODE в формат символов базы данных.

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

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

Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца
reader - объект, содержащий данные для установки значения параметра.
Throws:
SQLException - если columnLabel недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить, что может произойти ошибка преобразования данных; этот метод вызывается для закрытого набора результатов; если возникает ошибка доступа к базе данных или конкурентность набора результатов является CONCUR_READ_ONLY
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
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. Дополнительные преобразования могут поддерживаться и определяются поставщиком.

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

getObject

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

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

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

Type Parameters:
T - тип класса, моделируемого этим объектом Class
Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца
type - класс, представляющий тип данных Java, в который нужно преобразовать указанный столбец.
Returns:
экземпляр type, содержащий значение столбца
Throws:
SQLException - если преобразование не поддерживается, тип null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
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

Parameters:
columnIndex - номер столбца (первый - 1, второй - 2 и т.д.).
x - новое значение столбца.
targetSqlType - SQL тип, который будет отправлен в базу данных.
scaleOrLength - для объектов типа java.math.BigDecimal, это число знаков после запятой. Для типов Java-объектов InputStream и Reader, это длина данных в потоке или ридере. Для всех остальных типов, это значение игнорируется.
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов является CONCUR_READ_ONLY или метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType
Since:
1.8
See Also:
  • JDBCType
  • SQLType

updateObject

default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
Обновляет указанный столбец значением типа Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.

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

По умолчанию, реализация будет выбрасывать исключение SQLFeatureNotSupportedException

Parameters:
columnLabel - метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца
x - новое значение столбца.
targetSqlType - SQL тип, который будет отправлен в базу данных.
scaleOrLength - для объектов типа java.math.BigDecimal, это число знаков после запятой. Для типов Java-объектов InputStream и Reader, это длина данных в потоке или ридере. Для всех остальных типов, это значение игнорируется.
Throws:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов является CONCUR_READ_ONLY или метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType
Since:
1.8
See Also:
  • JDBCType
  • SQLType

updateObject

default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException
Обновляет указанный столбец значением типа Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.

По умолчанию, реализация будет выбрасывать исключение SQLFeatureNotSupportedException

Parameters:
columnIndex - номер столбца (первый - 1, второй - 2 и т.д.).
x - новое значение столбца.
targetSqlType - SQL тип, который будет отправлен в базу данных.
Throws:
SQLException - если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов является CONCUR_READ_ONLY или метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType
Since:
1.8
See Also:
  • JDBCType
  • SQLType

updateObject

default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException
Обновляет указанный столбец значением Object. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.

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

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

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API