Spec-Zone.ru › OpenJDK 21

Интерфейс 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 с этим свойством holdability будут закрыты при подтверждении текущей транзакции.
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 с этим свойством holdability останутся открытыми при подтверждении текущей транзакции.
static final int TYPE_FORWARD_ONLY
Константа, указывающая тип для объекта ResultSet, курсор которого может перемещаться только вперед.
static final int TYPE_SCROLL_INSENSITIVE
Константа, указывающая тип для объекта ResultSet, который прокручиваемый, но обычно нечувствителен к изменениям данных, на которых основан ResultSet.
static final int TYPE_SCROLL_SENSITIVE
Константа, указывающая тип для объекта ResultSet, который прокручиваемый и, как правило, чувствителен к изменениям данных, на которых основан ResultSet.

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

Modifier and Type Method Description
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.

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

getByte

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

getShort

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

getInt

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

getLong

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

getFloat

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

getDouble

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

getBytes

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

getDate

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

getTime

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

getTimestamp

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

getAsciiStream

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

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

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

getUnicodeStream

@Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException
Устарело.
используйте getCharacterStream вместо getUnicodeStream
Возвращает значение указанного столбца в текущей строке этого ResultSet объекта в виде потока символов Unicode. Первый байт - старший байт, второй - младший байт. Значение затем может быть считывается из потока частями. Этот метод особенно подходит для извлечения больших 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, независимо от наличия данных.

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

getString

