Интерфейс 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 могут использоваться двумя способами:
- для обновления значения столбца в текущей строке. В прокручиваемом объекте
ResultSetуказатель может перемещаться назад и вперёд, к абсолютному положению или к положению относительно текущей строки. Следующий фрагмент кода обновляет столбецNAMEв пятой строке объектаResultSetобъектаrs, а затем использует методupdateRowдля обновления таблицы источника данных, из которой был полученrs.rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the //NAMEcolumn of row 5 to beAINSWORTHrs.updateRow(); // updates the row in the data source - для вставки значений столбцов в строку вставки. Обновляемый объект
ResultSetимеет специальную строку, связанную с ним, которая служит зоной подготовки для построения строки, подлежащей вставке. Следующий фрагмент кода перемещает указатель в строку вставки, строит строку из трех столбцов и вставляет её вrsи в таблицу источника данных с помощью методаinsertRow.rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to beAINSWORTHrs.updateInt(2,35); // updates the second column to be35rs.updateBoolean(3, true); // updates the third column totruers.insertRow(); rs.moveToCurrentRow();
Объект ResultSet автоматически закрывается, когда объект Statement, который его сгенерировал, закрывается, повторно выполняется или используется для извлечения следующего результата из последовательности нескольких результатов.
Количество, типы и свойства столбцов объекта ResultSet предоставляются объектом ResultSetMetaData, возвращаемым методом ResultSet.getMetaData.
- С:
- 1.1
- См. также:
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
CLOSE_CURSORS_AT_COMMIT |
Константа, указывающая, что открытые объекты ResultSet с такой удерживаемостью будут закрыты при подтверждении текущей транзакции. |
static final int |
CONCUR_READ_ONLY |
Константа, указывающая режим конкурентности для объекта ResultSet, который НЕ может быть обновлён. |
static final int |
CONCUR_UPDATABLE |
Константа, указывающая режим конкурентности для объекта ResultSet, который может быть обновлён. |
static final int |
FETCH_FORWARD |
Константа, указывающая, что строки в наборе результатов будут обрабатываться в направлении вперёд; от первой к последней. |
static final int |
FETCH_REVERSE |
Константа, указывающая, что строки в наборе результатов будут обрабатываться в обратном направлении; от последней к первой. |
static final int |
FETCH_UNKNOWN |
Константа, указывающая, что порядок обработки строк в наборе результатов неизвестен. |
static final int |
HOLD_CURSORS_OVER_COMMIT |
Константа, указывающая, что открытые объекты ResultSet с такой удерживаемостью останутся открытыми при подтверждении текущей транзакции. |
static final int |
TYPE_FORWARD_ONLY |
Константа, указывающая тип для объекта ResultSet, у которого указатель может перемещаться только вперёд. |
static final int |
TYPE_SCROLL_INSENSITIVE |
Константа, указывающая тип для объекта ResultSet, который прокручивается, но обычно не чувствителен к изменениям данных, лежащих в основе ResultSet. |
static final int |
TYPE_SCROLL_SENSITIVE |
Константа, указывающая тип для объекта ResultSet, который прокручивается и обычно чувствителен к изменениям данных, лежащих в основе ResultSet. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
absolute |
Перемещает курсор на указанный номер строки в этом объекте ResultSet. |
void |
afterLast() |
Перемещает курсор в конец этого объекта ResultSet, сразу после последней строки. |
void |
beforeFirst() |
Перемещает курсор в начало этого объекта ResultSet, непосредственно перед первой строкой. |
void |
cancelRowUpdates() |
Отменяет обновления, внесенные в текущую строку в этом объекте ResultSet. |
void |
clearWarnings() |
Очищает все предупреждения, сообщенные об этом объекте ResultSet. |
void |
close() |
Немедленно освобождает базу данных и ресурсы JDBC этого объекта ResultSet, вместо ожидания автоматического закрытия. |
void |
deleteRow() |
Удаляет текущую строку из этого объекта ResultSet и из базовой базы данных. |
int |
findColumn |
Сопоставляет заданный ярлык столбца ResultSet с его индексом столбца ResultSet. |
boolean |
first() |
Перемещает курсор на первую строку в этом объекте ResultSet. |
Array |
getArray |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект Array на языке программирования Java. |
Array |
getArray |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект Array на языке программирования Java. |
InputStream |
getAsciiStream |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока символов ASCII. |
InputStream |
getAsciiStream |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока символов ASCII. |
BigDecimal |
getBigDecimal |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как java.math.BigDecimal с полной точностью. |
BigDecimal |
getBigDecimal |
Устарело. |
BigDecimal |
getBigDecimal |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как java.math.BigDecimal с полной точностью. |
BigDecimal |
getBigDecimal |
Устарело. Используйте getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
|
InputStream |
getBinaryStream |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока неинтерпретируемых байтов. |
InputStream |
getBinaryStream |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока неинтерпретируемых byte. |
Blob |
getBlob |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект Blob на языке программирования Java. |
Blob |
getBlob |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект Blob на языке программирования Java. |
boolean |
getBoolean |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как boolean на языке программирования Java. |
boolean |
getBoolean |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как boolean на языке программирования Java. |
byte |
getByte |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как byte на языке программирования Java. |
byte |
getByte |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как byte на языке программирования Java. |
byte[] |
getBytes |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как массив byte на языке программирования Java. |
byte[] |
getBytes |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как массив byte на языке программирования Java. |
Reader |
getCharacterStream |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader. |
Reader |
getCharacterStream |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader. |
Clob |
getClob |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект Clob на языке программирования Java. |
Clob |
getClob |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект Clob на языке программирования Java. |
int |
getConcurrency() |
Извлекает режим конкурентного доступа этого объекта ResultSet. |
String |
getCursorName() |
Извлекает имя SQL-курсора, используемого этим объектом ResultSet. |
Date |
getDate |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date на языке программирования Java. |
Date |
getDate |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date на языке программирования Java. |
Date |
getDate |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date на языке программирования Java. |
Date |
getDate |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date на языке программирования Java. |
double |
getDouble |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как double на языке программирования Java. |
double |
getDouble |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как double на языке программирования Java. |
int |
getFetchDirection() |
Извлекает направление выборки для этого объекта ResultSet. |
int |
getFetchSize() |
Извлекает размер выборки для этого объекта ResultSet. |
float |
getFloat |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как float на языке программирования Java. |
float |
getFloat |
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как float на языке программирования Java. |
int |
getHoldability() |
Извлекает режим удержания этого объекта ResultSet |
int |
getInt |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта int языка программирования Java. |
int |
getInt |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта int языка программирования Java. |
long |
getLong |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта long языка программирования Java. |
long |
getLong |
Получает количество, типы и свойства столбцов этого объекта ResultSet. |
ResultSetMetaData |
getMetaData() |
Получает значение указанного столбца в текущей строке этого объекта ResultSet. |
Reader |
getNCharacterStream |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.io.Reader. |
Reader |
getNCharacterStream |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.io.Reader. |
NClob |
getNClob |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта NClob языка программирования Java. |
NClob |
getNClob |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта NClob языка программирования Java. |
String |
getNString |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта String языка программирования Java. |
String |
getNString |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта String языка программирования Java. |
Object |
getObject |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта Object языка программирования Java. |
<T> T |
getObject |
Получает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует его из SQL типа столбца в запрашиваемый тип данных Java, если преобразование поддерживается. |
Object |
getObject |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта Object языка программирования Java. |
Object |
getObject |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта Object языка программирования Java. |
<T> T |
getObject |
Получает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует его из SQL типа столбца в запрашиваемый тип данных Java, если преобразование поддерживается. |
Object |
getObject |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта Object языка программирования Java. |
Ref |
getRef |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта Ref языка программирования Java. |
Ref |
getRef |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта Ref языка программирования Java. |
int |
getRow() |
Получает номер текущей строки. |
RowId |
getRowId |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.RowId языка программирования Java. |
RowId |
getRowId |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.RowId языка программирования Java. |
short |
getShort |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта short языка программирования Java. |
short |
getShort |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта short языка программирования Java. |
SQLXML |
getSQLXML |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.SQLXML языка программирования Java. |
SQLXML |
getSQLXML |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.SQLXML языка программирования Java. |
Statement |
getStatement() |
Получает объект Statement, который породил этот объект ResultSet. |
String |
getString |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта String языка программирования Java. |
String |
getString |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта String языка программирования Java. |
Time |
getTime |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Time языка программирования Java. |
Time |
getTime |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Time языка программирования Java. |
Time |
getTime |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Time языка программирования Java. |
Time |
getTime |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Time языка программирования Java. |
Timestamp |
getTimestamp |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Timestamp языка программирования Java. |
Timestamp |
getTimestamp |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Timestamp языка программирования Java. |
Timestamp |
getTimestamp |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.sql.Timestamp языка программирования Java. |
Timestamp |
getTimestamp |
Получает тип этого объекта ResultSet. |
InputStream |
getUnicodeStream |
Устаревшее. Используйте getCharacterStream вместо getUnicodeStream |
InputStream |
getUnicodeStream |
Устаревшее. Используйте getCharacterStream вместо этого |
URL |
getURL |
Получает значение указанного столбца в текущей строке этого объекта ResultSet в качестве объекта java.net.URL языка программирования Java. |
URL |
getURL |
Извлекает значение указанного столбца в текущей строке этого объекта 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 |
Перемещает курсор на относительное количество строк, положительное или отрицательное. |
boolean |
rowDeleted() |
Извлекает, была ли удалена строка. |
boolean |
rowInserted() |
Извлекает, была ли вставка в текущую строку. |
boolean |
rowUpdated() |
Извлекает, была ли обновлена текущая строка. |
void |
setFetchDirection |
Подсказка о направлении обработки строк в этом объекте ResultSet. |
void |
setFetchSize |
Подсказка для JDBC-драйвера о количестве строк, которые следует извлечь из базы данных, когда для этого объекта ResultSet потребуются дополнительные строки. |
void |
updateArray |
Обновляет указанный столбец значением java.sql.Array. |
void |
updateArray |
Обновляет указанный столбец значением java.sql.Array. |
void |
updateAsciiStream |
Обновляет указанный столбец значением потока ASCII. |
void |
updateAsciiStream |
Обновляет указанный столбец значением потока ASCII, который будет иметь указанное количество байтов. |
void |
updateAsciiStream |
Обновляет указанный столбец значением потока ASCII, который будет иметь указанное количество байтов. |
void |
updateAsciiStream |
Обновляет указанный столбец значением потока ASCII. |
void |
updateAsciiStream |
Обновляет указанный столбец значением потока ASCII, который будет иметь указанное количество байтов. |
void |
updateAsciiStream |
Обновляет указанный столбец значением потока ASCII, который будет иметь указанное количество байтов. |
void |
updateBigDecimal |
Обновляет указанный столбец значением java.math.BigDecimal. |
void |
updateBigDecimal |
Обновляет указанный столбец значением java.sql.BigDecimal. |
void |
updateBinaryStream |
Обновляет указанный столбец значением бинарного потока. |
void |
updateBinaryStream |
Обновляет указанный столбец значением бинарного потока, который будет иметь указанное количество байтов. |
void |
updateBinaryStream |
Обновляет указанный столбец значением бинарного потока, который будет иметь указанное количество байтов. |
void |
updateBinaryStream |
Обновляет указанный столбец значением бинарного потока. |
void |
updateBinaryStream |
Обновляет указанный столбец значением бинарного потока, который будет иметь указанное количество байтов. |
void |
updateBinaryStream |
Обновляет указанный столбец значением бинарного потока, который будет иметь указанное количество байтов. |
void |
updateBlob |
Обновляет указанный столбец с помощью заданного входного потока. |
void |
updateBlob |
Обновляет указанный столбец с помощью заданного входного потока, который будет иметь указанное количество байтов. |
void |
updateBlob |
Обновляет указанный столбец значением java.sql.Blob. |
void |
updateBlob |
Обновляет указанный столбец с помощью заданного входного потока. |
void |
updateBlob |
Обновляет указанный столбец с помощью заданного входного потока, который будет иметь указанное количество байтов. |
void |
updateBlob |
Обновляет указанный столбец значением java.sql.Blob. |
void |
updateBoolean |
Обновляет указанный столбец значением boolean. |
void |
updateBoolean |
Обновляет указанный столбец значением boolean. |
void |
updateByte |
Обновляет указанный столбец значением byte. |
void |
updateByte |
Обновляет указанный столбец значением byte. |
void |
updateBytes |
Обновляет указанный столбец значением массива byte. |
void |
updateBytes |
Обновляет указанный столбец значением массива байтов. |
void |
updateCharacterStream |
Обновляет указанный столбец значением потока символов. |
void |
updateCharacterStream |
Обновляет указанный столбец значением потока символов, который будет иметь указанное количество байтов. |
void |
updateCharacterStream |
Обновляет указанный столбец значением потока символов, который будет иметь указанное количество байтов. |
void |
updateCharacterStream |
Обновляет указанный столбец значением потока символов. |
void |
updateCharacterStream |
Обновляет указанный столбец значением потока символов, который будет иметь указанное количество байтов. |
void |
updateCharacterStream |
Обновляет указанный столбец значением потока символов, который будет иметь указанное количество байтов. |
void |
updateClob |
Обновляет указанный столбец с помощью заданного объекта Reader. |
void |
updateClob |
Обновляет указанный столбец с помощью заданного объекта Reader, который имеет заданное количество символов. |
void |
updateClob |
Обновляет указанный столбец значением java.sql.Clob. |
void |
updateClob |
Обновляет указанный столбец, используя переданный объект Reader. |
void |
updateClob |
Обновляет указанный столбец, используя переданный объект Reader, длина которого равна заданному числу символов. |
void |
updateClob |
Обновляет указанный столбец значением java.sql.Clob. |
void |
updateDate |
Обновляет указанный столбец значением java.sql.Date. |
void |
updateDate |
Обновляет указанный столбец значением java.sql.Date. |
void |
updateDouble |
Обновляет указанный столбец значением double. |
void |
updateDouble |
Обновляет указанный столбец значением double. |
void |
updateFloat |
Обновляет указанный столбец значением float. |
void |
updateFloat |
Обновляет указанный столбец значением float. |
void |
updateInt |
Обновляет указанный столбец значением int. |
void |
updateInt |
Обновляет указанный столбец значением int. |
void |
updateLong |
Обновляет указанный столбец значением long. |
void |
updateLong |
Обновляет указанный столбец значением long. |
void |
updateNCharacterStream |
Обновляет указанный столбец значением потока символов. |
void |
updateNCharacterStream |
Обновляет указанный столбец значением потока символов, длина которого будет равна указанному числу байтов. |
void |
updateNCharacterStream |
Обновляет указанный столбец значением потока символов. |
void |
updateNCharacterStream |
Обновляет указанный столбец значением потока символов, длина которого будет равна указанному числу байтов. |
void |
updateNClob |
Обновляет указанный столбец, используя переданный объект Reader. Данные будут считываться из потока по мере необходимости, пока не будет достигнут конец потока. |
void |
updateNClob |
Обновляет указанный столбец, используя переданный объект Reader, длина которого равна заданному числу символов. |
void |
updateNClob |
Обновляет указанный столбец значением java.sql.NClob. |
void |
updateNClob |
Обновляет указанный столбец, используя переданный объект Reader. |
void |
updateNClob |
Обновляет указанный столбец, используя переданный объект Reader, длина которого равна заданному числу символов. |
void |
updateNClob |
Обновляет указанный столбец значением java.sql.NClob. |
void |
updateNString |
Обновляет указанный столбец значением String. |
void |
updateNString |
Обновляет указанный столбец значением String. |
void |
updateNull |
Обновляет указанный столбец значением null. |
void |
updateNull |
Обновляет указанный столбец значением null. |
void |
updateObject |
Обновляет указанный столбец значением Object. |
void |
updateObject |
Обновляет указанный столбец значением Object. |
default void |
updateObject |
Обновляет указанный столбец значением Object. |
default void |
updateObject |
Обновляет указанный столбец значением Object. |
void |
updateObject |
Обновляет указанный столбец значением Object. |
void |
updateObject |
Обновляет указанный столбец значением Object. |
default void |
updateObject |
Обновляет указанный столбец значением Object. |
default void |
updateObject |
Обновляет указанный столбец значением Object. |
void |
updateRef |
Обновляет указанный столбец значением java.sql.Ref. |
void |
updateRef |
Обновляет указанный столбец значением java.sql.Ref. |
void |
updateRow() |
Обновляет базу данных новыми значениями текущей строки объекта ResultSet. |
void |
updateRowId |
Обновляет указанный столбец значением RowId. |
void |
updateRowId |
Обновляет указанный столбец значением RowId. |
void |
updateShort |
Обновляет указанный столбец значением short. |
void |
updateShort |
Обновляет указанный столбец значением short. |
void |
updateSQLXML |
Обновляет указанный столбец значением java.sql.SQLXML. |
void |
updateSQLXML |
Обновляет указанный столбец значением java.sql.SQLXML. |
void |
updateString |
Обновляет указанный столбец значением String. |
void |
updateString |
Обновляет указанный столбец значением String. |
void |
updateTime |
Обновляет указанный столбец значением java.sql.Time. |
void |
updateTime |
Обновляет указанный столбец значением java.sql.Time. |
void |
updateTimestamp |
Обновляет указанный столбец значением java.sql.Timestamp. |
void |
updateTimestamp |
Обновляет указанный столбец значением 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
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
NULL. Обратите внимание, что вы должны сначала вызвать один из методов-получателей столбца, чтобы попытаться прочитать его значение, а затем вызвать метод wasNull, чтобы увидеть, было ли прочитанное значение SQL NULL.- Возвращает:
-
true, если последнее прочитанное значение столбца было SQLNULLиfalseв противном случае - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getString
String getString(int columnIndex) throws SQLException
ResultSet как строку String на языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Выбрасывает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getBoolean
boolean getBoolean(int columnIndex) throws SQLException
ResultSet в качестве значения типа boolean языка программирования Java. Если указанный столбец имеет тип данных CHAR или VARCHAR и содержит "0", или имеет тип данных BIT, TINYINT, SMALLINT, INTEGER или BIGINT и содержит 0, возвращается значение false. Если указанный столбец имеет тип данных CHAR или VARCHAR и содержит "1", или имеет тип данных BIT, TINYINT, SMALLINT, INTEGER или BIGINT и содержит 1, возвращается значение true.
- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноfalse - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getByte
byte getByte(int columnIndex) throws SQLException
ResultSet в качестве значения типа byte языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getShort
short getShort(int columnIndex) throws SQLException
ResultSet в качестве значения типа short языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getInt
int getInt(int columnIndex) throws SQLException
ResultSet в качестве значения типа int языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getLong
long getLong(int columnIndex) throws SQLException
ResultSet в качестве значения типа long языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getFloat
float getFloat(int columnIndex) throws SQLException
ResultSet в качестве значения типа float языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getDouble
double getDouble(int columnIndex) throws SQLException
ResultSet в качестве значения типа double языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
ResultSet в качестве значения типа java.sql.BigDecimal языка программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
scale- количество цифр после десятичной точки - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод
getBytes
byte[] getBytes(int columnIndex) throws SQLException
ResultSet в качестве массива byte на языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getDate
Date getDate(int columnIndex) throws SQLException
ResultSet в качестве объекта java.sql.Date на языке программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getTime
Time getTime(int columnIndex) throws SQLException
ResultSet в качестве объекта java.sql.Time на языке программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLException
ResultSet в качестве объекта java.sql.Timestamp на языке программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLException
ResultSet в виде потока ASCII-символов. Значение можно затем считывать из потока частями. Этот метод особенно подходит для получения больших значений LONGVARCHAR. JDBC-драйвер выполнит необходимую конвертацию из формата базы данных в ASCII. Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может возвращать 0 при вызове метода InputStream.available, независимо от наличия данных или нет.
- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- входной поток Java, который передает значение столбца базы данных в виде потока однобайтовых ASCII-символов; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getUnicodeStream
@Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException
getCharacterStream вместо getUnicodeStream
ResultSet в виде потока двухбайтных 3 символов. Первый байт — старший байт, второй байт — младший байт. Значение можно затем считывать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARCHAR. Драйвер JDBC выполнит все необходимые преобразования из формата базы данных в Unicode. Примечание: Все данные в возвращенном потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода InputStream.available, независимо от наличия данных.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй - 2 и т.д. - Возвращает:
- поток ввода Java, который предоставляет значение столбца базы данных в виде потока двухбайтных символов Unicode; если значение является SQL
NULL, возвращаемое значение равноnull - Издает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод
getBinaryStream
InputStream getBinaryStream(int columnIndex) throws SQLException
ResultSet в виде потока неинтерпретированных байтов. Значение можно затем считывать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARBINARY. Примечание: Все данные в возвращенном потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода InputStream.available, независимо от наличия данных.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй - 2 и т.д. - Возвращает:
- поток ввода Java, который предоставляет значение столбца базы данных в виде потока неинтерпретированных байтов; если значение является SQL
NULL, возвращаемое значение равноnull - Издает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getString
String getString(String columnLabel) throws SQLException
ResultSet как строку в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getBoolean
boolean getBoolean(String columnLabel) throws SQLException
ResultSet как булево значение в языке программирования Java. Если тип данных указанного столбца CHAR или VARCHAR и он содержит "0", или если тип данных BIT, TINYINT, SMALLINT, INTEGER или BIGINT и он содержит 0, возвращается значение false. Если тип данных указанного столбца CHAR или VARCHAR и он содержит "1", или если тип данных BIT, TINYINT, SMALLINT, INTEGER или BIGINT и он содержит 1, возвращается значение true.
- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноfalse - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getByte
byte getByte(String columnLabel) throws SQLException
ResultSet как байт в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getShort
short getShort(String columnLabel) throws SQLException
ResultSet как целое число с коротким типом в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getInt
int getInt(String columnLabel) throws SQLException
ResultSet как целое число в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getLong
long getLong(String columnLabel) throws SQLException
ResultSet как целое число с длинной точностью в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getFloat
float getFloat(String columnLabel) throws SQLException
ResultSet как число с плавающей точкой в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getDouble
double getDouble(String columnLabel) throws SQLException
ResultSet как число с двойной точностью в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
ResultSet как число с плавающей точкой высокой точности в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца -
scale- количество цифр справа от десятичной точки - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Издает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод
getBytes
byte[] getBytes(String columnLabel) throws SQLException
ResultSet объекта в виде массива byte в языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение являетсяnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDate
Date getDate(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.sql.Date в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение являетсяnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTime
Time getTime(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.sql.Time в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение являетсяnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTimestamp
Timestamp getTimestamp(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.sql.Timestamp в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение являетсяnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getAsciiStream
InputStream getAsciiStream(String columnLabel) throws SQLException
ResultSet объекта в виде потока ASCII-символов. Значение затем можно читать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARCHAR. Драйвер JDBC выполнит необходимое преобразование из формата базы данных в ASCII. Примечание: Все данные в возвращаемом потоке должны быть прочитаны перед получением значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода available, независимо от наличия данных.
- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- входной поток Java, который предоставляет значение столбца базы данных в виде потока символов ASCII с одним байтом. Если значение является SQL
NULL, возвращаемое значение являетсяnull. - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getUnicodeStream
@Deprecated(since="1.2") InputStream getUnicodeStream(String columnLabel) throws SQLException
getCharacterStream вместо этогоResultSet объекта в виде потока символов Unicode с двумя байтами. Первый байт — старший байт; второй байт — младший байт. Значение затем можно читать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARCHAR. Драйвер, поддерживающий JDBC, выполнит необходимое преобразование из формата базы данных в Unicode. Примечание: Все данные в возвращаемом потоке должны быть прочитаны перед получением значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Также поток может вернуть 0 при вызове метода InputStream.available, независимо от наличия данных.
- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- входной поток Java, который предоставляет значение столбца базы данных в виде потока символов Unicode с двумя байтами. Если значение является SQL
NULL, возвращаемое значение являетсяnull. - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод
getBinaryStream
InputStream getBinaryStream(String columnLabel) throws SQLException
ResultSet объекта в виде потока неинтерпретированных byte. Значение затем можно читать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARBINARY. Примечание: Все данные в возвращаемом потоке должны быть прочитаны перед получением значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Также поток может вернуть 0 при вызове метода available, независимо от наличия данных.
- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца - Returns:
- входной поток Java, который предоставляет значение столбца базы данных в виде потока неинтерпретированных байтов; если значение является SQL
NULL, результатом являетсяnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getWarnings
SQLWarning getWarnings() throws SQLException
ResultSet объекта. Последующие предупреждения об этом ResultSet объекте будут присоединены к объекту SQLWarning, который возвращает этот метод. Цепочка предупреждений автоматически очищается каждый раз при чтении новой строки. Этот метод не может быть вызван для объекта ResultSet, который был закрыт; в противном случае будет выброшено исключение SQLException.
Примечание: Эта цепочка предупреждений охватывает только предупреждения, вызванные ResultSet методами. Любое предупреждение, вызванное Statement методами (например, чтение параметров OUT) будет прикреплено к объекту Statement.
- Returns:
- первый объект
SQLWarning, сообщённый, илиnull, если их нет - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
clearWarnings
void clearWarnings() throws SQLException
ResultSet объектом. После вызова этого метода метод getWarnings возвращает null до тех пор, пока не будет сообщено новое предупреждение для этого ResultSet объекта.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getCursorName
String getCursorName() throws SQLException
ResultSet объектом. В SQL таблица результатов извлекается с помощью именованного курсора. Текущая строка набора результатов может быть обновлена или удалена с помощью оператора обновленной/удаленной позиции, который ссылается на имя курсора. Для обеспечения того, чтобы курсор имел соответствующий уровень изоляции, для поддержки обновления, оператор курсора должен иметь вид SELECT FOR UPDATE. Если FOR UPDATE отсутствует, обновлённые позиции могут завершиться ошибкой.
API JDBC поддерживает эту SQL-функцию, предоставляя имя SQL-курсора, используемого объектом ResultSet. Текущая строка объекта ResultSet также является текущей строкой этого SQL-курсора.
- Returns:
- SQL-имя курсора объекта
ResultSet - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод
getMetaData
ResultSetMetaData getMetaData() throws SQLException
ResultSet.- Возвращает:
- описание столбцов этого объекта
ResultSet - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getObject
Object getObject(int columnIndex) throws SQLException
Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Object языка программирования Java.
Этот метод вернёт значение заданного столбца как объект Java. Тип объекта Java будет соответствовать стандартному типу Java, соответствующему типу SQL столбца, согласно сопоставлению встроенных типов, указанному в спецификации JDBC. Если значение является SQL NULL, драйвер возвращает Java null.
Этот метод также может использоваться для чтения абстрактных типов данных, специфичных для базы данных. В API JDBC 2.0 поведение метода getObject расширено для материализации данных SQL типов, определённых пользователем.
Если Connection.getTypeMap не вызывает SQLFeatureNotSupportedException, то при столбце со структурированным или distinct значением, поведение этого метода такое же, как и вызов: getObject(columnIndex,
this.getStatement().getConnection().getTypeMap()). Если Connection.getTypeMap вызывает SQLFeatureNotSupportedException, то структурированные значения не поддерживаются, а distinct значения отображаются в стандартный Java-класс, определяемый типом SQL DISTINCT.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Возвращает:
- объект
java.lang.Object, содержащий значение столбца - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getObject
Object getObject(String columnLabel) throws SQLException
Получает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Object языка программирования Java.
Этот метод вернёт значение заданного столбца как объект Java. Тип объекта Java будет соответствовать стандартному типу Java, соответствующему типу SQL столбца, согласно сопоставлению встроенных типов, указанному в спецификации JDBC. Если значение является SQL NULL, драйвер возвращает Java null.
Этот метод также может использоваться для чтения абстрактных типов данных, специфичных для базы данных.
В API JDBC 2.0 поведение метода getObject расширено для материализации данных SQL типов, определённых пользователем. При столбце со структурированным или distinct значением, поведение этого метода такое же, как и вызов: getObject(columnIndex,
this.getStatement().getConnection().getTypeMap()).
- Параметры:
-
columnLabel- имя столбца, указанное в SQL-оператор AS. Если опреатор AS не указан, именем столбца является имя столбца. - Возвращает:
- объект
java.lang.Object, содержащий значение столбца - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
findColumn
int findColumn(String columnLabel) throws SQLException
ResultSet с его индексом столбца ResultSet.- Параметры:
-
columnLabel- имя столбца, указанное в SQL-оператор AS. Если опреатор AS не указан, именем столбца является имя столбца. - Возвращает:
- индекс столбца данного имени столбца
- Выбрасывает:
-
SQLException- если объектResultSetне содержит столбец с именемcolumnLabel, произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов
getCharacterStream
Reader getCharacterStream(int columnIndex) throws SQLException
ResultSet в виде объекта java.io.Reader.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Возвращает:
- объект
java.io.Reader, содержащий значение столбца; если значение является SQLNULL, возвращается значение типаnullязыка программирования Java. - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - Since:
- 1.2
getCharacterStream
Reader getCharacterStream(String columnLabel) throws SQLException
ResultSet в виде объекта java.io.Reader.- Параметры:
-
columnLabel- имя столбца, указанное в SQL-оператор AS. Если опреатор AS не указан, именем столбца является имя столбца. - Возвращает:
- объект
java.io.Reader, содержащий значение столбца; если значение является SQLNULL, возвращается значение типаnullязыка программирования Java. - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - Since:
- 1.2
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLException
ResultSet в виде java.math.BigDecimal с полной точностью.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Возвращает:
- значение столбца (полная точность); если значение является SQL
NULL, возвращается значение типаnullязыка программирования Java. - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - Since:
- 1.2
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLException
ResultSet в виде java.math.BigDecimal с полной точностью.- Параметры:
-
columnLabel- имя столбца, указанное в SQL-оператор AS. Если опреатор AS не указан, именем столбца является имя столбца. - Возвращает:
- значение столбца (полная точность); если значение является SQL
NULL, возвращается значение типаnullязыка программирования Java. - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - Since:
- 1.2
isBeforeFirst
boolean isBeforeFirst() throws SQLException
ResultSet. Примечание: Поддержка метода isBeforeFirst является необязательной для наборов результатов ResultSet с типом результата TYPE_FORWARD_ONLY
- Возвращает:
-
true, если курсор перед первой строкой;false, если курсор в любой другой позиции или набор результатов не содержит строк - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
isAfterLast
boolean isAfterLast() throws SQLException
ResultSet. Примечание: Поддержка метода isAfterLast является необязательной для наборов результатов ResultSet с типом результата TYPE_FORWARD_ONLY
- Возвращает:
-
true, если курсор после последней строки;false, если курсор в любой другой позиции или набор результатов не содержит строк - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
isFirst
boolean isFirst() throws SQLException
ResultSet. Примечание: Поддержка метода isFirst является необязательной для наборов результатов ResultSet с типом результата TYPE_FORWARD_ONLY
- Возвращает:
-
true, если курсор на первой строке;false, в противном случае - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
isLast
boolean isLast() throws SQLException
ResultSet. Примечание: Вызов метода isLast может быть затратным, так как драйвер JDBC может потребоваться извлечь следующую строку, чтобы определить, является ли текущая строка последней строкой в наборе результатов. Примечание: Поддержка метода isLast необязательна для объектов ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Возвращает:
-
true, если курсор находится на последней строке;falseв противном случае - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
beforeFirst
void beforeFirst() throws SQLException
ResultSet, сразу перед первой строкой. Этот метод не оказывает никакого влияния, если набор результатов не содержит строк.- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
afterLast
void afterLast() throws SQLException
ResultSet, сразу после последней строки. Этот метод не оказывает никакого влияния, если набор результатов не содержит строк.- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
first
boolean first() throws SQLException
ResultSet.- Возвращает:
-
true, если курсор находится на корректной строке;false, если в наборе результатов нет строк - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
last
boolean last() throws SQLException
ResultSet.- Возвращает:
-
true, если курсор находится на корректной строке;false, если в наборе результатов нет строк - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getRow
int getRow() throws SQLException
Примечание: Поддержка метода 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
- См. также:
getFetchDirection
int getFetchDirection() throws SQLException
ResultSet.- Возвращает:
- текущее направление выборки для этого объекта
ResultSet - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов - С:
- 1.2
- См. также:
setFetchSize
void setFetchSize(int rows) throws SQLException
ResultSet объекта требуются дополнительные строки. Если указанный размер выборки равен нулю, JDBC драйвер игнорирует значение и свободен сам сделать лучшее предположение о том, каким должен быть размер выборки. Значение по умолчанию устанавливается объектом Statement, который создал набор результатов. Размер выборки может быть изменён в любое время.- Параметры:
-
rows- количество строк для извлечения - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или условиеrows >= 0не выполняется - С:
- 1.2
- См. также:
getFetchSize
int getFetchSize() throws SQLException
ResultSet объекта.- Возвращает:
- текущий размер выборки для этого
ResultSetобъекта - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов - С:
- 1.2
- См. также:
getType
int getType() throws SQLException
ResultSet объекта. Тип определяется объектом Statement, который создал набор результатов.- Возвращает:
-
ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVEилиResultSet.TYPE_SCROLL_SENSITIVE - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов - С:
- 1.2
getConcurrency
int getConcurrency() throws SQLException
ResultSet объекта. Используемая конкуреность определяется объектом Statement, который создал набор результатов.- Возвращает:
- тип конкурентного доступа, либо
ResultSet.CONCUR_READ_ONLY, либоResultSet.CONCUR_UPDATABLE - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов - С:
- 1.2
rowUpdated
boolean rowUpdated() throws SQLException
Примечание: Поддержка метода rowUpdated является необязательной для набора результатов с режимом конкурентного доступа CONCUR_READ_ONLY
- Возвращает:
-
true, если текущая строка была явно обновлена владельцем или другим;falseв противном случае - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
- См. также:
rowInserted
boolean rowInserted() throws SQLException
ResultSet объект обнаруживать видимые вставки. Примечание: Поддержка метода rowInserted является необязательной для набора результатов с режимом конкурентного доступа CONCUR_READ_ONLY
- Возвращает:
-
true, если текущая строка была вставлена;falseв противном случае - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
- См. также:
rowDeleted
boolean rowDeleted() throws SQLException
ResultSet объект обнаруживать удаления. Примечание: Поддержка метода rowDeleted является необязательной для набора результатов с режимом конкурентного доступа CONCUR_READ_ONLY
- Возвращает:
-
true, если текущая строка была удалена владельцем или другим;falseв противном случае - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
- См. также:
updateNull
void updateNull(int columnIndex) throws SQLException
null. Методы-обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновляющие значения не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец равен 1, второй равен 2, ... - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; режим конкурентного доступа набора результатов равенCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateBoolean
void updateBoolean(int columnIndex, boolean x) throws SQLException
boolean. Методы-обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновляющие значения не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец равен 1, второй равен 2, ... -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; режим конкурентного доступа набора результатов равенCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateByte
void updateByte(int columnIndex, byte x) throws SQLException
byte. Методы-обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновляющие значения не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец равен 1, второй равен 2, ... -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; режим конкурентного доступа набора результатов равенCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateShort
void updateShort(int columnIndex, short x) throws SQLException
short. Методы-обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновляющие значения не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец равен 1, второй равен 2, ... -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; режим конкурентного доступа набора результатов равенCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateInt
void updateInt(int columnIndex, int x) throws SQLException
int. Методы-обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновляющие значения не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец равен 1, второй равен 2, ... -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; режим конкурентного доступа набора результатов равенCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateLong
void updateLong(int columnIndex, long x) throws SQLException
long. Методы обновляющего типа используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateFloat
void updateFloat(int columnIndex, float x) throws SQLException
float. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateDouble
void updateDouble(int columnIndex, double x) throws SQLException
double. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateBigDecimal
void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException
java.math.BigDecimal. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateString
void updateString(int columnIndex, String x) throws SQLException
String. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateBytes
void updateBytes(int columnIndex, byte[] x) throws SQLException
byte. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateDate
void updateDate(int columnIndex, Date x) throws SQLException
java.sql.Date. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateTime
void updateTime(int columnIndex, Time x) throws SQLException
java.sql.Time. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateTimestamp
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
java.sql.Timestamp. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конкуретность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй - 2 и т.д. -
x- новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateObject
void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. Если второй аргумент является InputStream, то поток должен содержать количество байтов, указанное значением scaleOrLength. Если второй аргумент является Reader, то читатель должен содержать количество символов, указанное значением scaleOrLength. Если эти условия не выполняются, драйвер сгенерирует SQLException при выполнении оператора.
- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй - 2 и т.д. -
x- новое значение столбца -
scaleOrLength- для объекта типаjava.math.BigDecimalэто число цифр после запятой. Для типов Java ObjectInputStreamиReaderэто длина данных в потоке или ридере. Для всех других типов это значение будет проигнорировано. - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateObject
void updateObject(int columnIndex, Object x) throws SQLException
Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй - 2 и т.д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateNull
void updateNull(String columnLabel) throws SQLException
null. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateBoolean
void updateBoolean(String columnLabel, boolean x) throws SQLException
boolean. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateByte
void updateByte(String columnLabel, byte x) throws SQLException
byte. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateShort
void updateShort(String columnLabel, short x) throws SQLException
short. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateInt
void updateInt(String columnLabel, int x) throws SQLException
int. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateLong
void updateLong(String columnLabel, long x) throws SQLException
long. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, заданная с помощью SQL-предложения AS. Если предложение SQL AS не было указано, то метка - это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов -CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
обновитьВещественное
void updateFloat(String columnLabel, float x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьДвойное
void updateDouble(String columnLabel, double x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьBigDecimal
void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьСтроку
void updateString(String columnLabel, String x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьБайты
void updateBytes(String columnLabel, byte[] x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьДату
void updateDate(String columnLabel, Date x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьВремя
void updateTime(String columnLabel, Time x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьМаркерВремени
void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьПотокAscii
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьПотокБинарныхДанных
void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если оператор SQL AS не указан, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если метка столбца некорректна; если произошла ошибка доступа к базе данных; уровень параллелизма набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateObject
void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException
Object. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. Если второй аргумент является InputStream, то поток должен содержать количество байтов, указанное параметром scaleOrLength. Если второй аргумент является Reader, то читатель должен содержать количество символов, указанное параметром scaleOrLength. Если эти условия не выполнены, драйвер сгенерирует SQLException при выполнении оператора.
- Parameters:
-
columnLabel- метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца -
x- новое значение столбца -
scaleOrLength- для объекта типаjava.math.BigDecimalэто количество цифр после запятой. Для типов Java ObjectInputStreamиReader, это длина данных в потоке или читателе. Для всех других типов это значение будет проигнорировано. - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateObject
void updateObject(String columnLabel, Object x) throws SQLException
Object. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
insertRow
void insertRow() throws SQLException
ResultSet и в базу данных. Курсор должен находиться на строке вставки при вызове этого метода.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; конвейер набора результатов являетсяCONCUR_READ_ONLY, этот метод вызывается для закрытого набора результатов, если этот метод вызывается, когда курсор не находится на строке вставки, или если не все столбцы, не допускающие NULL, в строке вставки не получили значение не NULL -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateRow
void updateRow() throws SQLException
ResultSet. Этот метод не может быть вызван, когда курсор находится на строке вставки.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; конвейер набора результатов являетсяCONCUR_READ_ONLY; этот метод вызывается для закрытого набора результатов или если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
deleteRow
void deleteRow() throws SQLException
ResultSet и из базы данных. Этот метод не может быть вызван, когда курсор находится на строке вставки.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; конвейер набора результатов являетсяCONCUR_READ_ONLY; этот метод вызывается для закрытого набора результатов или если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
refreshRow
void refreshRow() throws SQLException
Метод refreshRow предоставляет способ, чтобы приложение явно сообщило драйверу JDBC о необходимости повторного извлечения строки(ок) из базы данных. Приложение может вызвать refreshRow при кешировании или предварительном извлечении, выполняемом драйвером JDBC, для извлечения последнего значения строки из базы данных. Драйвер JDBC может фактически обновить сразу несколько строк, если размер извлечения больше единицы.
Все значения извлекаются повторно, учитывая уровень изоляции транзакции и чувствительность курсора. Если refreshRow вызывается после вызова метода обновлителя, но перед вызовом метода updateRow, то внесенные в строку изменения будут потеряны. Частое вызывание метода refreshRow, вероятно, замедлит производительность.
- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов; тип набора результатов являетсяTYPE_FORWARD_ONLYили если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод или этот метод не поддерживается для указанного типа и конвейера набора результатов. - Since:
- 1.2
cancelRowUpdates
void cancelRowUpdates() throws SQLException
ResultSet. Этот метод может быть вызван после вызова метода обновлителя(ей) и перед вызовом метода updateRow, чтобы откатить внесенные в строку изменения. Если не было сделано обновлений или updateRow уже был вызван, этот метод не окажет никакого влияния.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов; конвейер набора результатов являетсяCONCUR_READ_ONLYили если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
moveToInsertRow
void moveToInsertRow() throws SQLException
insertRow. Все столбцы в наборе результатов должны получить значение каждый раз, когда вызывается этот метод, прежде чем вызывать insertRow. Метод обновлителя должен быть вызван перед тем, как можно будет вызвать метод getter для значения столбца.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или конвейер набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
moveToCurrentRow
void moveToCurrentRow() throws SQLException
- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или конвейер набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
getStatement
Statement getStatement() throws SQLException
Statement, который произвел этот объект ResultSet. Если набор результатов сгенерирован каким-то другим способом, например, методом DatabaseMetaData, этот метод может вернуть null.- Returns:
- объект
Statement, который произвел этот объектResultSetилиnull, если набор результатов был получен другим способом - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - Since:
- 1.2
getObject
Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException
ResultSet объекта в качестве Object в языке программирования Java. Если значение является SQL NULL, драйвер возвращает Java null. Данный метод использует переданный Map объект для пользовательской сопоставления SQL структурированного или отдельного типа, который извлекается.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
map- объектjava.util.Map, содержащий сопоставление имён типов SQL с классами в языке программирования Java - Возвращает:
Objectв языке программирования Java, представляющий значение SQL- Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getRef
Ref getRef(int columnIndex) throws SQLException
ResultSet объекта как объект Ref в языке программирования Java.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Возвращает:
- объект
Ref, представляющий значение SQLREF - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getBlob
Blob getBlob(int columnIndex) throws SQLException
ResultSet объекта как объект Blob в языке программирования Java.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Возвращает:
- объект
Blob, представляющий значение SQLBLOBв указанном столбце - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getClob
Clob getClob(int columnIndex) throws SQLException
ResultSet объекта как объект Clob в языке программирования Java.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Возвращает:
- объект
Clob, представляющий значение SQLCLOBв указанном столбце - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getArray
Array getArray(int columnIndex) throws SQLException
ResultSet объекта как объект Array в языке программирования Java.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Возвращает:
- объект
Array, представляющий значение SQLARRAYв указанном столбце - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getObject
Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
ResultSet объекта как Object в языке программирования Java. Если значение является SQL NULL, драйвер возвращает Java null. Этот метод использует указанный Map объект для пользовательского сопоставления, если это уместно.- Параметры:
-
columnLabel- метка столбца, указанная с помощью SQL-запроса AS. Если SQL-запрос AS не был указан, метка — это имя столбца -
map- объектjava.util.Map, содержащий сопоставление имён типов SQL с классами в языке программирования Java - Возвращает:
Object, представляющий значение SQL в указанном столбце- Исключение:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getRef
Ref getRef(String columnLabel) throws SQLException
ResultSet объекта как объект Ref в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанная с помощью SQL-запроса AS. Если SQL-запрос AS не был указан, метка — это имя столбца - Возвращает:
- объект
Ref, представляющий значение SQLREFв указанном столбце - Исключение:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getBlob
Blob getBlob(String columnLabel) throws SQLException
ResultSet объекта как объект Blob в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанная с помощью SQL-запроса AS. Если SQL-запрос AS не был указан, метка — это имя столбца - Возвращает:
- объект
Blob, представляющий значение SQLBLOBв указанном столбце - Исключение:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getClob
Clob getClob(String columnLabel) throws SQLException
ResultSet объекта как объект Clob в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанная с помощью SQL-запроса AS. Если SQL-запрос AS не был указан, метка — это имя столбца - Возвращает:
- объект
Clob, представляющий значение SQLCLOBв указанном столбце - Исключение:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - С:
- 1.2
getArray
Array getArray(String columnLabel) throws SQLException
ResultSet объекта как объект Array в языке программирования Java.- Параметры:
-
columnLabel- метка столбца, указанная с помощью SQL-запроса AS. Если SQL-запрос AS не был указан, метка — это имя столбца - Возвращает:
- объект
Array, представляющий значение SQLARRAYв указанном столбце - Исключение:
-
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; если значение является SQLNULL, возвращаемое значение —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; если значение является SQLNULL, возвращаемое значение —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; если значение является SQLNULL, возвращаемое значение —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; если значение является SQLNULL, возвращаемое значение —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; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getTimestamp
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
ResultSet в качестве объекта java.sql.Timestamp языка программирования Java. Этот метод использует предоставленный календарь для построения соответствующего значения в миллисекундах для метки времени, если базовая база данных не хранит информацию о часовом поясе.- Параметры:
-
columnLabel- метка столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца -
cal- объектjava.util.Calendar, используемый для построения даты - Возвращает:
- значение столбца в виде объекта
java.sql.Timestamp; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключение:
-
SQLException- если columnLabel недействителен или произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getURL
URL getURL(int columnIndex) throws SQLException
ResultSet в качестве объекта java.net.URL языка программирования Java.- Параметры:
-
columnIndex- индекс столбца (1 — первый, 2 — второй и т. д.) - Возвращает:
- значение столбца в виде объекта
java.net.URL; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; метод вызывается для закрытого набора результатов или URL некорректен -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
getURL
URL getURL(String columnLabel) throws SQLException
ResultSet в качестве объекта java.net.URL языка программирования Java.- Параметры:
-
columnLabel- метка столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца - Возвращает:
- значение столбца в виде объекта
java.net.URL; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключение:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; метод вызывается для закрытого набора результатов или URL некорректен -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException
java.sql.Ref. Методы обновляющего элемента используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего элемента не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateRef
void updateRef(String columnLabel, Ref x) throws SQLException
java.sql.Ref. Методы обновляющего элемента используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего элемента не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не было указано, метка является именем столбца -
x- новое значение столбца - Исключение:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateBlob
void updateBlob(int columnIndex, Blob x) throws SQLException
java.sql.Blob. Методы обновляющего элемента используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего элемента не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateBlob
void updateBlob(String columnLabel, Blob x) throws SQLException
java.sql.Blob. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.4
updateClob
void updateClob(int columnIndex, Clob x) throws SQLException
java.sql.Clob. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.4
updateClob
void updateClob(String columnLabel, Clob x) throws SQLException
java.sql.Clob. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.4
updateArray
void updateArray(int columnIndex, Array x) throws SQLException
java.sql.Array. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.4
updateArray
void updateArray(String columnLabel, Array x) throws SQLException
java.sql.Array. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.4
getRowId
RowId getRowId(int columnIndex) throws SQLException
ResultSet в качестве объекта java.sql.RowId в языке программирования Java.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
getRowId
RowId getRowId(String columnLabel) throws SQLException
ResultSet в качестве объекта java.sql.RowId в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Throws:
-
SQLException- если columnLabel недействительно; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
updateRowId
void updateRowId(int columnIndex, RowId x) throws SQLException
RowId. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
updateRowId
void updateRowId(String columnLabel, RowId x) throws SQLException
RowId. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- значение столбца - Throws:
-
SQLException- если columnLabel недействительно; если произошла ошибка доступа к базе данных; конъюнкция набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
getHoldability
int getHoldability() throws SQLException
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 для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
nString- значение для обновления столбца - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает потенциальную ошибку преобразования данных; метод вызван на закрытом наборе результатов; конкурентность набора результатов -CONCUR_READ_ONLYили произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
updateNString
void updateNString(String columnLabel, String nString) throws SQLException
String. Предназначено для обновления столбцов NCHAR,NVARCHAR и LONGNVARCHAR. Методы-обновлятели используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновлятели не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка совпадает с именем столбца -
nString- значение для обновления столбца - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает потенциальную ошибку преобразования данных; метод вызван на закрытом наборе результатов; конкурентность набора результатов -CONCUR_READ_ONLYили произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
updateNClob
void updateNClob(int columnIndex, NClob nClob) throws SQLException
java.sql.NClob. Методы-обновлятели используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновлятели не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
nClob- значение для обновления столбца - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает потенциальную ошибку преобразования данных; метод вызван на закрытом наборе результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатов -CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
updateNClob
void updateNClob(String columnLabel, NClob nClob) throws SQLException
java.sql.NClob. Методы-обновлятели используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновлятели не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка совпадает с именем столбца -
nClob- значение для обновления столбца - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает потенциальную ошибку преобразования данных; метод вызван на закрытом наборе результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатов -CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
getNClob
NClob getNClob(int columnIndex) throws SQLException
ResultSet в виде объекта NClob языка программирования Java.- Параметры:
-
columnIndex- номер столбца (первый - 1, второй - 2 и т.д.) - Возвращает:
- объект типа
NClob, представляющий SQL-значение типаNCLOBв указанном столбце - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает потенциальную ошибку преобразования данных; метод вызван на закрытом наборе результатов или произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
getNClob
NClob getNClob(String columnLabel) throws SQLException
ResultSet в виде объекта NClob языка программирования Java.- Параметры:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка совпадает с именем столбца - Возвращает:
- объект типа
NClob, представляющий SQL-значение типаNCLOBв указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает потенциальную ошибку преобразования данных; метод вызван на закрытом наборе результатов или произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLException
ResultSet в виде объекта java.sql.SQLXML языка программирования Java.- Параметры:
-
columnIndex- номер столбца (первый - 1, второй - 2 и т.д.) - Возвращает:
- объект
SQLXML, отображающий значение типаSQL XML - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLException
ResultSet в виде объекта java.sql.SQLXML языка программирования Java.- Параметры:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка совпадает с именем столбца - Возвращает:
- объект
SQLXML, отображающий значение типаSQL XML - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
updateSQLXML
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
java.sql.SQLXML. Методы-обновлятели используются для обновления значений столбцов в текущей строке или строке вставки. Методы-обновлятели не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
xmlObject- значение для обновления столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; метод вызван на закрытом наборе результатов;java.xml.transform.Result,WriterилиOutputStreamне закрыты для объектаSQLXML; если произошла ошибка обработки XML-значения или конкурентность набора результатов -CONCUR_READ_ONLY. МетодgetCauseисключения может предоставить более подробную информацию об ошибке, например, если поток не содержит корректный XML. -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор:
- 1.6
updateSQLXML
void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException
java.sql.SQLXML. Методы обновляющие значения используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
xmlObject- значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов;java.xml.transform.Result,WriterилиOutputStreamне были закрыты для объектаSQLXML; если произошла ошибка обработки значения XML или конкурентность набора результатовCONCUR_READ_ONLY. МетодgetCauseисключения может предоставить более подробное исключение, например, если поток не содержит допустимого XML. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
getNString
String getNString(int columnIndex) throws SQLException
ResultSet в виде строки String языка программирования Java. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
getNString
String getNString(String columnLabel) throws SQLException
ResultSet в виде строки String языка программирования Java. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
getNCharacterStream
Reader getNCharacterStream(int columnIndex) throws SQLException
ResultSet в виде объекта java.io.Reader. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- объект
java.io.Reader, содержащий значение столбца; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java. - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
getNCharacterStream
Reader getNCharacterStream(String columnLabel) throws SQLException
ResultSet в виде объекта java.io.Reader. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Returns:
- объект
java.io.Reader, содержащий значение столбца; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException
NCHAR, NVARCHAR и LONGNVARCHAR. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
updateNCharacterStream
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
NCHAR, NVARCHAR и LONGNVARCHAR. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор с AS. Если SQL-оператор AS не указан, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор с AS. Если SQL-оператор AS не указан, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор с AS. Если SQL-оператор AS не указан, метка является именем столбца -
reader- объект, содержащий новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateBlob
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
inputStream- Объект, содержащий данные для установки значения параметра. -
length- количество байтов в данных параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateBlob
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор с AS. Если SQL-оператор AS не указан, метка является именем столбца -
inputStream- Объект, содержащий данные для установки значения параметра. -
length- количество байтов в данных параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateClob
void updateClob(int columnIndex, Reader reader, long length) throws SQLException
Reader, длина которого равна указанному количеству символов. При вводе очень больших значений UNICODE в параметр LONGVARCHAR может быть удобнее передать их через объект java.io.Reader. JDBC-драйвер выполнит необходимую конвертацию из UNICODE в формат символов базы данных. Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
reader- Объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateClob
void updateClob(String columnLabel, Reader reader, long length) throws SQLException
Reader, длина которого равна указанному количеству символов. При вводе очень больших значений UNICODE в параметр LONGVARCHAR может быть удобнее передать их через объект java.io.Reader. JDBC-драйвер выполнит необходимую конвертацию из UNICODE в формат символов базы данных. Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор с AS. Если SQL-оператор AS не указан, метка является именем столбца -
reader- Объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов -CONCUR_READ_ONLYили этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateNClob
void updateNClob(int columnIndex, Reader reader, long length) throws SQLException
Reader, длина которого равна заданному числу символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более целесообразно отправить его через объект java.io.Reader. Драйвер JDBC выполнит все необходимые преобразования из UNICODE в формат символов базы данных. Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т. д. -
reader- Объект, содержащий данные для задания значения параметра. -
length- количество символов в данных параметра. - Throws:
-
SQLException- если columnIndex недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если метод вызывается на закрытом наборе результатов; если возникает ошибка доступа к базе данных или параллельность набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает данный метод - Since:
- 1.6
updateNClob
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
Reader, длина которого равна заданному числу символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более целесообразно отправить его через объект java.io.Reader. Драйвер JDBC выполнит все необходимые преобразования из UNICODE в формат символов базы данных. Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnLabel- метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца -
reader- Объект, содержащий данные для задания значения параметра. -
length- количество символов в данных параметра. - Throws:
-
SQLException- если columnLabel недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если метод вызывается на закрытом наборе результатов; если возникает ошибка доступа к базе данных или параллельность набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает данный метод - Since:
- 1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
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
NCHAR, NVARCHAR и LONGNVARCHAR. Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии updateNCharacterStream, принимающей параметр длины, быть более эффективным.
- Parameters:
-
columnLabel- метка столбца, заданная с помощью предложения SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если возникает ошибка доступа к базе данных; параллельность набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает данный метод - Since:
- 1.6
updateAsciiStream
void updateAsciiStream(int columnIndex, InputStream x) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии updateAsciiStream, принимающей параметр длины, быть более эффективным.
- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если возникает ошибка доступа к базе данных; параллельность набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает данный метод - Since:
- 1.6
updateBinaryStream
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии updateBinaryStream, принимающей параметр длины, быть более эффективным.
- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если возникает ошибка доступа к базе данных; параллельность набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает данный метод - Since:
- 1.6
updateCharacterStream
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, может ли использование версии updateCharacterStream, принимающей параметр длины, быть более эффективным.
- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если возникает ошибка доступа к базе данных; параллельность набора результатов являетсяCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает данный метод - Since:
- 1.6
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
Методы обновляющие значения столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateAsciiStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, заданная с помощью SQL-описания AS. Если SQL-описания AS не указано, то метка является именем столбца. -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
Методы обновляющие значения столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateBinaryStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, заданная с помощью SQL-описания AS. Если SQL-описания AS не указано, то метка является именем столбца. -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateCharacterStream
void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
Методы обновляющие значения столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateCharacterStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, заданная с помощью SQL-описания AS. Если SQL-описания AS не указано, то метка является именем столбца. -
reader- объект, содержащий новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateBlob
void updateBlob(int columnIndex, InputStream inputStream) throws SQLException
Методы обновления значений столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateBlob, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т.д. -
inputStream- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateBlob
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
Методы обновления значений столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateBlob, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, заданная с помощью SQL-описания AS. Если SQL-описания AS не указано, то метка является именем столбца. -
inputStream- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateClob
void updateClob(int columnIndex, Reader reader) throws SQLException
Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновления значений столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateClob, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т.д. -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateClob
void updateClob(String columnLabel, Reader reader) throws SQLException
Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновления значений столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateClob, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, заданная с помощью SQL-описания AS. Если SQL-описания AS не указано, то метка является именем столбца. -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; одновременность набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов. -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateNClob
void updateNClob(int columnIndex, Reader reader) throws SQLException
Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновления значений столбцов, используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, не будет ли более эффективным использовать версию updateNClob, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2, ... -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод вызывается для закрытого набора результатов, если произошла ошибка доступа к базе данных или одновременность набора результатов —CONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод. - С момента:
- 1.6
updateNClob
void updateNClob(String columnLabel, Reader reader) throws SQLException
Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимую конвертацию из UNICODE в формат символов базы данных. Методы обновляющего класса используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего класса не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего драйвера JDBC, чтобы определить, не будет ли использование версии метода updateNClob, принимающей параметр длины, более эффективным.
- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
reader- объект, содержащий данные для установки значения параметра. - Throws:
-
SQLException- если columnLabel недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может обнаружить, что может произойти ошибка преобразования данных; этот метод вызывается для закрытого набора результатов; если возникает ошибка доступа к базе данных или конкурентность набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
getObject
<T> T getObject(int columnIndex, Class<T> type) throws SQLException
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует его из SQL типа столбца в запрошенный тип данных Java, если преобразование поддерживается. Если преобразование не поддерживается или для типа указан null, выбрасывается исключение SQLException.
Как минимум, реализация должна поддерживать преобразования, определённые в Приложении B, Таблица B-3, и преобразование соответствующих пользовательских SQL типов в тип Java, реализующий интерфейс SQLData или Struct. Дополнительные преобразования могут поддерживаться и определяются поставщиком.
- Type Parameters:
T- тип класса, моделируемого этим объектом Class- Parameters:
-
columnIndex- первый столбец имеет номер 1, второй - 2 и т.д. -
type- класс, представляющий тип данных Java, в который нужно преобразовать указанный столбец. - Returns:
- экземпляр
type, содержащий значение столбца - Throws:
-
SQLException- если преобразование не поддерживается, тип null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.7
getObject
<T> T getObject(String columnLabel, Class<T> type) throws SQLException
Извлекает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует его из SQL типа столбца в запрошенный тип данных Java, если преобразование поддерживается. Если преобразование не поддерживается или для типа указан null, выбрасывается исключение SQLException.
Как минимум, реализация должна поддерживать преобразования, определённые в Приложении B, Таблица B-3, и преобразование соответствующих пользовательских SQL типов в тип Java, реализующий интерфейс SQLData или Struct. Дополнительные преобразования могут поддерживаться и определяются поставщиком.
- Type Parameters:
T- тип класса, моделируемого этим объектом Class- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
type- класс, представляющий тип данных Java, в который нужно преобразовать указанный столбец. - Returns:
- экземпляр
type, содержащий значение столбца - Throws:
-
SQLException- если преобразование не поддерживается, тип null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.7
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. Если второй аргумент — объект типа InputStream, то поток должен содержать количество байт, указанное параметром scaleOrLength. Если второй аргумент — объект типа Reader, то читатель должен содержать количество символов, указанное параметром scaleOrLength. Если эти условия не соблюдаются, драйвер сгенерирует исключение SQLException при выполнении запроса.
По умолчанию, реализация будет выбрасывать исключение SQLFeatureNotSupportedException
- Parameters:
-
columnIndex- номер столбца (первый - 1, второй - 2 и т.д.). -
x- новое значение столбца. -
targetSqlType- SQL тип, который будет отправлен в базу данных. -
scaleOrLength- для объектов типаjava.math.BigDecimal, это число знаков после запятой. Для типов Java-объектовInputStreamиReader, это длина данных в потоке или ридере. Для всех остальных типов, это значение игнорируется. - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов являетсяCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType - Since:
- 1.8
- See Also:
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType, int scaleOrLength) throws SQLException
Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. Если второй аргумент — объект типа InputStream, то поток должен содержать количество байт, указанное параметром scaleOrLength. Если второй аргумент — объект типа Reader, то читатель должен содержать количество символов, указанное параметром scaleOrLength. Если эти условия не соблюдаются, драйвер сгенерирует исключение SQLException при выполнении запроса.
По умолчанию, реализация будет выбрасывать исключение SQLFeatureNotSupportedException
- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца. -
targetSqlType- SQL тип, который будет отправлен в базу данных. -
scaleOrLength- для объектов типаjava.math.BigDecimal, это число знаков после запятой. Для типов Java-объектовInputStreamиReader, это длина данных в потоке или ридере. Для всех остальных типов, это значение игнорируется. - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов являетсяCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType - Since:
- 1.8
- See Also:
updateObject
default void updateObject(int columnIndex, Object x, SQLType targetSqlType) throws SQLException
Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. По умолчанию, реализация будет выбрасывать исключение SQLFeatureNotSupportedException
- Parameters:
-
columnIndex- номер столбца (первый - 1, второй - 2 и т.д.). -
x- новое значение столбца. -
targetSqlType- SQL тип, который будет отправлен в базу данных. - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов являетсяCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType - Since:
- 1.8
- See Also:
updateObject
default void updateObject(String columnLabel, Object x, SQLType targetSqlType) throws SQLException
Object. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. Реализация по умолчанию выбросит SQLFeatureNotSupportedException
- Параметры:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка — это имя столбца -
x- новое значение столбца -
targetSqlType- тип SQL, который будет отправлен в базу данных - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейность набора результатовCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType - С тех пор:
- 1.8
- См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql/java/sql/ResultSet.html
getBigDecimal(int columnIndex)илиgetBigDecimal(String columnLabel)