Интерфейс 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) были добавлены методы обновлений. Замечания, касающиеся параметров методов-getter, также относятся к параметрам методов обновления.
Методы обновления могут использоваться двумя способами:
- для обновления значения столбца в текущей строке. В прокручиваемом объекте
ResultSetкурсор может перемещаться назад и вперед, к абсолютному положению или к положению относительно текущей строки. Следующий фрагмент кода обновляет столбецNAMEв пятой строке объектаResultSetrs, а затем использует метод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.
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
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. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
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.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Возвращает:
- значение столбца; если значение равно SQL
NULL, возвращаемое значение равноfalse - Выбрасывает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getByte
byte getByte(int columnIndex) throws SQLException
ResultSet объекта в виде byte в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getShort
short getShort(int columnIndex) throws SQLException
ResultSet объекта в виде short в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getInt
int getInt(int columnIndex) throws SQLException
ResultSet объекта в виде int в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getLong
long getLong(int columnIndex) throws SQLException
ResultSet объекта в виде long в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getFloat
float getFloat(int columnIndex) throws SQLException
ResultSet объекта в виде float в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDouble
double getDouble(int columnIndex) throws SQLException
ResultSet объекта в виде double в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException
getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
ResultSet объекта в виде java.sql.BigDecimal в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. -
scale- количество цифр после десятичной точки - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод
getBytes
byte[] getBytes(int columnIndex) throws SQLException
ResultSet объекта в виде массива byte в языке программирования Java. Байты представляют собой сырые значения, возвращаемые драйвером.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDate
Date getDate(int columnIndex) throws SQLException
ResultSet объекта в виде объекта java.sql.Date в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTime
Time getTime(int columnIndex) throws SQLException
ResultSet объекта в виде объекта java.sql.Time в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTimestamp
Timestamp getTimestamp(int columnIndex) throws SQLException
ResultSet объекта в виде объекта java.sql.Timestamp в языке программирования Java.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getAsciiStream
InputStream getAsciiStream(int columnIndex) throws SQLException
ResultSet объекта в виде потока ASCII-символов. Значение затем может быть считывается из потока частями. Этот метод особенно подходит для извлечения больших LONGVARCHAR значений. JDBC драйвер выполнит необходимые преобразования из формата базы данных в ASCII. Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Также поток может вернуть 0 при вызове метода InputStream.available независимо от того, есть ли доступные данные или нет.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- поток ввода Java, который предоставляет значение столбца базы данных в виде потока символов ASCII с одним байтом; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getUnicodeStream
@Deprecated(since="1.2") InputStream getUnicodeStream(int columnIndex) throws SQLException
getCharacterStream вместо getUnicodeStream
ResultSet объекта в виде потока символов Unicode. Первый байт - старший байт, второй - младший байт. Значение затем может быть считывается из потока частями. Этот метод особенно подходит для извлечения больших LONGVARCHAR значений. JDBC драйвер выполнит необходимые преобразования из формата базы данных в Unicode. Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Также поток может вернуть 0 при вызове метода InputStream.available независимо от того, есть ли доступные данные или нет.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и так далее. - Возвращает:
- поток ввода Java, который предоставляет значение столбца базы данных в виде потока символов Unicode с двумя байтами; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод
getBinaryStream
InputStream getBinaryStream(int columnIndex) throws SQLException
ResultSet объекта в виде потока неинтерпретированных байтов. Затем значение можно читать из потока частями. Этот метод особенно подходит для извлечения больших LONGVARBINARY значений. Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-геттера неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода InputStream.available, независимо от наличия данных.
- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т. д. - Returns:
- входной поток Java, который предоставляет значение столбца базы данных в виде потока неинтерпретированных байтов; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getString
String getString(String columnLabel) throws SQLException
ResultSet объекта в виде строкового значения в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getBoolean
boolean getBoolean(String columnLabel) throws SQLException
ResultSet объекта в виде логического значения в языке программирования Java. Если тип данных указанного столбца CHAR или VARCHAR и содержит "0", или тип данных BIT, TINYINT, SMALLINT, INTEGER или BIGINT и содержит 0, возвращается значение false. Если тип данных указанного столбца CHAR или VARCHAR и содержит "1", или тип данных BIT, TINYINT, SMALLINT, INTEGER или BIGINT и содержит 1, возвращается значение true.
- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноfalse - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getByte
byte getByte(String columnLabel) throws SQLException
ResultSet объекта в виде байта в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getShort
short getShort(String columnLabel) throws SQLException
ResultSet объекта в виде короткого целого числа в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getInt
int getInt(String columnLabel) throws SQLException
ResultSet объекта в виде целого числа в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getLong
long getLong(String columnLabel) throws SQLException
ResultSet объекта в виде длинного целого числа в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getFloat
float getFloat(String columnLabel) throws SQLException
ResultSet объекта в виде числа с плавающей точкой в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDouble
double getDouble(String columnLabel) throws SQLException
ResultSet объекта в виде двойного числа с плавающей точкой в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равно0 - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getBigDecimal
@Deprecated(since="1.2") BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException
getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
ResultSet объекта в виде числа с плавающей точкой в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца -
scale- количество цифр справа от десятичной точки - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод
getBytes
byte[] getBytes(String columnLabel) throws SQLException
ResultSet объекта в виде массива байтов в языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDate
Date getDate(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.sql.Date в языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, меткой является имя столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTime
Time getTime(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.sql.Time языка программирования Java.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getTimestamp
Timestamp getTimestamp(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.sql.Timestamp языка программирования Java.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Returns:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getAsciiStream
InputStream getAsciiStream(String columnLabel) throws SQLException
ResultSet объекта в виде потока ASCII-символов. Значение затем может быть прочитано по частям из потока. Этот метод особенно подходит для получения больших значений LONGVARCHAR. Драйвер JDBC выполнит все необходимые преобразования из формата базы данных в ASCII. Примечание: Все данные в возвращаемом потоке должны быть прочитаны перед получением значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода available, независимо от того, доступны ли данные.
- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, то метка является именем столбца - Returns:
- входной поток Java, который предоставляет значение столбца базы данных в виде потока символов ASCII с одним байтом. Если значение является SQL
NULL, возвращаемое значение равноnull. - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getUnicodeStream
@Deprecated(since="1.2") InputStream getUnicodeStream(String columnLabel) throws SQLException
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 таблица результатов извлекается через именованный курсор. Текущую строку набора результатов можно обновлять или удалять с помощью операторов positioned update/delete, которые ссылаются на имя курсора. Чтобы убедиться, что курсор имеет соответствующий уровень изоляции для поддержки обновления, оператор курсора SELECT должен иметь вид SELECT FOR UPDATE. Если FOR UPDATE опущено, обновление по позиции может не выполниться.
API JDBC поддерживает эту функцию SQL, предоставляя имя SQL-курсора, используемого объектом ResultSet. Текущая строка объекта ResultSet также является текущей строкой этого SQL-курсора.
- Returns:
- SQL-имя курсора этого объекта
ResultSet - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод
getMetaData
ResultSetMetaData getMetaData() throws SQLException
ResultSet.- Returns:
- описание столбцов этого объекта
ResultSet - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getObject
Object getObject(int columnIndex) throws SQLException
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Object языка программирования Java.
Этот метод вернет значение заданного столбца как объект Java. Тип объекта Java будет соответствовать типу объекта Java по умолчанию, соответствующему типу SQL столбца, следуя сопоставлению встроенных типов, указанных в спецификации JDBC. Если значение является SQL NULL, драйвер возвращает Java null.
Этот метод также можно использовать для чтения абстрактных данных, специфичных для базы данных. В API JDBC 2.0 поведение метода getObject расширено для материализации данных типов SQL, определенных пользователем.
Если Connection.getTypeMap не вызывает исключение SQLFeatureNotSupportedException, то при наличии в столбце структурированного или отличительного значения поведение этого метода такое же, как и при вызове: getObject(columnIndex,
this.getStatement().getConnection().getTypeMap()). Если Connection.getTypeMap вызывает исключение SQLFeatureNotSupportedException, то структурированные значения не поддерживаются, а отличительные значения сопоставляются с классом Java по умолчанию, определяемым базовым типом SQL типа DISTINCT.
- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. - Returns:
- объект
java.lang.Object, содержащий значение столбца - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов
getObject
Object getObject(String columnLabel) throws SQLException
Получает значение указанного столбца в текущей строке этого ResultSet объекта в качестве Object объекта языка программирования Java.
Этот метод вернёт значение заданного столбца в виде объекта Java. Тип объекта Java будет соответствовать по умолчанию типу объекта Java, соответствующему SQL типу столбца, следуя сопоставлению для встроенных типов, указанных в спецификации JDBC. Если значение является SQL NULL, драйвер возвращает Java null.
Этот метод также может использоваться для чтения абстрактных типов данных, специфичных для базы данных.
В API JDBC 2.0 поведение метода getObject расширено для материализации данных SQL типов, определённых пользователем. Когда столбец содержит структурированное или раздельное значение, поведение этого метода такое же, как при вызове: getObject(columnIndex,
this.getStatement().getConnection().getTypeMap()).
- Parameters:
-
columnLabel- метка для столбца, указанного с помощью SQL-заявки AS. Если SQL-заявка AS не была указана, то метка - это имя столбца - Returns:
- объект
java.lang.Object, содержащий значение столбца - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
findColumn
int findColumn(String columnLabel) throws SQLException
ResultSet с его индексом столбца ResultSet.- Parameters:
-
columnLabel- метка для столбца, указанного с помощью SQL-заявки AS. Если SQL-заявка AS не была указана, то метка - это имя столбца - Returns:
- индекс столбца заданного имени столбца
- Throws:
-
SQLException- если объектResultSetне содержит столбец с меткойcolumnLabel, произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getCharacterStream
Reader getCharacterStream(int columnIndex) throws SQLException
ResultSet объекта в виде объекта java.io.Reader.- Parameters:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. - Returns:
- объект
java.io.Reader, содержащий значение столбца; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java. - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - Since:
- 1.2
getCharacterStream
Reader getCharacterStream(String columnLabel) throws SQLException
ResultSet объекта в виде объекта java.io.Reader.- Parameters:
-
columnLabel- метка для столбца, указанного с помощью SQL-заявки AS. Если SQL-заявка AS не была указана, то метка - это имя столбца - Returns:
- объект
java.io.Reader, содержащий значение столбца; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - Since:
- 1.2
getBigDecimal
BigDecimal getBigDecimal(int columnIndex) throws SQLException
ResultSet объекта в виде java.math.BigDecimal с полной точностью.- Parameters:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. - Returns:
- значение столбца (полная точность); если значение является SQL
NULL, возвращаемое значение —nullна языке программирования Java. - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - Since:
- 1.2
getBigDecimal
BigDecimal getBigDecimal(String columnLabel) throws SQLException
ResultSet объекта в виде java.math.BigDecimal с полной точностью.- Parameters:
-
columnLabel- метка для столбца, указанного с помощью SQL-заявки AS. Если SQL-заявка AS не была указана, то метка - это имя столбца - Returns:
- значение столбца (полная точность); если значение является SQL
NULL, возвращаемое значение —nullна языке программирования Java. - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - Since:
- 1.2
isBeforeFirst
boolean isBeforeFirst() throws SQLException
ResultSet объекте. Примечание: Поддержка метода isBeforeFirst необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Returns:
-
true, если курсор находится перед первой строкой;falseв противном случае или набор результатов пуст - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
isAfterLast
boolean isAfterLast() throws SQLException
ResultSet объекте. Примечание: Поддержка метода isAfterLast необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Returns:
-
true, если курсор находится после последней строки;falseв противном случае или набор результатов пуст - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
isFirst
boolean isFirst() throws SQLException
ResultSet объекта. Примечание: Поддержка метода isFirst необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Returns:
-
true, если курсор находится на первой строке;falseв противном случае - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
isLast
boolean isLast() throws SQLException
ResultSet объекта. Примечание: Вызов метода isLast может быть дорогостоящим, так как JDBC-драйверу может потребоваться загрузить следующую строку, чтобы определить, является ли текущая строка последней в наборе результатов. Примечание: Поддержка метода isLast необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Returns:
-
true, если курсор находится на последней строке;falseв противном случае - Throws:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
beforeFirst
void beforeFirst() throws SQLException
ResultSet объекта, перед первой строкой. Этот метод не имеет эффекта, если набор результатов пуст.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
afterLast
void afterLast() throws SQLException
ResultSet объекта, сразу после последней строки. Этот метод не имеет эффекта, если набор результатов пуст.- Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
first
boolean first() throws SQLException
ResultSet объекте.- Returns:
-
true, если курсор находится на корректной строке;falseесли в наборе результатов нет строк - Throws:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.2
last
boolean last() throws SQLException
ResultSet.- Возвращает:
-
true, если курсор находится на корректной строке;false, если в наборе результатов нет строк - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов -TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getRow
int getRow() throws SQLException
Примечание: Поддержка метода 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
обновитьСтроку
void updateString(int columnIndex, String x) throws SQLException
String. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьБайты
void updateBytes(int columnIndex, byte[] x) throws SQLException
byte. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьДату
void updateDate(int columnIndex, Date x) throws SQLException
java.sql.Date. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьВремя
void updateTime(int columnIndex, Time x) throws SQLException
java.sql.Time. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьОтметкуВремени
void updateTimestamp(int columnIndex, Timestamp x) throws SQLException
java.sql.Timestamp. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьПотокASCII
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
обновитьБинарныйПоток
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
обновитьПотокСимволов
void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьОбъект
void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException
Object. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных. Если второй аргумент — InputStream, то поток должен содержать количество байтов, указанное параметром scaleOrLength. Если второй аргумент — Reader, то поток должен содержать количество символов, указанное параметром scaleOrLength. В противном случае драйвер сгенерирует ошибку SQLException при выполнении запроса.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца -
scaleOrLength- для объектов типаjava.math.BigDecimal, это количество цифр после запятой. Для типов Java ObjectInputStreamиReader, это длина данных в потоке или потоке символов. Для всех других типов это значение будет проигнорировано. - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
обновитьОбъект
void updateObject(int columnIndex, Object x) throws SQLException
Object. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер одновременного доступа к набору результатовCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateNull
void updateNull(String columnLabel) throws SQLException
null. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateBoolean
void updateBoolean(String columnLabel, boolean x) throws SQLException
boolean. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateByte
void updateByte(String columnLabel, byte x) throws SQLException
byte. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateShort
void updateShort(String columnLabel, short x) throws SQLException
short. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateInt
void updateInt(String columnLabel, int x) throws SQLException
int. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateLong
void updateLong(String columnLabel, long x) throws SQLException
long. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateFloat
void updateFloat(String columnLabel, float x) throws SQLException
float. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateDouble
void updateDouble(String columnLabel, double x) throws SQLException
double. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateBigDecimal
void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException
java.sql.BigDecimal. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateString
void updateString(String columnLabel, String x) throws SQLException
String. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень параллельности набора результатов —CONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateBytes
void updateBytes(String columnLabel, byte[] x) throws SQLException
updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateDate
void updateDate(String columnLabel, Date x) throws SQLException
java.sql.Date. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateTime
void updateTime(String columnLabel, Time x) throws SQLException
java.sql.Time. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateTimestamp
void updateTimestamp(String columnLabel, Timestamp x) throws SQLException
java.sql.Timestamp. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateAsciiStream
void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
updateBinaryStream
void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException
updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLYили метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 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. Метод обновления данных должен быть вызван перед тем, как можно будет вызвать метод получения данных для значения столбца.- 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 структурированного или раздельного типа, который извлекается.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
map- объектjava.util.Map, содержащий отображение имён SQL типов на классы в языке программирования Java - Returns:
Objectв языке программирования Java, представляющий SQL значение- Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
getRef
Ref getRef(int columnIndex) throws SQLException
ResultSet объекта как объект Ref в языке программирования Java.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- объект
Ref, представляющий SQL значениеREF - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
getBlob
Blob getBlob(int columnIndex) throws SQLException
ResultSet объекта как объект Blob в языке программирования Java.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- объект
Blob, представляющий SQL значениеBLOBв указанном столбце - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
getClob
Clob getClob(int columnIndex) throws SQLException
ResultSet объекта как объект Clob в языке программирования Java.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- объект
Clob, представляющий SQL значениеCLOBв указанном столбце - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
getArray
Array getArray(int columnIndex) throws SQLException
ResultSet объекта как объект Array в языке программирования Java.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Returns:
- объект
Array, представляющий SQL значениеARRAYв указанном столбце - Throws:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.2
getObject
Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException
ResultSet в качестве объекта 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; если значение является SQL-NULL, возвращаемое значение —nullязыка программирования Java - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getDate
Date getDate(String columnLabel, Calendar cal) throws SQLException
ResultSet в качестве объекта java.sql.Date языка программирования Java. Этот метод использует заданный календарь для построения соответствующего значения миллисекунд для даты, если базовая база данных не хранит информацию о часовом поясе.- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, то метка является именем столбца -
cal- объектjava.util.Calendarдля построения даты - Возвращает:
- значение столбца в виде объекта
java.sql.Date; если значение является SQL-NULL, возвращаемое значение —nullязыка программирования Java - Исключение:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getTime
Time getTime(int columnIndex, Calendar cal) throws SQLException
ResultSet в качестве объекта java.sql.Time языка программирования Java. Этот метод использует заданный календарь для построения соответствующего значения миллисекунд для времени, если базовая база данных не хранит информацию о часовом поясе.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
cal- объектjava.util.Calendarдля построения времени - Возвращает:
- значение столбца в виде объекта
java.sql.Time; если значение является SQL-NULL, возвращаемое значение —nullязыка программирования Java - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getTime
Time getTime(String columnLabel, Calendar cal) throws SQLException
ResultSet в качестве объекта java.sql.Time языка программирования Java. Этот метод использует заданный календарь для построения соответствующего значения миллисекунд для времени, если базовая база данных не хранит информацию о часовом поясе.- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, то метка является именем столбца -
cal- объектjava.util.Calendarдля построения времени - Возвращает:
- значение столбца в виде объекта
java.sql.Time; если значение является SQL-NULL, возвращаемое значение —nullязыка программирования Java - Исключение:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getTimestamp
Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException
ResultSet в качестве объекта java.sql.Timestamp языка программирования Java. Этот метод использует заданный календарь для построения соответствующего значения миллисекунд для временной метки, если базовая база данных не хранит информацию о часовом поясе.- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
cal- объектjava.util.Calendarдля построения временной метки - Возвращает:
- значение столбца в виде объекта
java.sql.Timestamp; если значение является SQL-NULL, возвращаемое значение —nullязыка программирования Java - Исключение:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getTimestamp
Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException
ResultSet в качестве объекта java.sql.Timestamp на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для временной метки, если базовая база данных не хранит информацию о часовом поясе.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца -
cal- объектjava.util.Calendar, используемый для построения даты - Returns:
- значение столбца в виде объекта
java.sql.Timestamp; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Throws:
-
SQLException- если columnLabel недействителен или произошла ошибка доступа к базе данных, или этот метод вызван для закрытого набора результатов - Since:
- 1.2
getURL
URL getURL(int columnIndex) throws SQLException
ResultSet в качестве объекта java.net.URL на языке программирования Java.- Parameters:
-
columnIndex- индекс столбца (1 — первый, 2 — второй и т. д.) - Returns:
- значение столбца в виде объекта
java.net.URL; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или URL некорректен -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.4
getURL
URL getURL(String columnLabel) throws SQLException
ResultSet в качестве объекта java.net.URL на языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца - Returns:
- значение столбца в виде объекта
java.net.URL; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или URL некорректен -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.4
updateRef
void updateRef(int columnIndex, Ref x) throws SQLException
java.sql.Ref. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.4
updateRef
void updateRef(String columnLabel, Ref x) throws SQLException
java.sql.Ref. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnLabel- метка столбца, указанная в предложении SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца -
x- новое значение столбца - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.4
updateBlob
void updateBlob(int columnIndex, Blob x) throws SQLException
java.sql.Blob. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 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 объект. Объект набора результатов считается закрытым, если на нём был вызван метод close, или если он был закрыт автоматически.- Returns:
- true, если этот
ResultSetобъект закрыт; false, если он всё ещё открыт - Throws:
-
SQLException- если произошла ошибка доступа к базе данных - Since:
- 1.6
updateNString
void updateNString(int columnIndex, String nString) throws SQLException
String. Предназначено для обновления NCHAR, NVARCHAR и LONGNVARCHAR столбцов. Методы обновления значений столбцов используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления значений столбцов не обновляют базу данных напрямую; для обновления базы данных необходимо вызвать методы updateRow или insertRow.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и так далее. -
nString- значение для обновления столбца - Throws:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов; конкурентность набора результатовCONCUR_READ_ONLYили произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
updateNString
void updateNString(String columnLabel, String nString) throws SQLException
String. Предназначено для обновления NCHAR, NVARCHAR и LONGNVARCHAR столбцов. Методы обновления значений столбцов используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления значений столбцов не обновляют базу данных напрямую; для обновления базы данных необходимо вызвать методы updateRow или insertRow.- Parameters:
-
columnLabel- метка столбца, заданная в SQL-команде AS. Если в SQL-команде AS не указано, метка — имя столбца. -
nString- значение для обновления столбца - Throws:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов; конкурентность набора результатовCONCUR_READ_ONLYили произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
updateNClob
void updateNClob(int columnIndex, NClob nClob) throws SQLException
java.sql.NClob. Методы обновления значений столбцов используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления значений столбцов не обновляют базу данных напрямую; для обновления базы данных необходимо вызвать методы updateRow или insertRow.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и так далее. -
nClob- значение для обновления столбца - Throws:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатовCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
updateNClob
void updateNClob(String columnLabel, NClob nClob) throws SQLException
java.sql.NClob. Методы обновления значений столбцов используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления значений столбцов не обновляют базу данных напрямую; для обновления базы данных необходимо вызвать методы updateRow или insertRow.- Parameters:
-
columnLabel- метка столбца, заданная в SQL-команде AS. Если в SQL-команде AS не указано, метка — имя столбца. -
nClob- значение для обновления столбца - Throws:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатовCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
getNClob
NClob getNClob(int columnIndex) throws SQLException
ResultSet объекта в виде объекта NClob на языке программирования Java.- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и так далее. - Returns:
- объект
NClob, представляющий значение SQLNCLOBв указанном столбце - Throws:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов или произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
getNClob
NClob getNClob(String columnLabel) throws SQLException
ResultSet объекта в качестве объекта NClob на языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца - Returns:
- объект
NClob, представляющий значение SQLNCLOBв указанном столбце - Throws:
-
SQLException- если columnLabel недопустим; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод вызывается для закрытого набора результатов или если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
getSQLXML
SQLXML getSQLXML(int columnIndex) throws SQLException
ResultSet в качестве объекта java.sql.SQLXML на языке программирования Java.- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй — 2 и т. д. - Returns:
- объект
SQLXML, который отображает значениеSQL XML - Throws:
-
SQLException- если columnIndex недопустим; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
getSQLXML
SQLXML getSQLXML(String columnLabel) throws SQLException
ResultSet в качестве объекта java.sql.SQLXML на языке программирования Java.- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, то метка — это имя столбца - Returns:
- объект
SQLXML, который отображает значениеSQL XML - Throws:
-
SQLException- если columnLabel недопустим; если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 1.6
updateSQLXML
void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException
java.sql.SQLXML. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.- Parameters:
-
columnIndex- первый столбец имеет значение 1, второй — 2 и т. д. -
xmlObject- значение для столбца, который необходимо обновить - Throws:
-
SQLException- если columnIndex недопустим; если произошла ошибка доступа к базе данных; этот метод был вызван для закрытого набора результатов;java.xml.transform.Result,WriterилиOutputStreamне был закрыт для объектаSQLXML; если произошла ошибка обработки значения XML или конкурентность набора результатов имеет значениеCONCUR_READ_ONLY. МетодgetCauseисключения может предоставить более подробное исключение, например, если поток не содержит допустимого XML. -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - Since:
- 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
обновитьПотокNСимволов
void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
NCHAR,NVARCHAR и LONGNVARCHAR столбцов. Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-запросе с помощью AS. Если SQL-запрос AS не был указан, метка является именем столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьПотокASCII
void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьПотокБинарныхДанных
void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьПотокСимволов
void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьПотокASCII
void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-запросе с помощью AS. Если SQL-запрос AS не был указан, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьПотокБинарныхДанных
void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-запросе с помощью AS. Если SQL-запрос AS не был указан, метка является именем столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьПотокСимволов
void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-запросе с помощью AS. Если SQL-запрос AS не был указан, метка является именем столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьBLOB
void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
inputStream- Объект, содержащий данные для установки значения параметра. -
length- количество байтов в данных параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
обновитьBLOB
void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException
Методы апдейтера используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейтера не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-запросе с помощью AS. Если SQL-запрос AS не был указан, метка является именем столбца -
inputStream- Объект, содержащий данные для установки значения параметра. -
length- количество байтов в данных параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конвейер набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.6
updateClob
void updateClob(int columnIndex, Reader reader, long length) throws SQLException
Reader, длина которого равна заданному числу символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может оказаться более практичным отправить его через объект java.io.Reader. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnIndex- первый столбец имеет индекс 1, второй - 2 и т.д. -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в параметрах данных. - Throws:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - Since:
- 1.6
updateClob
void updateClob(String columnLabel, Reader reader, long length) throws SQLException
Reader, длина которого равна заданному числу символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может оказаться более практичным отправить его через объект java.io.Reader. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnLabel- метка столбца, заданная с помощью SQL-определения AS. Если SQL-определения AS не указано, то меткой служит имя столбца. -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатов являетсяCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - Since:
- 1.6
updateNClob
void updateNClob(int columnIndex, Reader reader, long length) throws SQLException
Reader, длина которого равна заданному числу символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может оказаться более практичным отправить его через объект java.io.Reader. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnIndex- номер столбца (первый столбец - 1, второй - 2 и т.д.). -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Throws:
-
SQLException- если columnIndex недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкуретность набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - Since:
- 1.6
updateNClob
void updateNClob(String columnLabel, Reader reader, long length) throws SQLException
Reader, длина которого равна заданному числу символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может оказаться более практичным отправить его через объект java.io.Reader. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Parameters:
-
columnLabel- метка столбца, заданная с помощью SQL-определения AS. Если SQL-определения AS не указано, то меткой служит имя столбца. -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Throws:
-
SQLException- если columnLabel недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкуретность набора результатов являетсяCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает данный метод - Since:
- 1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex, Reader x) throws SQLException
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
обновитьБинарныйПоток
void updateBinaryStream(int columnIndex, InputStream x) throws SQLException
Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateBinaryStream, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
обновитьСимвольныйПоток
void updateCharacterStream(int columnIndex, Reader x) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateCharacterStream, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
обновитьПотокAscii
void updateAsciiStream(String columnLabel, InputStream x) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateAsciiStream, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnLabel- метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
обновитьБинарныйПоток
void updateBinaryStream(String columnLabel, InputStream x) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateBinaryStream, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnLabel- метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
обновитьСимвольныйПоток
void updateCharacterStream(String columnLabel, Reader reader) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateCharacterStream, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnLabel- метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, метка — это имя столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
обновитьБлоб
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
обновитьБлоб
void updateBlob(String columnLabel, InputStream inputStream) throws SQLException
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateBlob, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnLabel- метка столбца, указанная с помощью предложения SQL AS. Если предложение SQL AS не указано, метка — это имя столбца -
inputStream- Объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
обновитьCLOB
void updateClob(int columnIndex, Reader reader) throws SQLException
Reader. Данные будут читаться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит необходимую конвертацию из UNICODE в формат символов базы данных. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateClob, принимающей параметр длины, быть более эффективным.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй — 2 и т. д. -
reader- Объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.6
updateClob
void updateClob(String columnLabel, Reader reader) throws SQLException
Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит любые необходимые преобразования из UNICODE в формат символов базы данных. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateClob с параметром длины быть более эффективным.
- Parameters:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
reader- Объект, содержащий данные для задания значения параметра. - Throws:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатов равнаCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 1.6
updateNClob
void updateNClob(int columnIndex, Reader reader) throws SQLException
Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. Драйвер JDBC выполнит любые необходимые преобразования из UNICODE в формат символов базы данных. Методы обновляющего объекта используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющего объекта не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации драйвера JDBC, чтобы определить, может ли использование версии updateNClob с параметром длины быть более эффективным.
- Parameters:
-
columnIndex- номер столбца (первый - 1, второй - 2 и т.д.) -
reader- Объект, содержащий данные для задания значения параметра. - Throws:
-
SQLException- если columnIndex недействителен; если драйвер не поддерживает наборы национальных символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод вызывается для закрытого набора результатов, если произошла ошибка доступа к базе данных или конкурентность набора результатов равнаCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - Since:
- 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 ObjectInputStreamи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 ObjectInputStreamи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.
- Parameters:
-
columnLabel- метка столбца, указанная в инструкции SQL AS. Если инструкция SQL AS не была указана, то метка — это имя столбца. -
x- новое значение столбца -
targetSqlType- тип SQL, который будет отправлен в базу данных - Throws:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; если параллельность набора результатовCONCUR_READ_ONLYили если этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод; если драйвер JDBC не поддерживает указанный targetSqlType - Since:
- 1.8
- See Also:
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.sql/java/sql/ResultSet.html
getBigDecimal(int columnIndex)илиgetBigDecimal(String columnLabel)