String getString(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого ResultSet объекта в виде строкового значения в языке программирования Java.
Parameters:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца
Returns:
значение столбца; если значение является SQL NULL, возвращаемое значение равно null
Throws:
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.

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

getByte

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

getShort

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

getInt

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

getLong

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

getFloat

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

getDouble

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

getBigDecimal

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

getBytes

byte[] getBytes(String columnLabel) throws SQLException
Возвращает значение указанного столбца в текущей строке этого ResultSet объекта в виде массива байтов в языке программирования 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
Deprecated.
используйте 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 таблица результатов извлекается через именованный курсор. Текущую строку набора результатов можно обновлять или удалять с помощью операторов positioned update/delete, которые ссылаются на имя курсора. Чтобы убедиться, что курсор имеет соответствующий уровень изоляции для поддержки обновления, оператор курсора SELECT должен иметь вид 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.
Returns:
описание столбцов этого объекта ResultSet
Throws:
SQLException - если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов

getObject

Object getObject(int columnIndex) throws SQLException

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

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

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

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

Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т.д.
Returns:
объект java.lang.Object, содержащий значение столбца
Throws:
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 типов, определённых пользователем. Когда столбец содержит структурированное или раздельное значение, поведение этого метода такое же, как при вызове: getObject(columnIndex, this.getStatement().getConnection().getTypeMap()).

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

findColumn

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

getCharacterStream

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

getCharacterStream

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

getBigDecimal

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

getBigDecimal

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

isBeforeFirst

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

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

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

isAfterLast

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

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

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

isFirst

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

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

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

isLast

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

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

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

beforeFirst

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

afterLast

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

first

boolean first() throws SQLException
Перемещает курсор на первую строку в этом ResultSet объекте.
Returns:
true, если курсор находится на корректной строке; false если в наборе результатов нет строк
Throws:
SQLException - если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или тип набора результатов — TYPE_FORWARD_ONLY
SQLFeatureNotSupportedException - если JDBC-драйвер не поддерживает этот метод
Since:
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

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

Обновить строку

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

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

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

Обновить дату

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

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

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

Обновить метку времени

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

Обновить поток ASCII

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

Обновить двоичный поток

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

Обновить символьный поток

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

Обновить объект

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

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

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

Обновить объект

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

updateFloat

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

updateDouble

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

updateBigDecimal

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

updateString

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

updateBytes

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

updateDate

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

updateTime

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

updateTimestamp

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

updateAsciiStream

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

updateBinaryStream

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

updateCharacterStream

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

updateObject

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

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

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

updateObject

void updateObject(String columnLabel, Object x) throws SQLException
Обновляет значение указанного столбца значением типа Object. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Параметры:
columnLabel - метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, меткой является имя столбца
x - новое значение столбца
Исключения:
SQLException - если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатов CONCUR_READ_ONLY или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С момента:
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
Перемещает курсор в строку вставки. Текущее положение курсора запоминается, пока курсор находится в строке вставки. Строка вставки — это специальная строка, связанная с обновляемым набором результатов. По сути, это буфер, где новая строка может быть создана путём вызова методов обновления до вставки строки в набор результатов. Только методы обновления, извлечения и insertRow могут быть вызваны, когда курсор находится на строке вставки. Все столбцы в наборе результатов должны получить значение каждый раз при вызове этого метода перед вызовом insertRow. Метод обновления должен быть вызван перед вызовом метода извлечения для значения столбца.
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 структурированным типом, драйвер возвращает Java объект null. Этот метод использует предоставленный объект Map для пользовательского сопоставления SQL структурированного или отличительного типа, который извлекается.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй — 2 и так далее
map - объект java.util.Map, содержащий сопоставление имён SQL типов с классами в языке программирования Java
Returns:
объект Object в языке программирования Java, представляющий значение SQL
Throws:
SQLException - если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод
Since:
1.2

getRef

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

getBlob

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

getClob

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

getArray

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

getObject

Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта языка программирования 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

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

updateClob

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

updateClob

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

updateArray

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

updateArray

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

updateNString

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

updateNString

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

updateNClob

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

updateNClob

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

getNClob

NClob getNClob(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого ResultSet объекта в виде объекта NClob на языке программирования Java.
Parameters:
columnIndex - первый столбец имеет индекс 1, второй - 2 и т. д.
Returns:
объект NClob, представляющий значение SQL NCLOB в указанном столбце
Throws:
SQLException - если columnIndex некорректен; если драйвер не поддерживает наборы национальных символов; если драйвер обнаруживает ошибку преобразования данных; этот метод вызван для закрытого набора результатов или если произошла ошибка доступа к базе данных
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
Since:
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 для обновления базы данных.
Параметры:
columnLabel - метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца
xmlObject - значение столбца
Исключения:
SQLException - если columnLabel некорректен; если произошла ошибка доступа к базе данных; этот метод был вызван для закрытого набора результатов; java.xml.transform.Result, Writer или OutputStream не был закрыт для объекта SQLXML; если произошла ошибка обработки значения XML или конкурентность набора результатов — CONCUR_READ_ONLY. Метод getCause исключения может предоставить более подробное исключение, например, если поток не содержит корректного XML.
SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод
С:
1.6

getNString

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

getNString

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

getNCharacterStream

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

getNCharacterStream

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

updateNCharacterStream

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

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

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

обновитьПотокNСимволов

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

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

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

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

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

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

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

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

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

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

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

обновитьПотокСимволов

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

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

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

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

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

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

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

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

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

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

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

обновитьПотокСимволов

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

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

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

обновитьBLOB

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

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

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

обновитьBLOB

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

Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы 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 в формат символов базы данных.

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

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

updateClob

void updateClob(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

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 - объект, содержащий новое значение столбца
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

Обновить двоичный поток

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

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

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

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

Обновить текстовый поток

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

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

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

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

Обновить поток ASCII

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

Обновить двоичный поток

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

Обновить текстовый поток

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

Обновить BLOB

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

Обновить BLOB

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

Обновить CLOB

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

обновитьClob

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

обновитьNClob

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

обновитьNClob

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

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

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

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

получитьОбъект

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

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

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

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

получитьОбъект

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

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

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

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

обновитьОбъект

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

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

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

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

updateObject

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

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

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

Parameters:
columnLabel - метка столбца, указанная с помощью оператора SQL AS. Если оператор SQL AS не указан, то метка — это имя столбца
x - новое значение столбца
targetSqlType - тип SQL, который будет отправлен в базу данных
scaleOrLength - для объекта типа java.math.BigDecimal это число цифр после запятой. Для типов Java Object 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. Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы 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. Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.

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

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

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

Spec-Zone.ru

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