Интерфейс ResultSet
- Все суперинтерфейсы:
- AutoCloseable, Wrapper
- Все известные подинтерфейсы:
- CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, RowSet, SyncResolver, WebRowSet
public interface ResultSet extends Wrapper, AutoCloseable
Таблица данных, представляющая результат запроса к базе данных, обычно генерируемая выполнением оператора запроса к базе данных.
Объект ResultSet поддерживает указатель, указывающий на текущую строку данных. Изначально указатель находится перед первой строкой. Метод next перемещает указатель к следующей строке, и поскольку он возвращает false, когда больше нет строк в объекте ResultSet, его можно использовать в цикле while для итерации по результатам запроса.
Стандартный объект ResultSet не обновляемый и имеет указатель, который перемещается только вперед. Таким образом, вы можете проитерироваться по нему только один раз и только от первой строки до последней. Возможны создание объектов ResultSet, которые являются прокручиваемыми и/или обновляемыми. Следующий фрагмент кода, в котором con является допустимым объектом Connection, демонстрирует как создать результат запроса, который является прокручиваемым и нечувствительным к обновлениям другими, и который является обновляемым. См. поля ResultSet для других вариантов.
Statement stmt = con.createStatement(
ResultSet.TYPE_SCROLL_INSENSITIVE,
ResultSet.CONCUR_UPDATABLE);
ResultSet rs = stmt.executeQuery("SELECT a, b FROM TABLE2");
// rs will be scrollable, will not show changes made by others,
// and will be updatable Интерфейс ResultSet предоставляет методы-получатели (getBoolean, getLong, и т. д.) для извлечения значений столбцов из текущей строки. Значения могут быть извлечены с помощью либо индекса столбца, либо имени столбца. В общем случае, использование индекса столбца будет более эффективным. Столбцы нумеруются с 1. Для максимальной переносимости, столбцы результата запроса в каждой строке должны читаться слева направо, и каждый столбец должен быть прочитан только один раз. Для методов-получателей драйвер JDBC пытается преобразовать базовые данные в тип Java, указанный в методе-получателе, и возвращает подходящее значение Java. В спецификации JDBC есть таблица, отображающая допустимые сопоставления типов SQL с типами Java, которые могут использоваться методами-получателями ResultSet.
Имена столбцов, используемые в качестве входных данных для методов-получателей, нечувствительны к регистру. Когда метод-получатель вызывается с именем столбца, и несколько столбцов имеют одинаковое имя, будет возвращено значение первого соответствующего столбца. Вариант имени столбца предназначен для использования, когда имена столбцов используются в запросе SQL, который сгенерировал результат запроса. Для столбцов, которые НЕ явно указаны в запросе, лучше использовать номера столбцов. Если используются имена столбцов, программист должен позаботиться о том, чтобы они однозначно указывали на нужные столбцы, что можно гарантировать с помощью SQL-операторa AS.
В API JDBC 2.0 (Java™ 2 SDK, Standard Edition, версия 1.2) были добавлены набор методов обновлителей. Комментарии относительно параметров к методам-получателям также относятся к параметрам методов-обновлителей.
Методы-обновлители могут использоваться двумя способами:
- для обновления значения столбца в текущей строке. В прокручиваемом объекте
ResultSet, указатель может перемещаться назад и вперед, к абсолютной позиции или к позиции относительно текущей строки. Следующий фрагмент кода обновляет столбецNAMEв пятой строке объектаResultSetrsи затем использует методupdateRowдля обновления таблицы источника данных, из которойrsбыл получен.rs.absolute(5); // moves the cursor to the fifth row of rs rs.updateString("NAME", "AINSWORTH"); // updates the // NAME column of row 5 to be AINSWORTH rs.updateRow(); // updates the row in the data source - для вставки значений столбцов в строку вставки. Обновляемый объект
ResultSetимеет специальную строку, связанную с ним, которая служит зоной подготовки для построения строки для вставки. Следующий фрагмент кода перемещает указатель в строку вставки, строит строку из трех столбцов и вставляет ее вrsи в таблицу источника данных с помощью методаinsertRow.rs.moveToInsertRow(); // moves cursor to the insert row rs.updateString(1, "AINSWORTH"); // updates the // first column of the insert row to be AINSWORTH rs.updateInt(2,35); // updates the second column to be 35 rs.updateBoolean(3, true); // updates the third column to true rs.insertRow(); rs.moveToCurrentRow();
Объект ResultSet автоматически закрывается, когда закрывается объект Statement, который его сгенерировал, перевыполняется или используется для извлечения следующего результата из последовательности нескольких результатов.
Количество, типы и свойства столбцов объекта ResultSet предоставляются объектом ResultSetMetaData, возвращенным методом ResultSet.getMetaData.
- См. также:
-
Statement.executeQuery(java.lang.String),Statement.getResultSet(),ResultSetMetaData
Поля
| Модификатор и тип | Поле и описание |
|---|---|
static int |
CLOSE_CURSORS_AT_COMMIT Константа, указывающая, что открытые объекты |
static int |
CONCUR_READ_ONLY Константа, указывающая режим конкурентности для объекта |
static int |
CONCUR_UPDATABLE Константа, указывающая режим конкурентности для объекта |
static int |
FETCH_FORWARD Константа, указывающая, что строки в наборе результатов будут обрабатываться в прямом направлении; от первой к последней. |
static int |
FETCH_REVERSE Константа, указывающая, что строки в наборе результатов будут обрабатываться в обратном направлении; от последней к первой. |
static int |
FETCH_UNKNOWN Константа, указывающая, что порядок обработки строк в наборе результатов неизвестен. |
static int |
HOLD_CURSORS_OVER_COMMIT Константа, указывающая, что открытые объекты |
static int |
TYPE_FORWARD_ONLY Константа, указывающая тип для объекта |
static int |
TYPE_SCROLL_INSENSITIVE Константа, указывающая тип для объекта |
static int |
TYPE_SCROLL_SENSITIVE Константа, указывающая тип для объекта |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
boolean |
absolute(int row) Перемещает курсор к указанной строке в этом объекте |
void |
afterLast() Перемещает курсор в конец этого объекта |
void |
beforeFirst() Перемещает курсор в начало этого объекта |
void |
cancelRowUpdates() Отменяет обновления, внесенные в текущую строку в этом объекте |
void |
clearWarnings() Очищает все предупреждения, сообщенные об этом объекте |
void |
close() Освобождает базу данных и ресурсы JDBC этого объекта |
void |
deleteRow() Удаляет текущую строку из этого объекта |
int |
findColumn(String columnLabel) Сопоставляет заданную метку столбца |
boolean |
first() Перемещает курсор к первой строке в этом объекте |
Array |
getArray(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
Array |
getArray(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
InputStream |
getAsciiStream(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
InputStream |
getAsciiStream(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
BigDecimal |
getBigDecimal(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
BigDecimal |
getBigDecimal(int columnIndex,
int scale) Устарело. Используйте |
BigDecimal |
getBigDecimal(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
BigDecimal |
getBigDecimal(String columnLabel,
int scale) Устарело. Используйте |
InputStream |
getBinaryStream(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
InputStream |
getBinaryStream(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
Blob |
getBlob(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
Blob |
getBlob(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
boolean |
getBoolean(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
boolean |
getBoolean(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
byte |
getByte(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
byte |
getByte(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
byte[] |
getBytes(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
byte[] |
getBytes(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
Reader |
getCharacterStream(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
Reader |
getCharacterStream(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
Clob |
getClob(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
Clob |
getClob(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
int |
getConcurrency() Возвращает режим конкурентности этого объекта |
String |
getCursorName() Возвращает имя SQL-курсора, используемого этим объектом |
Date |
getDate(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
Date |
getDate(int columnIndex,
Calendar cal) Возвращает значение указанного столбца в текущей строке этого объекта |
Date |
getDate(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
Date |
getDate(String columnLabel,
Calendar cal) Возвращает значение указанного столбца в текущей строке этого объекта |
double |
getDouble(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
double |
getDouble(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
int |
getFetchDirection() Возвращает направление извлечения для этого объекта |
int |
getFetchSize() Возвращает размер извлечения для этого объекта |
float |
getFloat(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
float |
getFloat(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
int |
getHoldability() Возвращает режим удерживания этого объекта |
int |
getInt(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
int |
getInt(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
long |
getLong(int columnIndex) Возвращает значение указанного столбца в текущей строке этого объекта |
long |
getLong(String columnLabel) Возвращает значение указанного столбца в текущей строке этого объекта |
ResultSetMetaData |
getMetaData() Возвращает количество, типы и свойства столбцов этого объекта |
Reader |
getNCharacterStream(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
Reader |
getNCharacterStream(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
NClob |
getNClob(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
NClob |
getNClob(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
String |
getNString(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
String |
getNString(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
Object |
getObject(int columnIndex) Получает значение указанного столбца в текущей строке этого объекта |
<T> T |
getObject(int columnIndex,
Class<T> type) Извлекает значение указанного столбца в текущей строке этого объекта |
Object |
getObject(int columnIndex,
Map<String,Class<?>> map) Извлекает значение указанного столбца в текущей строке этого объекта |
Object |
getObject(String columnLabel) Получает значение указанного столбца в текущей строке этого объекта |
<T> T |
getObject(String columnLabel,
Class<T> type) Извлекает значение указанного столбца в текущей строке этого объекта |
Object |
getObject(String columnLabel,
Map<String,Class<?>> map) Извлекает значение указанного столбца в текущей строке этого объекта |
Ref |
getRef(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
Ref |
getRef(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
int |
getRow() Извлекает номер текущей строки. |
RowId |
getRowId(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
RowId |
getRowId(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
short |
getShort(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
short |
getShort(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
SQLXML |
getSQLXML(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
SQLXML |
getSQLXML(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
Statement |
getStatement() Извлекает объект |
String |
getString(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
String |
getString(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
Time |
getTime(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
Time |
getTime(int columnIndex,
Calendar cal) Извлекает значение указанного столбца в текущей строке этого объекта |
Time |
getTime(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
Time |
getTime(String columnLabel,
Calendar cal) Извлекает значение указанного столбца в текущей строке этого объекта |
Timestamp |
getTimestamp(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
Timestamp |
getTimestamp(int columnIndex,
Calendar cal) Извлекает значение указанного столбца в текущей строке этого объекта |
Timestamp |
getTimestamp(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
Timestamp |
getTimestamp(String columnLabel,
Calendar cal) Извлекает значение указанного столбца в текущей строке этого объекта |
int |
getType() Извлекает тип объекта |
InputStream |
getUnicodeStream(int columnIndex) Устарело. используйте |
InputStream |
getUnicodeStream(String columnLabel) Устарело. используйте |
URL |
getURL(int columnIndex) Извлекает значение указанного столбца в текущей строке этого объекта |
URL |
getURL(String columnLabel) Извлекает значение указанного столбца в текущей строке этого объекта |
SQLWarning |
getWarnings() Извлекает первое сообщение об ошибке, сгенерированное вызовами на этот объект |
void |
insertRow() Вставляет содержимое строки вставки в этот объект |
boolean |
isAfterLast() Извлекает, находится ли курсор после последней строки в этом объекте |
boolean |
isBeforeFirst() Извлекает, находится ли курсор перед первой строкой в этом объекте |
boolean |
isClosed() Извлекает, был ли закрыт этот объект |
boolean |
isFirst() Извлекает, находится ли курсор на первой строке объекта |
boolean |
isLast() Извлекает, находится ли курсор на последней строке объекта |
boolean |
last() Перемещает курсор на последнюю строку в объекте |
void |
moveToCurrentRow() Перемещает курсор к сохранённой позиции курсора, обычно к текущей строке. |
void |
moveToInsertRow() Перемещает курсор на строку вставки. |
boolean |
next() Перемещает курсор вперёд на одну строку от его текущей позиции. |
boolean |
previous() Перемещает курсор к предыдущей строке в этом объекте |
void |
refreshRow() Обновляет текущую строку с её последним значением из базы данных. |
boolean |
relative(int rows) Перемещает курсор на относительное количество строк, положительное или отрицательное. |
boolean |
rowDeleted() Получает информацию о том, была ли строка удалена. |
boolean |
rowInserted() Получает информацию о том, была ли текущая строка вставлена. |
boolean |
rowUpdated() Получает информацию о том, была ли текущая строка обновлена. |
void |
setFetchDirection(int direction) Указывает направление обработки строк в этом объекте |
void |
setFetchSize(int rows) Даёт JDBC драйверу подсказку о количестве строк, которое должно быть получено из базы данных, когда для этого объекта |
void |
updateArray(int columnIndex,
Array x) Обновляет указанный столбец значением |
void |
updateArray(String columnLabel,
Array x) Обновляет указанный столбец значением |
void |
updateAsciiStream(int columnIndex,
InputStream x) Обновляет указанный столбец значением потока ASCII. |
void |
updateAsciiStream(int columnIndex,
InputStream x,
int length) Обновляет указанный столбец значением потока ASCII, которое будет иметь указанное количество байтов. |
void |
updateAsciiStream(int columnIndex,
InputStream x,
long length) Обновляет указанный столбец значением потока ASCII, которое будет иметь указанное количество байтов. |
void |
updateAsciiStream(String columnLabel,
InputStream x) Обновляет указанный столбец значением потока ASCII. |
void |
updateAsciiStream(String columnLabel,
InputStream x,
int length) Обновляет указанный столбец значением потока ASCII, которое будет иметь указанное количество байтов. |
void |
updateAsciiStream(String columnLabel,
InputStream x,
long length) Обновляет указанный столбец значением потока ASCII, которое будет иметь указанное количество байтов. |
void |
updateBigDecimal(int columnIndex,
BigDecimal x) Обновляет указанный столбец значением |
void |
updateBigDecimal(String columnLabel,
BigDecimal x) Обновляет указанный столбец значением |
void |
updateBinaryStream(int columnIndex,
InputStream x) Обновляет указанный столбец значением двоичного потока. |
void |
updateBinaryStream(int columnIndex,
InputStream x,
int length) Обновляет указанный столбец значением двоичного потока, которое будет иметь указанное количество байтов. |
void |
updateBinaryStream(int columnIndex,
InputStream x,
long length) Обновляет указанный столбец значением двоичного потока, которое будет иметь указанное количество байтов. |
void |
updateBinaryStream(String columnLabel,
InputStream x) Обновляет указанный столбец значением двоичного потока. |
void |
updateBinaryStream(String columnLabel,
InputStream x,
int length) Обновляет указанный столбец значением двоичного потока, которое будет иметь указанное количество байтов. |
void |
updateBinaryStream(String columnLabel,
InputStream x,
long length) Обновляет указанный столбец значением двоичного потока, которое будет иметь указанное количество байтов. |
void |
updateBlob(int columnIndex,
Blob x) Обновляет указанный столбец значением |
void |
updateBlob(int columnIndex,
InputStream inputStream) Обновляет указанный столбец, используя предоставленный входной поток. |
void |
updateBlob(int columnIndex,
InputStream inputStream,
long length) Обновляет указанный столбец, используя предоставленный входной поток, который будет иметь указанное количество байтов. |
void |
updateBlob(String columnLabel,
Blob x) Обновляет указанный столбец значением |
void |
updateBlob(String columnLabel,
InputStream inputStream) Обновляет указанный столбец, используя предоставленный входной поток. |
void |
updateBlob(String columnLabel,
InputStream inputStream,
long length) Обновляет указанный столбец, используя предоставленный входной поток, который будет иметь указанное количество байтов. |
void |
updateBoolean(int columnIndex,
boolean x) Обновляет указанный столбец значением |
void |
updateBoolean(String columnLabel,
boolean x) Обновляет указанный столбец значением |
void |
updateByte(int columnIndex,
byte x) Обновляет указанный столбец значением |
void |
updateByte(String columnLabel,
byte x) Обновляет указанный столбец значением |
void |
updateBytes(int columnIndex,
byte[] x) Обновляет указанный столбец значением массива |
void |
updateBytes(String columnLabel,
byte[] x) Обновляет указанный столбец значением массива байтов. |
void |
updateCharacterStream(int columnIndex,
Reader x) Обновляет указанный столбец значением потока символов. |
void |
updateCharacterStream(int columnIndex,
Reader x,
int length) Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байтов. |
void |
updateCharacterStream(int columnIndex,
Reader x,
long length) Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байтов. |
void |
updateCharacterStream(String columnLabel,
Reader reader) Обновляет указанный столбец значением потока символов. |
void |
updateCharacterStream(String columnLabel,
Reader reader,
int length) Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байтов. |
void |
updateCharacterStream(String columnLabel,
Reader reader,
long length) Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байтов. |
void |
updateClob(int columnIndex,
Clob x) Обновляет указанный столбец значением |
void |
updateClob(int columnIndex,
Reader reader) Обновляет указанный столбец, используя предоставленный объект |
void |
updateClob(int columnIndex,
Reader reader,
long length) Обновляет указанный столбец, используя предоставленный объект |
void |
updateClob(String columnLabel,
Clob x) Обновляет указанный столбец значением |
void |
updateClob(String columnLabel,
Reader reader) Обновляет указанный столбец, используя предоставленный объект |
void |
updateClob(String columnLabel,
Reader reader,
long length) Обновляет указанный столбец, используя предоставленный объект |
void |
updateDate(int columnIndex,
Date x) Обновляет указанный столбец значением |
void |
updateDate(String columnLabel,
Date x) Обновляет указанный столбец значением |
void |
updateDouble(int columnIndex,
double x) Обновляет указанный столбец значением |
void |
updateDouble(String columnLabel,
double x) Обновляет указанный столбец значением |
void |
updateFloat(int columnIndex,
float x) Обновляет указанный столбец значением |
void |
updateFloat(String columnLabel,
float x) Обновляет указанный столбец значением |
void |
updateInt(int columnIndex,
int x) Обновляет указанный столбец значением |
void |
updateInt(String columnLabel,
int x) Обновляет указанный столбец значением |
void |
updateLong(int columnIndex,
long x) Обновляет указанный столбец значением |
void |
updateLong(String columnLabel,
long x) Обновляет указанный столбец значением |
void |
updateNCharacterStream(int columnIndex,
Reader x) Обновляет указанный столбец значением потока символов. |
void |
updateNCharacterStream(int columnIndex,
Reader x,
long length) Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байтов. |
void |
updateNCharacterStream(String columnLabel,
Reader reader) Обновляет указанный столбец значением потока символов. |
void |
updateNCharacterStream(String columnLabel,
Reader reader,
long length) Обновляет указанный столбец значением потока символов, которое будет иметь указанное количество байтов. |
void |
updateNClob(int columnIndex,
NClob nClob) Обновляет указанный столбец значением |
void |
updateNClob(int columnIndex,
Reader reader) Обновляет указанный столбец, используя предоставленный объект |
void |
updateNClob(int columnIndex,
Reader reader,
long length) Обновляет указанный столбец, используя предоставленный объект |
void |
updateNClob(String columnLabel,
NClob nClob) Обновляет указанный столбец значением |
void |
updateNClob(String columnLabel,
Reader reader) Обновляет указанный столбец, используя заданный объект |
void |
updateNClob(String columnLabel,
Reader reader,
long length) Обновляет указанный столбец, используя заданный объект |
void |
updateNString(int columnIndex,
String nString) Обновляет указанный столбец значением |
void |
updateNString(String columnLabel,
String nString) Обновляет указанный столбец значением |
void |
updateNull(int columnIndex) Обновляет указанный столбец значением |
void |
updateNull(String columnLabel) Обновляет указанный столбец значением |
void |
updateObject(int columnIndex,
Object x) Обновляет указанный столбец значением |
void |
updateObject(int columnIndex,
Object x,
int scaleOrLength) Обновляет указанный столбец значением |
default void |
updateObject(int columnIndex,
Object x,
SQLType targetSqlType) Обновляет указанный столбец значением |
default void |
updateObject(int columnIndex,
Object x,
SQLType targetSqlType,
int scaleOrLength) Обновляет указанный столбец значением |
void |
updateObject(String columnLabel,
Object x) Обновляет указанный столбец значением |
void |
updateObject(String columnLabel,
Object x,
int scaleOrLength) Обновляет указанный столбец значением |
default void |
updateObject(String columnLabel,
Object x,
SQLType targetSqlType) Обновляет указанный столбец значением |
default void |
updateObject(String columnLabel,
Object x,
SQLType targetSqlType,
int scaleOrLength) Обновляет указанный столбец значением |
void |
updateRef(int columnIndex,
Ref x) Обновляет указанный столбец значением |
void |
updateRef(String columnLabel,
Ref x) Обновляет указанный столбец значением |
void |
updateRow() Обновляет базу данных новым содержимым текущей строки этого объекта |
void |
updateRowId(int columnIndex,
RowId x) Обновляет указанный столбец значением |
void |
updateRowId(String columnLabel,
RowId x) Обновляет указанный столбец значением |
void |
updateShort(int columnIndex,
short x) Обновляет указанный столбец значением |
void |
updateShort(String columnLabel,
short x) Обновляет указанный столбец значением |
void |
updateSQLXML(int columnIndex,
SQLXML xmlObject) Обновляет указанный столбец значением |
void |
updateSQLXML(String columnLabel,
SQLXML xmlObject) Обновляет указанный столбец значением |
void |
updateString(int columnIndex,
String x) Обновляет указанный столбец значением |
void |
updateString(String columnLabel,
String x) Обновляет указанный столбец значением |
void |
updateTime(int columnIndex,
Time x) Обновляет указанный столбец значением |
void |
updateTime(String columnLabel,
Time x) Обновляет указанный столбец значением |
void |
updateTimestamp(int columnIndex,
Timestamp x) Обновляет указанный столбец значением |
void |
updateTimestamp(String columnLabel,
Timestamp x) Обновляет указанный столбец значением |
boolean |
wasNull() Указывает, было ли значение последнего прочитанного столбца равно SQL |
Способы, унаследованные от интерфейса java.sql.Wrapper
isWrapperFor, unwrap Поля
FETCH_FORWARD
static final int FETCH_FORWARD
Константа, указывающая, что строки в наборе результатов будут обрабатываться в прямом направлении; от первой к последней. Эта константа используется методом setFetchDirection в качестве подсказки для драйвера, который может её проигнорировать.
- Since:
- 1.2
- См. также:
- Значения константных полей
FETCH_REVERSE
static final int FETCH_REVERSE
Константа, указывающая, что строки в наборе результатов будут обрабатываться в обратном направлении; от последней к первой. Эта константа используется методом setFetchDirection в качестве подсказки для драйвера, который может её проигнорировать.
- Since:
- 1.2
- См. также:
- Значения константных полей
FETCH_UNKNOWN
static final int FETCH_UNKNOWN
Константа, указывающая, что порядок обработки строк в наборе результатов неизвестен. Эта константа используется методом setFetchDirection в качестве подсказки для драйвера, который может её проигнорировать.
- См. также:
- Значения константных полей
TYPE_FORWARD_ONLY
static final int TYPE_FORWARD_ONLY
Константа, указывающая тип для объекта ResultSet с курсором, который может перемещаться только вперёд.
- Since:
- 1.2
- См. также:
- Значения константных полей
TYPE_SCROLL_INSENSITIVE
static final int TYPE_SCROLL_INSENSITIVE
Константа, указывающая тип для объекта ResultSet , который может прокручиваться, но обычно не реагирует на изменения данных, лежащих в основе ResultSet.
- Since:
- 1.2
- См. также:
- Значения константных полей
TYPE_SCROLL_SENSITIVE
static final int TYPE_SCROLL_SENSITIVE
Константа, указывающая тип для объекта ResultSet , который может прокручиваться и обычно реагирует на изменения данных, лежащих в основе ResultSet.
- Since:
- 1.2
- См. также:
- Значения константных полей
CONCUR_READ_ONLY
static final int CONCUR_READ_ONLY
Константа, указывающая режим конкурентного доступа для объекта ResultSet , который НЕ может быть обновлён.
- Since:
- 1.2
- См. также:
- Значения константных полей
CONCUR_UPDATABLE
static final int CONCUR_UPDATABLE
Константа, указывающая режим конкурентного доступа для объекта ResultSet , который может быть обновлён.
- Since:
- 1.2
- См. также:
- Значения константных полей
HOLD_CURSORS_OVER_COMMIT
static final int HOLD_CURSORS_OVER_COMMIT
Константа, указывающая, что открытые объекты ResultSet с такой поддержкой останутся открытыми при подтверждении текущей транзакции.
- Since:
- 1.4
- См. также:
- Значения константных полей
CLOSE_CURSORS_AT_COMMIT
static final int CLOSE_CURSORS_AT_COMMIT
Константа, указывающая, что открытые объекты ResultSet с такой поддержкой будут закрыты при подтверждении текущей транзакции.
- Since:
- 1.4
- См. также:
- Значения константных полей
Методы
next
boolean next()
throws SQLException Перемещает курсор вперёд на одну строку от текущей позиции. Курсор ResultSet изначально находится перед первой строкой; первый вызов метода next делает первую строку текущей; второй вызов делает вторую строку текущей и так далее.
Когда вызов метода next возвращает false, курсор находится после последней строки. Любой вызов метода ResultSet, требующего текущей строки, приведёт к исключению SQLException. Если тип набора результатов TYPE_FORWARD_ONLY, то определяется поставщиком, вернёт ли их реализация JDBC-драйвера false или выбросит исключение SQLException при последующем вызове next.
Если для текущей строки открыт входной поток, вызов метода next неявно закроет его. Цепочка предупреждений объекта ResultSet очищается при чтении новой строки.
- Возвращает:
-
true, если новая текущая строка допустима;false, если больше нет строк - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
close
void close()
throws SQLException Освобождает ресурсы базы данных и JDBC объекта ResultSet немедленно вместо ожидания автоматического закрытия.
Закрытие объекта ResultSet не закрывает объекты Blob, Clob или NClob , созданные объектом ResultSet. Объекты Blob, Clob или NClob остаются валидными по крайней мере на протяжении транзакции, в которой они были созданы, если не вызвана их метод free .
При закрытии объекта ResultSet , любые экземпляры ResultSetMetaData , созданные с помощью метода getMetaData, остаются доступными.
Примечание: Объект ResultSet автоматически закрывается объектом Statement , который его сгенерировал, когда этот объект Statement закрывается, повторно выполняется или используется для получения следующего результата из последовательности нескольких результатов.
Вызов метода close на объекте ResultSet , который уже закрыт, является пустой операцией.
- Задано:
-
closeв интерфейсеAutoCloseable - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных
wasNull
boolean wasNull()
throws SQLException Сообщает, был ли последний считанный столбец значением SQL NULL. Обратите внимание, что вы должны сначала вызвать один из методов-получателей для столбца, чтобы попытаться прочитать его значение, а затем вызвать метод wasNull, чтобы увидеть, было ли прочитанное значение SQL NULL.
- Возвращает:
-
true, если последнее прочитанное значение столбца было 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
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
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, независимо от того, есть ли доступные данные.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй - 2 и т.д. - Возвращаемое значение:
- входной поток Java, предоставляющий значение столбца базы данных в виде потока неинтерпретированных байтов; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getString
String getString(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде строки String на языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, заданная с помощью SQL AS-запроса. Если SQL AS-запрос не был указан, то меткой является имя столбца - Возвращаемое значение:
- значение столбца; если значение является SQL
NULL, возвращаемое значение равноnull - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getBoolean
boolean getBoolean(String columnLabel)
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.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —false - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getByte
byte getByte(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде byte языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —0 - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getShort
short getShort(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде short языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —0 - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getInt
int getInt(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде int языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —0 - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getLong
long getLong(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде long языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —0 - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getFloat
float getFloat(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде float языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —0 - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDouble
double getDouble(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде double языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —0 - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getBigDecimal
@Deprecated
BigDecimal getBigDecimal(String columnLabel,
int scale)
throws SQLException Устарело. Используйте getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде java.math.BigDecimal языка программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
scale- количество цифр справа от десятичной точки - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод
getBytes
byte[] getBytes(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде массива byte на языке программирования Java. Байты представляют собой исходные значения, возвращаемые драйвером.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getDate
Date getDate(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Date на языке программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTime
Time getTime(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Time на языке программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getTimestamp
Timestamp getTimestamp(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Timestamp на языке программирования Java.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getAsciiStream
InputStream getAsciiStream(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока ASCII-символов. Затем значение можно читать из потока частями. Этот метод особенно подходит для получения больших значений LONGVARCHAR. Драйвер JDBC выполнит все необходимые преобразования из формата базы данных в ASCII.
Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода available, независимо от наличия данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Возвращает:
- входной поток Java, который предоставляет значение столбца базы данных в виде потока однобайтовых ASCII-символов. Если значение является SQL
NULL, возвращаемое значение —null. - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов
getUnicodeStream
@Deprecated
InputStream getUnicodeStream(String columnLabel)
throws SQLException Устарело. Используйте getCharacterStream вместо этого
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока двухбайтовых символов Unicode. Первый байт — старший байт, второй — младший. Значение можно читать из потока частями. Этот метод особенно подходит для получения больших значений LONGVARCHAR. Драйвер JDBC выполнит все необходимые преобразования из формата базы данных в Unicode.
Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может вернуть 0 при вызове метода InputStream.available, независимо от наличия данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в SQL-оператор AS. Если оператор AS не указан, то меткой является имя столбца - Возвращает:
- поток Java-ввода, который предоставляет значение столбца базы данных в виде потока символов Юникода с двумя байтами. Если значение равно SQL
NULL, возвращаемое значение равноnull. - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод
getBinaryStream
InputStream getBinaryStream(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока неинтерпретированных byte. Значение можно затем считывать из потока частями. Этот метод особенно подходит для извлечения больших значений LONGVARBINARY.
Примечание: Все данные в возвращаемом потоке должны быть прочитаны до получения значения любого другого столбца. Следующий вызов метода-получателя неявно закрывает поток. Кроме того, поток может возвращать 0 при вызове метода available, независимо от наличия данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в SQL-оператор AS. Если оператор AS не указан, то меткой является имя столбца - Возвращает:
- поток Java-ввода, который предоставляет значение столбца базы данных в виде потока неинтерпретированных байтов; если значение равно SQL
NULL, результатом являетсяnull - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getWarnings
SQLWarning getWarnings()
throws SQLException Возвращает первое предупреждение, сообщенное вызовами этого объекта ResultSet. Последующие предупреждения для этого объекта ResultSet будут привязаны к объекту SQLWarning, возвращаемому этим методом.
Цепочка предупреждений автоматически очищается каждый раз при чтении новой строки. Этот метод не может быть вызван для объекта ResultSet, который был закрыт; при этом будет выброшено SQLException.
Примечание: Эта цепочка предупреждений охватывает только предупреждения, вызванные методами ResultSet. Любое предупреждение, вызванное методами Statement (например, чтение параметров OUT), будет привязано к объекту Statement.
- Возвращает:
- первый объект
SQLWarningилиnull, если их нет - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
clearWarnings
void clearWarnings()
throws SQLException Очищает все предупреждения, сообщенные этим объектом ResultSet. После вызова этого метода метод getWarnings возвращает null до тех пор, пока новое предупреждение не будет сообщено для этого объекта ResultSet.
- Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getCursorName
String getCursorName()
throws SQLException Возвращает имя SQL-курсора, используемого этим объектом ResultSet.
В SQL таблица результатов извлекается с помощью именованного курсора. Текущую строку набора результатов можно обновлять или удалять с помощью оператора обновлений/удаления с позицией, ссылающегося на имя курсора. Чтобы убедиться, что курсор имеет правильный уровень изоляции, чтобы поддерживать обновление, оператор курсора должен быть в форме SELECT FOR UPDATE. Если FOR UPDATE опущено, то обновленные операции с позиционированием могут завершиться неудачей.
API JDBC поддерживает эту функцию SQL, предоставляя имя SQL-курсора, используемого объектом ResultSet. Текущая строка объекта ResultSet также является текущей строкой этого SQL-курсора.
- Возвращает:
- SQL-имя курсора для объекта
ResultSet - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод
getMetaData
ResultSetMetaData getMetaData()
throws SQLException Возвращает количество, типы и свойства столбцов этого объекта ResultSet.
- Возвращает:
- описание столбцов этого объекта
ResultSet - Выбрасывает:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getObject
Object getObject(int columnIndex)
throws SQLException Получает значение указанного столбца в текущей строке этого объекта ResultSet как объект Object в языке программирования Java.
Этот метод вернет значение заданного столбца в виде объекта Java. Тип объекта Java будет соответствовать умолчанию Java-типу, соответствующему типу SQL-столбца, следуя отображению встроенных типов, указанных в спецификации JDBC. Если значение является SQL NULL, драйвер вернёт Java-объект null.
Этот метод также может использоваться для чтения типов данных абстрактных данных, специфичных для базы данных. В API JDBC 2.0 поведение метода getObject расширено для материализации данных типов SQL-пользовательских определений.
Если Connection.getTypeMap не вызывает SQLFeatureNotSupportedException, то, когда столбец содержит структурированное или отдельное значение, поведение этого метода такое же, как если бы это был вызов: getObject(columnIndex,
this.getStatement().getConnection().getTypeMap()). Если Connection.getTypeMap вызывает SQLFeatureNotSupportedException, то структурированные значения не поддерживаются, а отдельные значения отображаются на стандартный класс Java, определяемый подлежащим типом SQL типа DISTINCT.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. - Возвращает:
- объект
java.lang.Object, содержащий значение столбца - Выбрасывает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getObject
Object getObject(String columnLabel)
throws SQLException Получает значение указанного столбца в текущей строке этого объекта ResultSet как объект Object в языке программирования Java.
Этот метод возвратит значение заданного столбца в виде объекта Java. Тип объекта Java соответствует стандартному типу Java, соответствующему SQL-типу столбца, в соответствии с отображением встроенных типов, указанных в спецификации JDBC. Если значение является SQL NULL, драйвер вернет Java-объект null.
Этот метод также может использоваться для чтения типов данных абстрактных данных, специфичных для базы данных.
В API JDBC 2.0 поведение метода getObject расширено для материализации данных типов SQL-пользовательских определений. Когда столбец содержит структурированное или отдельное значение, поведение этого метода такое же, как если бы это был вызов: getObject(columnIndex,
this.getStatement().getConnection().getTypeMap()).
- Параметры:
-
columnLabel- метка для столбца, указанного в SQL-оператор AS. Если оператор AS не указан, то меткой является имя столбца - Возвращает:
- объект
java.lang.Object, содержащий значение столбца - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
findColumn
int findColumn(String columnLabel)
throws SQLException Отображает заданную метку столбца ResultSet в его индекс столбца ResultSet.
- Параметры:
-
columnLabel- метка для столбца, указанного в SQL-оператор AS. Если оператор AS не указан, то меткой является имя столбца - Возвращает:
- индекс столбца заданного имени столбца
- Выбрасывает:
-
SQLException- если объектResultSetне содержит столбец с меткойcolumnLabel, произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов
getCharacterStream
Reader getCharacterStream(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. - Возвращает:
- объект
java.io.Reader, содержащий значение столбца; если значение равно SQLNULL, возвращаемое значение равноnullв языке программирования Java. - Выбрасывает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getCharacterStream
Reader getCharacterStream(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader.
- Параметры:
-
columnLabel- метка для столбца, указанного в SQL-оператор AS. Если оператор AS не указан, то меткой является имя столбца - Возвращает:
- объект
java.io.Reader, содержащий значение столбца; если значение равно SQLNULL, возвращаемое значение равноnullв языке программирования Java - Выбрасывает:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getBigDecimal
BigDecimal getBigDecimal(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как java.math.BigDecimal с полной точностью.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. - Возвращает:
- значение столбца (полная точность); если значение равно SQL
NULL, возвращаемое значение равноnullв языке программирования Java. - Выбрасывает:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getBigDecimal
BigDecimal getBigDecimal(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как java.math.BigDecimal с полной точностью.
- Параметры:
-
columnLabel— метка для столбца, указанного в SQL-операторe AS. Если SQL-оператор AS не был указан, то метка — это имя столбца - Возвращает:
- значение столбца (полная точность); если значение является SQL
NULL, возвращаемое значение —nullна языке программирования Java. - Вызывает:
-
SQLException— если columnLabel недействителен; если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов - С:
- 1.2
isBeforeFirst
boolean isBeforeFirst()
throws SQLException Возвращает значение, указывающее, находится ли указатель перед первой строкой в этом объекте ResultSet.
Примечание: Поддержка метода isBeforeFirst необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Возвращает:
-
trueесли указатель находится перед первой строкой;falseесли указатель находится в любой другой позиции или набор результатов не содержит строк - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
isAfterLast
boolean isAfterLast()
throws SQLException Возвращает значение, указывающее, находится ли указатель после последней строки в этом объекте ResultSet.
Примечание: Поддержка метода isAfterLast необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Возвращает:
-
trueесли указатель находится после последней строки;falseесли указатель находится в любой другой позиции или набор результатов не содержит строк - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
isFirst
boolean isFirst()
throws SQLException Возвращает значение, указывающее, находится ли указатель на первой строке этого объекта ResultSet.
Примечание: Поддержка метода isFirst необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Возвращает:
-
trueесли указатель находится на первой строке;falseв противном случае - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
isLast
boolean isLast()
throws SQLException Возвращает значение, указывающее, находится ли указатель на последней строке этого объекта ResultSet. Примечание: Вызов метода isLast может быть дорогостоящим, так как JDBC-драйверу может потребоваться извлечь следующую строку, чтобы определить, является ли текущая строка последней в наборе результатов.
Примечание: Поддержка метода isLast необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Возвращает:
-
trueесли указатель находится на последней строке;falseв противном случае - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
beforeFirst
void beforeFirst()
throws SQLException Перемещает указатель в начало этого объекта ResultSet, перед первой строкой. Этот метод не имеет эффекта, если набор результатов не содержит строк.
- Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
afterLast
void afterLast()
throws SQLException Перемещает указатель в конец этого объекта ResultSet, после последней строки. Этот метод не имеет эффекта, если набор результатов не содержит строк.
- Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
first
boolean first()
throws SQLException Перемещает указатель на первую строку в этом объекте ResultSet.
- Возвращает:
-
trueесли указатель находится на допустимой строке;falseесли в наборе результатов нет строк - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
last
boolean last()
throws SQLException Перемещает указатель на последнюю строку в этом объекте ResultSet.
- Возвращает:
-
trueесли указатель находится на допустимой строке;falseесли в наборе результатов нет строк - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
getRow
int getRow()
throws SQLException Возвращает номер текущей строки. Первая строка имеет номер 1, вторая — 2 и так далее.
Примечание: Поддержка метода getRow необязательна для ResultSet с типом набора результатов TYPE_FORWARD_ONLY
- Возвращает:
- номер текущей строки;
0если текущей строки нет - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
absolute
boolean absolute(int row)
throws SQLException Перемещает указатель на заданную строку в этом объекте ResultSet.
Если номер строки положительный, указатель перемещается на заданный номер строки относительно начала набора результатов. Первая строка имеет номер 1, вторая — 2 и так далее.
Если заданный номер строки отрицательный, указатель перемещается на абсолютную позицию строки относительно конца набора результатов. Например, вызов метода absolute(-1) позиционирует указатель на последней строке; вызов метода absolute(-2) перемещает указатель на предпоследнюю строку и так далее.
Если указанный номер строки равен нулю, указатель перемещается перед первой строкой.
Попытка позиционировать указатель за пределами первой/последней строки в наборе результатов оставляет указатель перед первой строкой или после последней строки.
Примечание: Вызов absolute(1) эквивалентен вызову first(). Вызов absolute(-1) эквивалентен вызову last().
- Параметры:
-
row— номер строки, на которую должен быть перемещен указатель. Значение 0 означает позиционирование указателя перед первой строкой; положительное число — номер строки, считая с начала набора результатов; отрицательное число — номер строки, считая с конца набора результатов - Возвращает:
-
trueесли указатель перемещен в позицию в этом объектеResultSet;falseесли указатель находится перед первой строкой или после последней строки - Вызывает:
-
SQLException— если произошла ошибка доступа к базе данных; этот метод вызван для закрытого набора результатов или тип набора результатов —TYPE_FORWARD_ONLY -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.2
relative
boolean relative(int rows)
throws SQLException Перемещает указатель на относительное количество строк, положительное или отрицательное. Попытка перемещения за пределы первой/последней строки в наборе результатов позиционирует указатель перед/после первой/последней строки. Вызов relative(0) допустим, но не изменяет позицию указателя.
Примечание: Вызов метода relative(1) идентичен вызову метода next(), а вызов метода relative(-1) идентичен вызову метода previous().
- Параметры:
-
rows— значение, определяющее число строк для перемещения от текущей строки; положительное число перемещает указатель вперёд; отрицательное — назад - Возвращает:
-
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-int, определяющая рекомендуемое направление выборки; одна изResultSet.FETCH_FORWARD,ResultSet.FETCH_REVERSE, илиResultSet.FETCH_UNKNOWN - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается на закрытом наборе результатов или тип набора результатовTYPE_FORWARD_ONLY, а направление выборки неFETCH_FORWARD - С:
- 1.2
- См. также:
-
Statement.setFetchDirection(int),getFetchDirection()
getFetchDirection
int getFetchDirection()
throws SQLException Возвращает направление выборки для этого объекта ResultSet.
- Возвращает:
- текущее направление выборки для этого объекта
ResultSet - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов - С:
- 1.2
- См. также:
setFetchDirection(int)
setFetchSize
void setFetchSize(int rows)
throws SQLException Даёт JDBC драйверу подсказку о количестве строк, которые должны быть извлечены из базы данных, когда для этого объекта ResultSet необходимы дополнительные строки. Если заданный размер выборки равен нулю, JDBC драйвер игнорирует значение и свободен сам решить, каким должен быть размер выборки. Значение по умолчанию устанавливается объектом Statement, который создал набор результатов. Размер выборки можно изменить в любое время.
- Параметры:
-
rows- количество строк для выборки - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается на закрытом наборе результатов или условиеrows >= 0не выполняется - С:
- 1.2
- См. также:
getFetchSize()
getFetchSize
int getFetchSize()
throws SQLException Возвращает размер выборки для этого объекта ResultSet.
- Возвращает:
- текущий размер выборки для этого объекта
ResultSet - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов - С:
- 1.2
- См. также:
setFetchSize(int)
getType
int getType()
throws SQLException Возвращает тип этого объекта ResultSet. Тип определяется объектом Statement, который создал набор результатов.
- Возвращает:
-
ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVE, илиResultSet.TYPE_SCROLL_SENSITIVE - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов - С:
- 1.2
getConcurrency
int getConcurrency()
throws SQLException Возвращает режим конкурентности этого объекта ResultSet. Конкурентность определяется объектом Statement, который создал набор результатов.
- Возвращает:
- тип конкурентности, либо
ResultSet.CONCUR_READ_ONLY, либоResultSet.CONCUR_UPDATABLE - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов - С:
- 1.2
rowUpdated
boolean rowUpdated()
throws SQLException Возвращает, была ли текущая строка обновлена. Возвращаемое значение зависит от того, может ли набор результатов обнаруживать обновления.
Примечание: Поддержка метода rowUpdated является необязательной для набора результатов с конкурентностью CONCUR_READ_ONLY
- Возвращает:
-
trueесли текущая строка была явно обновлена владельцем или другим;falseв противном случае - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
- См. также:
DatabaseMetaData.updatesAreDetected(int)
rowInserted
boolean rowInserted()
throws SQLException Возвращает, была ли текущая строка вставлена. Возвращаемое значение зависит от того, может ли этот объект ResultSet обнаруживать видимые вставки.
Примечание: Поддержка метода rowInserted является необязательной для набора результатов с конкурентностью CONCUR_READ_ONLY
- Возвращает:
-
trueесли текущая строка была вставлена;falseв противном случае - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
- См. также:
DatabaseMetaData.insertsAreDetected(int)
rowDeleted
boolean rowDeleted()
throws SQLException Возвращает, была ли строка удалена. Удаленная строка может оставить видимую "дыру" в наборе результатов. Этот метод может использоваться для обнаружения дыр в наборе результатов. Возвращаемое значение зависит от того, может ли этот объект ResultSet обнаруживать удаления.
Примечание: Поддержка метода rowDeleted является необязательной для набора результатов с конкурентностью CONCUR_READ_ONLY
- Возвращает:
-
trueесли текущая строка была удалена владельцем или другим;falseв противном случае - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
- См. также:
DatabaseMetaData.deletesAreDetected(int)
updateNull
void updateNull(int columnIndex)
throws SQLException Обновляет указанный столбец значением null. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлений не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2, и так далее - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateBoolean
void updateBoolean(int columnIndex,
boolean x)
throws SQLException Обновляет указанный столбец значением boolean. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлений не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2, и так далее -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateByte
void updateByte(int columnIndex,
byte x)
throws SQLException Обновляет указанный столбец значением byte. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлений не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2, и так далее -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateShort
void updateShort(int columnIndex,
short x)
throws SQLException Обновляет указанный столбец значением short. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлений не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2, и так далее -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateInt
void updateInt(int columnIndex,
int x)
throws SQLException Обновляет указанный столбец значением int. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлений не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй - 2, и так далее -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызывается на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.2
updateLong
void updateLong(int columnIndex,
long x)
throws SQLException Обновляет указанный столбец значением long. Методы обновлений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлений не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateFloat
void updateFloat(int columnIndex,
float x)
throws SQLException Обновляет указанный столбец значением типа float. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateDouble
void updateDouble(int columnIndex,
double x)
throws SQLException Обновляет указанный столбец значением типа double. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateBigDecimal
void updateBigDecimal(int columnIndex,
BigDecimal x)
throws SQLException Обновляет указанный столбец значением типа java.math.BigDecimal. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateString
void updateString(int columnIndex,
String x)
throws SQLException Обновляет указанный столбец значением типа String. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateBytes
void updateBytes(int columnIndex,
byte[] x)
throws SQLException Обновляет указанный столбец значением типа byte массив. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateDate
void updateDate(int columnIndex,
Date x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Date. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateTime
void updateTime(int columnIndex,
Time x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Time. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateTimestamp
void updateTimestamp(int columnIndex,
Timestamp x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Timestamp. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateAsciiStream
void updateAsciiStream(int columnIndex,
InputStream x,
int length)
throws SQLException Обновляет указанный столбец значением потока ASCII, имеющим указанное количество байт. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateBinaryStream
void updateBinaryStream(int columnIndex,
InputStream x,
int length)
throws SQLException Обновляет указанный столбец значением потока двоичных данных, имеющим указанное количество байт. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateCharacterStream
void updateCharacterStream(int columnIndex,
Reader x,
int length)
throws SQLException Обновляет указанный столбец значением потока символов, имеющим указанное количество байт. Методы обновляющих значений используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновляющих значений не обновляют базу данных непосредственно; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов —CONCUR_READ_ONLY, или если метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateObject
void updateObject(int columnIndex,
Object x,
int scaleOrLength)
throws SQLException Обновляет указанный столбец значением Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Если второй аргумент является InputStream, то поток должен содержать количество байтов, указанное в scaleOrLength. Если второй аргумент является Reader, то считывающее устройство должно содержать количество символов, указанное в scaleOrLength. Если эти условия неверны, драйвер сгенерирует SQLException при выполнении оператора.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
scaleOrLength- для объектаjava.math.BigDecimal, это количество цифр после десятичной точки. Для типов объектов JavaInputStreamиReader, это длина данных в потоке или считывающем устройстве. Для всех остальных типов это значение будет игнорироваться. - Исключения:
-
SQLException- если номер столбца неверен; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateObject
void updateObject(int columnIndex,
Object x)
throws SQLException Обновляет указанный столбец значением Object. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Исключения:
-
SQLException- если номер столбца неверен; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateNull
void updateNull(String columnLabel)
throws SQLException Обновляет указанный столбец значением null. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateBoolean
void updateBoolean(String columnLabel,
boolean x)
throws SQLException Обновляет указанный столбец значением boolean. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateByte
void updateByte(String columnLabel,
byte x)
throws SQLException Обновляет указанный столбец значением byte. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateShort
void updateShort(String columnLabel,
short x)
throws SQLException Обновляет указанный столбец значением short. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateInt
void updateInt(String columnLabel,
int x)
throws SQLException Обновляет указанный столбец значением int. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateLong
void updateLong(String columnLabel,
long x)
throws SQLException Обновляет указанный столбец значением long. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateFloat
void updateFloat(String columnLabel,
float x)
throws SQLException Обновляет указанный столбец значением float . Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateDouble
void updateDouble(String columnLabel,
double x)
throws SQLException Обновляет указанный столбец значением double. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного с помощью предложения SQL AS. Если предложение SQL AS не указано, то метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если метка столбца неверна; если произошла ошибка доступа к базе данных; параллелизм результирующего набора являетсяCONCUR_READ_ONLYили этот метод вызывается для закрытого результирующего набора -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С версии:
- 1.2
updateBigDecimal
void updateBigDecimal(String columnLabel,
BigDecimal x)
throws SQLException Обновляет указанный столбец значением java.sql.BigDecimal. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базовую базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateString
void updateString(String columnLabel,
String x)
throws SQLException Обновляет указанный столбец значением типа String. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateBytes
void updateBytes(String columnLabel,
byte[] x)
throws SQLException Обновляет указанный столбец значением типа массив байтов. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateDate
void updateDate(String columnLabel,
Date x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Date. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateTime
void updateTime(String columnLabel,
Time x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Time. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateTimestamp
void updateTimestamp(String columnLabel,
Timestamp x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Timestamp. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateAsciiStream
void updateAsciiStream(String columnLabel,
InputStream x,
int length)
throws SQLException Обновляет указанный столбец значением потока ASCII, имеющим указанное количество байт. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateBinaryStream
void updateBinaryStream(String columnLabel,
InputStream x,
int length)
throws SQLException Обновляет указанный столбец значением двоичного потока, имеющим указанное количество байт. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateCharacterStream
void updateCharacterStream(String columnLabel,
Reader reader,
int length)
throws SQLException Обновляет указанный столбец значением потока символов, имеющим указанное количество байт. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
reader- объект, содержащий новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateObject
void updateObject(String columnLabel,
Object x,
int scaleOrLength)
throws SQLException Обновляет указанный столбец значением типа Object. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Если второй аргумент — InputStream, то поток должен содержать количество байтов, указанное параметром scaleOrLength. Если второй аргумент — Reader, то поток должен содержать количество символов, указанное параметром scaleOrLength. Если эти условия не выполняются, драйвер сгенерирует SQLException при выполнении запроса.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка — это имя столбца -
x- новое значение столбца -
scaleOrLength- для объектаjava.math.BigDecimal, это количество цифр после запятой. Для типов Java ObjectInputStreamиReader, это длина данных в потоке или потоке чтения. Для всех остальных типов это значение будет проигнорировано. - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатов —CONCUR_READ_ONLY, или этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С тех пор, как:
- 1.2
updateObject
void updateObject(String columnLabel,
Object x)
throws SQLException Обновляет указанный столбец значением типа Object. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не было указано, метка представляет собой имя столбца -
x- новое значение столбца - Исключение:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLY, или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
insertRow
void insertRow()
throws SQLException Вставляет содержимое строки вставки в этот ResultSet объект и в базу данных. Курсор должен находиться на строке вставки при вызове этого метода.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLY, этот метод вызывается для закрытого набора результатов, если этот метод вызывается, когда курсор не находится на строке вставки, или если не все столбцы без возможности NULL в строке вставки не имеют значения NULL -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
updateRow
void updateRow()
throws SQLException Обновляет базу данных с новым содержимым текущей строки этого ResultSet объекта. Этот метод нельзя вызывать, когда курсор находится на строке вставки.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLY; этот метод вызывается для закрытого набора результатов или если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
deleteRow
void deleteRow()
throws SQLException Удаляет текущую строку из этого ResultSet объекта и из основной базы данных. Этот метод нельзя вызывать, когда курсор находится на строке вставки.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; уровень конкурентности набора результатовCONCUR_READ_ONLY; этот метод вызывается для закрытого набора результатов или если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
refreshRow
void refreshRow()
throws SQLException Обновляет текущую строку последними значениями из базы данных. Этот метод нельзя вызывать, когда курсор находится на строке вставки.
Метод refreshRow предоставляет способ явно указать драйверу JDBC перечитать строку(и) из базы данных. При кэшировании или предварительной выборке может потребоваться вызвать refreshRow, чтобы получить последнее значение строки из базы данных. Драйвер JDBC может фактически обновить несколько строк одновременно, если размер выборки больше единицы.
Все значения перечитываются с учётом уровня изоляции транзакции и чувствительности курсора. Если refreshRow вызывается после вызова метода обновления, но до вызова метода updateRow, то изменения, внесённые в строку, теряются. Частое вызывание метода refreshRow вероятно замедлит производительность.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов; тип набора результатовTYPE_FORWARD_ONLYили если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод или этот метод не поддерживается для указанного типа набора результатов и уровня конкурентности набора результатов. - С:
- 1.2
cancelRowUpdates
void cancelRowUpdates()
throws SQLException Отменяет изменения, внесённые в текущую строку в этом ResultSet объекте. Этот метод может быть вызван после вызова метода(ов) обновления и перед вызовом метода updateRow для отката изменений, внесённых в строку. Если никаких изменений не было внесено или метод updateRow уже был вызван, этот метод не оказывает влияния.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов; уровень конкурентности набора результатовCONCUR_READ_ONLYили если этот метод вызывается, когда курсор находится на строке вставки -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
moveToInsertRow
void moveToInsertRow()
throws SQLException Перемещает курсор на строку вставки. Текущее положение курсора запоминается, пока курсор находится на строке вставки. Строка вставки — это специальная строка, связанная с обновляемым набором результатов. По сути, это буфер, где может быть построена новая строка путём вызова методов обновления до вставки строки в набор результатов. Когда курсор находится на строке вставки, можно вызывать только методы обновления, получения и insertRow. Все столбцы в наборе результатов должны быть присвоены значение каждый раз, когда вызывается этот метод, перед вызовом insertRow. Метод обновления должен быть вызван перед вызовом метода получения для столбца.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или уровень конкурентности набора результатовCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
moveToCurrentRow
void moveToCurrentRow()
throws SQLException Перемещает курсор в запомненное положение курсора, обычно текущую строку. Этот метод не оказывает никакого влияния, если курсор не находится на строке вставки.
- Исключение:
-
SQLException- если произошла ошибка доступа к базе данных; этот метод вызывается для закрытого набора результатов или уровень конкурентности набора результатовCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getStatement
Statement getStatement()
throws SQLException Возвращает объект Statement, который создал этот ResultSet объект. Если набор результатов был сгенерирован каким-то другим способом, например, методом DatabaseMetaData, этот метод может вернуть null.
- Возвращает:
- объект
Statement, который создал этотResultSetобъект илиnull, если набор результатов был создан другим способом - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С:
- 1.2
getObject
Object getObject(int columnIndex,
Map<String,Class<?>> map)
throws SQLException Возвращает значение указанного столбца в текущей строке этого ResultSet объекта как Object языка программирования Java. Если значение является SQL NULL, драйвер возвращает Java null. Этот метод использует указанный объект Map для пользовательского сопоставления SQL структурированного или отдельного типа, который извлекается.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2, и т. д. -
map- объектjava.util.Map, содержащий сопоставление имён SQL типов с классами в языке программирования Java - Возвращает:
- объект
Objectязыка программирования Java, представляющий SQL значение - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getRef
Ref getRef(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого ResultSet объекта как объект Ref языка программирования Java.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2, и т. д. - Возвращает:
- объект
Ref, представляющий SQL значениеREF - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getBlob
Blob getBlob(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого ResultSet объекта как объект Blob языка программирования Java.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2, и т. д. - Возвращает:
- объект
Blob, представляющий SQL значениеBLOBв указанном столбце - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getClob
Clob getClob(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого ResultSet объекта как объект Clob языка программирования Java.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2, и т. д. - Возвращает:
- объект
Clob, представляющий SQL значениеCLOBв указанном столбце - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getArray
Array getArray(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого ResultSet объекта как объект Array языка программирования Java.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2, и т. д. - Возвращает:
- объект
Array, представляющий SQL значениеARRAYв указанном столбце - Исключение:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С:
- 1.2
getObject
Object getObject(String columnLabel,
Map<String,Class<?>> map)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в качестве Object на языке программирования Java. Если значение является SQL NULL, драйвер возвращает значение Java null. Этот метод использует указанный объект Map для пользовательского отображения, если необходимо.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца -
map- объектjava.util.Map, содержащий отображение имен SQL-типов на классы на языке программирования Java - Возвращает:
- объект
Object, представляющий значение SQL в указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С тех пор как:
- 1.2
getRef
Ref getRef(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Ref на языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца - Возвращает:
- объект
Ref, представляющий значение SQLREFв указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С тех пор как:
- 1.2
getBlob
Blob getBlob(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Blob на языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца - Возвращает:
- объект
Blob, представляющий значение SQLBLOBв указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С тех пор как:
- 1.2
getClob
Clob getClob(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Clob на языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца - Возвращает:
- объект
Clob, представляющий значение SQLCLOBв указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С тех пор как:
- 1.2
getArray
Array getArray(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта Array на языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца - Возвращает:
- объект
Array, представляющий значение SQLARRAYв указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С тех пор как:
- 1.2
getDate
Date getDate(int columnIndex,
Calendar cal)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Date на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для даты, если базовая база данных не хранит информацию о часовом поясе.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
cal- объектjava.util.Calendarдля использования при построении даты - Возвращает:
- значение столбца в виде объекта
java.sql.Date; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - С тех пор как:
- 1.2
getDate
Date getDate(String columnLabel,
Calendar cal)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Date на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для даты, если базовая база данных не хранит информацию о часовом поясе.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца -
cal- объектjava.util.Calendarдля использования при построении даты - Возвращает:
- значение столбца в виде объекта
java.sql.Date; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - С тех пор как:
- 1.2
getTime
Time getTime(int columnIndex,
Calendar cal)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Time на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для времени, если базовая база данных не хранит информацию о часовом поясе.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
cal- объектjava.util.Calendarдля использования при построении времени - Возвращает:
- значение столбца в виде объекта
java.sql.Time; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - С тех пор как:
- 1.2
getTime
Time getTime(String columnLabel,
Calendar cal)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Time на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для времени, если базовая база данных не хранит информацию о часовом поясе.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца -
cal- объектjava.util.Calendarдля использования при построении времени - Возвращает:
- значение столбца в виде объекта
java.sql.Time; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - С тех пор как:
- 1.2
getTimestamp
Timestamp getTimestamp(int columnIndex,
Calendar cal)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Timestamp на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для временной метки, если базовая база данных не хранит информацию о часовом поясе.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
cal- объектjava.util.Calendarдля использования при построении временной метки - Возвращает:
- значение столбца в виде объекта
java.sql.Timestamp; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод был вызван на закрытом наборе результатов - С тех пор как:
- 1.2
getTimestamp
Timestamp getTimestamp(String columnLabel,
Calendar cal)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.Timestamp на языке программирования Java. Этот метод использует заданный календарь для построения соответствующего значения в миллисекундах для временной метки, если базовая база данных не хранит информацию о часовом поясе.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-определения AS. Если SQL-определение AS не было указано, то метка — это имя столбца -
cal- объектjava.util.Calendarдля использования при построении даты - Возвращает:
- значение столбца в виде объекта
java.sql.Timestamp; если значение является SQLNULL, возвращаемое значение —nullна языке программирования Java - Исключения:
-
SQLException- если columnLabel некорректен или произошла ошибка доступа к базе данных, или этот метод был вызван на закрытом наборе результатов - С тех пор как:
- 1.2
getURL
URL getURL(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.net.URL на языке программирования Java.
- Параметры:
-
columnIndex- индекс столбца (1 — первый, 2 — второй и т. д.) - Возвращает:
- значение столбца в виде объекта
java.net.URL; если значение является SQLNULL, возвращаемое значение —nullв языке программирования Java - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если метод вызван на закрытом наборе результатов или URL неверный -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
getURL
URL getURL(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.net.URL в языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, метка — имя столбца - Возвращает:
- значение столбца в виде объекта
java.net.URL; если значение является SQLNULL, возвращаемое значение —nullв языке программирования Java - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; если метод вызван на закрытом наборе результатов или URL неверный -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateRef
void updateRef(int columnIndex,
Ref x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Ref. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateRef
void updateRef(String columnLabel,
Ref x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Ref. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, метка — имя столбца -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateBlob
void updateBlob(int columnIndex,
Blob x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Blob. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateBlob
void updateBlob(String columnLabel,
Blob x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Blob. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, метка — имя столбца -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateClob
void updateClob(int columnIndex,
Clob x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Clob. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateClob
void updateClob(String columnLabel,
Clob x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Clob. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, метка — имя столбца -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateArray
void updateArray(int columnIndex,
Array x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Array. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
updateArray
void updateArray(String columnLabel,
Array x)
throws SQLException Обновляет указанный столбец значением типа java.sql.Array. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, метка — имя столбца -
x- новое значение столбца - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; конвейер набора результатов —CONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
getRowId
RowId getRowId(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.RowId в языке программирования Java.
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.6
getRowId
RowId getRowId(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде объекта java.sql.RowId в языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанного с помощью SQL-запроса AS. Если SQL-запрос AS не указан, метка — имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаемое значение —null - Выбрасывает:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.6
updateRowId
void updateRowId(int columnIndex,
RowId x)
throws SQLException Обновляет указанный столбец значением типа RowId. Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителей не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т.д. -
x- значение столбца - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов равнаCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
updateRowId
void updateRowId(String columnLabel,
RowId x)
throws SQLException Обновляет указанный столбец значением RowId. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL AS. Если фрагмент SQL AS не был указан, меткой является имя столбца -
x- значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов равнаCONCUR_READ_ONLYили этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
getHoldability
int getHoldability()
throws SQLException Возвращает режим удержания для этого объекта ResultSet.
- Возвращает:
- либо
ResultSet.HOLD_CURSORS_OVER_COMMITлибоResultSet.CLOSE_CURSORS_AT_COMMIT - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов - С версии:
- 1.6
isClosed
boolean isClosed()
throws SQLException Возвращает, был ли закрыт этот объект ResultSet. Объект ResultSet считается закрытым, если на нём вызван метод close, или если он был закрыт автоматически.
- Возвращает:
- true, если объект
ResultSetзакрыт; false, если он открыт - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных - С версии:
- 1.6
updateNString
void updateNString(int columnIndex,
String nString)
throws SQLException Обновляет указанный столбец значением String типа. Предназначен для обновления NCHAR, NVARCHAR и LONGNVARCHAR столбцов. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т.д. -
nString- значение для обновления столбца - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил возможную ошибку преобразования данных; если метод вызывается для закрытого набора результатов; если конкурентность набора результатов равнаCONCUR_READ_ONLY; если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
updateNString
void updateNString(String columnLabel,
String nString)
throws SQLException Обновляет указанный столбец значением String типа. Предназначен для обновления NCHAR, NVARCHAR и LONGNVARCHAR столбцов. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL AS. Если фрагмент SQL AS не был указан, меткой является имя столбца -
nString- значение для обновления столбца - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил возможную ошибку преобразования данных; если метод вызывается для закрытого набора результатов; если конкурентность набора результатов равнаCONCUR_READ_ONLY; если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
updateNClob
void updateNClob(int columnIndex,
NClob nClob)
throws SQLException Обновляет указанный столбец значением java.sql.NClob типа. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет значение 1, второй 2 и т.д. -
nClob- значение для обновления столбца - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил возможную ошибку преобразования данных; если метод вызывается для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатов равнаCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
updateNClob
void updateNClob(String columnLabel,
NClob nClob)
throws SQLException Обновляет указанный столбец значением java.sql.NClob типа. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL AS. Если фрагмент SQL AS не был указан, меткой является имя столбца -
nClob- значение для обновления столбца - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил возможную ошибку преобразования данных; если метод вызывается для закрытого набора результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатов равнаCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
getNClob
NClob getNClob(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект NClob в языке программирования Java.
- Параметры:
-
columnIndex- номер столбца (первый столбец - 1, второй - 2 и т.д.) - Возвращает:
- объект
NClob, представляющий значение SQLNCLOBв указанном столбце - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил возможную ошибку преобразования данных; если метод вызывается для закрытого набора результатов или если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
getNClob
NClob getNClob(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке объекта ResultSet как объект NClob в языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL AS. Если фрагмент SQL AS не был указан, меткой является имя столбца - Возвращает:
- объект
NClob, представляющий значение SQLNCLOBв указанном столбце - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаружил возможную ошибку преобразования данных; если метод вызывается для закрытого набора результатов или если произошла ошибка доступа к базе данных -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
getSQLXML
SQLXML getSQLXML(int columnIndex)
throws SQLException Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.SQLXML в языке программирования Java.
- Параметры:
-
columnIndex- номер столбца (первый столбец - 1, второй - 2 и т.д.) - Возвращает:
- объект
SQLXML, представляющий значениеSQL XML - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
getSQLXML
SQLXML getSQLXML(String columnLabel)
throws SQLException Возвращает значение указанного столбца в текущей строке объекта ResultSet как объект java.sql.SQLXML в языке программирования Java.
- Параметры:
-
columnLabel- метка столбца, указанная в SQL AS. Если фрагмент SQL AS не был указан, меткой является имя столбца - Возвращает:
- объект
SQLXML, представляющий значениеSQL XML - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных или этот метод вызывается для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С версии:
- 1.6
updateSQLXML
void updateSQLXML(int columnIndex,
SQLXML xmlObject)
throws SQLException Обновляет указанный столбец значением java.sql.SQLXML типа. Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex— первый столбец имеет значение 1, второй — 2 и т. д. -
xmlObject— значение для столбца, который нужно обновить - Исключения:
-
SQLException— если columnIndex некорректен; если произошла ошибка доступа к базе данных; если метод вызван на закрытом наборе результатов; если для объектаSQLXMLне закрытjava.xml.transform.Result,WriterилиOutputStream; если произошла ошибка при обработке XML-значения или конкурентность набора результатов равнаCONCUR_READ_ONLY. МетодgetCauseисключения может предоставить более подробное исключение, например, если поток не содержит допустимого XML. -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
updateSQLXML
void updateSQLXML(String columnLabel,
SQLXML xmlObject)
throws SQLException Обновляет указанный столбец значением типа java.sql.SQLXML. Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel— метка столбца, указанного с помощью SQL AS. Если фраза SQL AS не указана, метка — это имя столбца -
xmlObject— значение столбца - Исключения:
-
SQLException— если columnLabel некорректен; если произошла ошибка доступа к базе данных; если метод вызван на закрытом наборе результатов; если для объектаSQLXMLне закрытjava.xml.transform.Result,WriterилиOutputStream; если произошла ошибка при обработке XML-значения или конкурентность набора результатов равнаCONCUR_READ_ONLY. МетодgetCauseисключения может предоставить более подробное исключение, например, если поток не содержит допустимого XML. -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
getNString
String getNString(int columnIndex)
throws SQLException Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как строку в языке программирования Java. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
- Параметры:
-
columnIndex— первый столбец имеет индекс 1, второй — 2 и т. д. - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаетсяnull - Исключения:
-
SQLException— если columnIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
getNString
String getNString(String columnLabel)
throws SQLException Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как строку в языке программирования Java. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
- Параметры:
-
columnLabel— метка столбца, указанного с помощью SQL AS. Если фраза SQL AS не указана, метка — это имя столбца - Возвращает:
- значение столбца; если значение является SQL
NULL, возвращаетсяnull - Исключения:
-
SQLException— если columnLabel некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
getNCharacterStream
Reader getNCharacterStream(int columnIndex)
throws SQLException Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект потока символов. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
- Параметры:
-
columnIndex— первый столбец имеет индекс 1, второй — 2 и т. д. - Возвращает:
- объект потока символов, содержащий значение столбца; если значение является SQL
NULL, возвращаетсяnullв языке программирования Java. - Исключения:
-
SQLException— если columnIndex некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
getNCharacterStream
Reader getNCharacterStream(String columnLabel)
throws SQLException Извлекает значение указанного столбца в текущей строке этого объекта ResultSet как объект потока символов. Предназначено для доступа к столбцам типа NCHAR, NVARCHAR и LONGNVARCHAR.
- Параметры:
-
columnLabel— метка столбца, указанного с помощью SQL AS. Если фраза SQL AS не указана, метка — это имя столбца - Возвращает:
- объект потока символов, содержащий значение столбца; если значение является SQL
NULL, возвращаетсяnullв языке программирования Java - Исключения:
-
SQLException— если columnLabel некорректен; если произошла ошибка доступа к базе данных или метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex,
Reader x,
long length)
throws SQLException Обновляет указанный столбец значением потока символов с указанным количеством байтов. Драйвер выполняет необходимое преобразование из формата символов Java в национальный формат символов базы данных. Предназначено для обновления столбцов типа NCHAR, NVARCHAR и LONGNVARCHAR.
Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex— первый столбец имеет индекс 1, второй — 2 и т. д. -
x— новое значение столбца -
length— длина потока - Исключения:
-
SQLException— если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов равнаCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
updateNCharacterStream
void updateNCharacterStream(String columnLabel,
Reader reader,
long length)
throws SQLException Обновляет указанный столбец значением потока символов с указанным количеством байтов. Драйвер выполняет необходимое преобразование из формата символов Java в национальный формат символов базы данных. Предназначено для обновления столбцов типа NCHAR, NVARCHAR и LONGNVARCHAR.
Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel— метка столбца, указанного с помощью SQL AS. Если фраза SQL AS не указана, метка — это имя столбца -
reader— объект потока символов, содержащий новое значение столбца -
length— длина потока - Исключения:
-
SQLException— если columnLabel некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов равнаCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
updateAsciiStream
void updateAsciiStream(int columnIndex,
InputStream x,
long length)
throws SQLException Обновляет указанный столбец значением потока ASCII с указанным количеством байтов.
Методы обновлителя используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновлителя не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex— первый столбец имеет индекс 1, второй — 2 и т. д. -
x— новое значение столбца -
length— длина потока - Исключения:
-
SQLException— если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конкурентность набора результатов равнаCONCUR_READ_ONLYили метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - С:
- 1.6
updateBinaryStream
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
updateCharacterStream
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
updateAsciiStream
void updateAsciiStream(String columnLabel,
InputStream x,
long length)
throws SQLException Обновляет указанный столбец значением потока ASCII, которое будет содержать указанное количество байтов.
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-описании AS. Если SQL-описание AS не указано, метка - это имя столбца -
x- новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С тех пор:
- 1.6
updateBinaryStream
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
updateCharacterStream
void updateCharacterStream(String columnLabel,
Reader reader,
long length)
throws SQLException Обновляет указанный столбец значением потока символов, которое будет содержать указанное количество байтов.
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-описании AS. Если SQL-описание AS не указано, метка - это имя столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца -
length- длина потока - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С тех пор:
- 1.6
updateBlob
void updateBlob(int columnIndex,
InputStream inputStream,
long length)
throws SQLException Обновляет указанный столбец, используя предоставленный поток ввода, который будет содержать указанное количество байтов.
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет номер 1, второй - 2 и т. д. -
inputStream- объект, содержащий данные для установки значения параметра. -
length- количество байтов в данных параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С тех пор:
- 1.6
updateBlob
void updateBlob(String columnLabel,
InputStream inputStream,
long length)
throws SQLException Обновляет указанный столбец, используя предоставленный поток ввода, который будет содержать указанное количество байтов.
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы 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 для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет номер 1, второй - 2 и т. д. -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С тех пор:
- 1.6
updateClob
void updateClob(String columnLabel,
Reader reader,
long length)
throws SQLException Обновляет указанный столбец, используя предоставленный объект Reader, длина которого равна заданному числу символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может быть целесообразнее отправлять его через объект java.io.Reader. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в SQL-описании AS. Если SQL-описание AS не указано, метка - это имя столбца -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкуретность набора результатовCONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С тех пор:
- 1.6
updateNClob
void updateNClob(int columnIndex,
Reader reader,
long length)
throws SQLException Обновляет указанный столбец, используя предоставленный объект Reader, длина которого равна заданному числу символов. Когда очень большое значение UNICODE вводится в параметр LONGVARCHAR, может быть целесообразнее отправлять его через объект java.io.Reader. Драйвер JDBC выполнит необходимые преобразования из UNICODE в формат символов базы данных.
Методы обновления используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnIndex- первый столбец имеет номер 1, второй - 2 и т. д. -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если columnIndex недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод вызван для закрытого набора результатов, если произошла ошибка доступа к базе данных или конкуретность набора результатовCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если драйвер JDBC не поддерживает этот метод - С тех пор:
- 1.6
updateNClob
void updateNClob(String columnLabel,
Reader reader,
long length)
throws SQLException Обновляет указанный столбец с помощью объекта Reader, длина которого задана в символах. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть более целесообразно передать его через объект java.io.Reader. Драйвер JDBC выполнит необходимое преобразование из UNICODE в формат символов базы данных.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если columnLabel недействителен; если драйвер не поддерживает национальные наборы символов; если драйвер обнаруживает, что может произойти ошибка преобразования данных; этот метод вызван на закрытом наборе результатов; если произошла ошибка доступа к базе данных или конкурентность набора результатовCONCUR_READ_ONLY -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateNCharacterStream
void updateNCharacterStream(int columnIndex,
Reader x)
throws SQLException Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока. Драйвер выполняет необходимое преобразование из формата символов Java в национальный набор символов базы данных. Он предназначен для обновления столбцов NCHAR, NVARCHAR и LONGNVARCHAR.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateNCharacterStream, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateNCharacterStream
void updateNCharacterStream(String columnLabel,
Reader reader)
throws SQLException Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока. Драйвер выполняет необходимое преобразование из формата символов Java в национальный набор символов базы данных. Он предназначен для обновления столбцов NCHAR, NVARCHAR и LONGNVARCHAR.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateNCharacterStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
reader- объект, содержащий новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateAsciiStream
void updateAsciiStream(int columnIndex,
InputStream x)
throws SQLException Обновляет указанный столбец значением потока ASCII. Данные будут читаться из потока по мере необходимости до достижения конца потока.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateAsciiStream, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateBinaryStream
void updateBinaryStream(int columnIndex,
InputStream x)
throws SQLException Обновляет указанный столбец значением потока двоичных данных. Данные будут читаться из потока по мере необходимости до достижения конца потока.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateBinaryStream, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateCharacterStream
void updateCharacterStream(int columnIndex,
Reader x)
throws SQLException Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateCharacterStream, которая принимает параметр длины.
- Параметры:
-
columnIndex- первый столбец - 1, второй - 2 и т.д. -
x- новое значение столбца - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateAsciiStream
void updateAsciiStream(String columnLabel,
InputStream x)
throws SQLException Обновляет указанный столбец значением потока ASCII. Данные будут читаться из потока по мере необходимости до достижения конца потока.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateAsciiStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateBinaryStream
void updateBinaryStream(String columnLabel,
InputStream x)
throws SQLException Обновляет указанный столбец значением потока двоичных данных. Данные будут читаться из потока по мере необходимости до достижения конца потока.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateBinaryStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, метка является именем столбца -
x- новое значение столбца - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; конкурентность набора результатовCONCUR_READ_ONLYили этот метод вызван на закрытом наборе результатов -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С момента:
- 1.6
updateCharacterStream
void updateCharacterStream(String columnLabel,
Reader reader)
throws SQLException Обновляет указанный столбец значением потока символов. Данные будут читаться из потока по мере необходимости до достижения конца потока.
Методы updater используются для обновления значений столбцов в текущей строке или строке вставки. Методы updater не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации вашего JDBC драйвера, чтобы определить, возможно ли использование более эффективной версии updateCharacterStream, которая принимает параметр длины.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, меткой является имя столбца -
reader- объектjava.io.Reader, содержащий новое значение столбца - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; если конвейность набора результатов являетсяCONCUR_READ_ONLY, или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
updateBlob
void updateBlob(int columnIndex,
InputStream inputStream)
throws SQLException Обновляет указанный столбец с помощью заданного потока ввода. Данные будут считываться из потока по мере необходимости до достижения конца потока.
Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации своего JDBC-драйвера, чтобы определить, может ли использование версии updateBlob с параметром длины быть более эффективным.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и т. д. -
inputStream- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конвейность набора результатов являетсяCONCUR_READ_ONLY, или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
updateBlob
void updateBlob(String columnLabel,
InputStream inputStream)
throws SQLException Обновляет указанный столбец с помощью заданного потока ввода. Данные будут считываться из потока по мере необходимости до достижения конца потока.
Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации своего JDBC-драйвера, чтобы определить, может ли использование версии updateBlob с параметром длины быть более эффективным.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, меткой является имя столбца -
inputStream- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; если конвейность набора результатов являетсяCONCUR_READ_ONLY, или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
updateClob
void updateClob(int columnIndex,
Reader reader)
throws SQLException Обновляет указанный столбец с помощью заданного объекта Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. JDBC-драйвер выполнит необходимые преобразования из UNICODE в формат символов базы данных.
Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации своего JDBC-драйвера, чтобы определить, может ли использование версии updateClob с параметром длины быть более эффективным.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и т. д. -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex некорректен; если произошла ошибка доступа к базе данных; если конвейность набора результатов являетсяCONCUR_READ_ONLY, или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
updateClob
void updateClob(String columnLabel,
Reader reader)
throws SQLException Обновляет указанный столбец с помощью заданного объекта Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. JDBC-драйвер выполнит необходимые преобразования из UNICODE в формат символов базы данных.
Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации своего JDBC-драйвера, чтобы определить, может ли использование версии updateClob с параметром длины быть более эффективным.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, меткой является имя столбца -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnLabel некорректен; если произошла ошибка доступа к базе данных; если конвейность набора результатов являетсяCONCUR_READ_ONLY, или этот метод был вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
updateNClob
void updateNClob(int columnIndex,
Reader reader)
throws SQLException Обновляет указанный столбец с помощью заданного объекта Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. JDBC-драйвер выполнит необходимые преобразования из UNICODE в формат символов базы данных.
Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации своего JDBC-драйвера, чтобы определить, может ли использование версии updateNClob с параметром длины быть более эффективным.
- Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и т. д. -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnIndex некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод был вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конвейность набора результатов являетсяCONCUR_READ_ONLY. -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
updateNClob
void updateNClob(String columnLabel,
Reader reader)
throws SQLException Обновляет указанный столбец с помощью заданного объекта Reader. Данные будут считываться из потока по мере необходимости до достижения конца потока. JDBC-драйвер выполнит необходимые преобразования из UNICODE в формат символов базы данных.
Методы обновлителей используются для обновления значений столбцов в текущей строке или строке вставки. Методы обновления не обновляют базу данных напрямую; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Примечание: Обратитесь к документации своего JDBC-драйвера, чтобы определить, может ли использование версии updateNClob с параметром длины быть более эффективным.
- Параметры:
-
columnLabel- метка для столбца, указанного в предложении SQL AS. Если предложение SQL AS не указано, меткой является имя столбца -
reader- объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException- если columnLabel некорректен; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; этот метод был вызван для закрытого набора результатов; если произошла ошибка доступа к базе данных или конвейность набора результатов являетсяCONCUR_READ_ONLY. -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.6
getObject
<T> T getObject(int columnIndex,
Class<T> type)
throws SQLException Извлекает значение указанного столбца в текущей строке объекта ResultSet и преобразует его из SQL-типа столбца в запрошенный тип данных Java, если преобразование поддерживается. Если преобразование не поддерживается или для типа задано значение null, выбрасывается SQLException.
Как минимум, реализация должна поддерживать преобразования, определенные в Приложении B, Таблица B-3, и преобразование соответствующих пользовательских SQL-типов в тип Java, который реализует SQLData, или Struct. Дополнительные преобразования могут быть поддерживаемыми и определены поставщиком.
- Параметры типа:
-
T- тип класса, моделируемого этим объектом Class - Параметры:
-
columnIndex- первый столбец имеет индекс 1, второй — 2 и т. д. -
type- класс, представляющий тип данных Java для преобразования указанного столбца. - Возвращает:
- экземпляр
type, содержащий значение столбца - Исключения:
-
SQLException- если преобразование не поддерживается, тип равен null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С момента:
- 1.7
getObject
<T> T getObject(String columnLabel,
Class<T> type)
throws SQLException Извлекает значение указанного столбца в текущей строке объекта ResultSet и преобразует его из SQL-типа столбца в запрошенный тип данных Java, если преобразование поддерживается. Если преобразование не поддерживается или для типа задано значение null, выбрасывается SQLException.
Как минимум, реализация должна поддерживать преобразования, определенные в Приложении B, Таблица B-3, и преобразование соответствующих пользовательских SQL-типов в тип Java, который реализует SQLData, или Struct. Дополнительные преобразования могут быть поддерживаемыми и определены поставщиком.
- Параметры типа:
-
T- тип класса, моделируемого этим объектом Class - Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если SQL-оператор AS не был указан, метка — это имя столбца -
type- класс, представляющий тип данных Java, для преобразования указанного столбца. - Возвращает:
- экземпляр
type, содержащий значение столбца - Исключения:
-
SQLException- если преобразование не поддерживается, тип равен null или произошла другая ошибка. Метод getCause() исключения может предоставить более подробное исключение, например, если произошла ошибка преобразования -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод - С:
- 1.7
updateObject
default void updateObject(int columnIndex,
Object x,
SQLType targetSqlType,
int scaleOrLength)
throws SQLException Обновляет указанный столбец значением Object. Методы апдейта используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Если второй аргумент — InputStream, то поток должен содержать количество байтов, указанное в scaleOrLength. Если второй аргумент — Reader, то поток должен содержать количество символов, указанное в scaleOrLength. Если эти условия не выполнены, драйвер сгенерирует SQLException при выполнении запроса.
Реализация по умолчанию выбросит SQLFeatureNotSupportedException
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
targetSqlType- тип SQL, который будет отправлен в базу данных -
scaleOrLength- для объектаjava.math.BigDecimal, это количество цифр после десятичной точки. Для типов Java ObjectInputStreamиReader, это длина данных в потоке или потоке чтения. Для всех остальных типов это значение будет проигнорировано. - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; параллельность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод; если JDBC-драйвер не поддерживает указанный targetSqlType - С:
- 1.8
- См. также:
-
JDBCType,SQLType
updateObject
default void updateObject(String columnLabel,
Object x,
SQLType targetSqlType,
int scaleOrLength)
throws SQLException Обновляет указанный столбец значением Object. Методы апдейта используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Если второй аргумент — InputStream, то поток должен содержать количество байтов, указанное в scaleOrLength. Если второй аргумент — Reader, то поток должен содержать количество символов, указанное в scaleOrLength. Если эти условия не выполнены, драйвер сгенерирует SQLException при выполнении запроса.
Реализация по умолчанию выбросит SQLFeatureNotSupportedException
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если SQL-оператор AS не был указан, метка — это имя столбца -
x- новое значение столбца -
targetSqlType- тип SQL, который будет отправлен в базу данных -
scaleOrLength- для объектаjava.math.BigDecimal, это количество цифр после десятичной точки. Для типов Java ObjectInputStreamиReader, это длина данных в потоке или потоке чтения. Для всех остальных типов это значение будет проигнорировано. - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; параллельность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод; если JDBC-драйвер не поддерживает указанный targetSqlType - С:
- 1.8
- См. также:
-
JDBCType,SQLType
updateObject
default void updateObject(int columnIndex,
Object x,
SQLType targetSqlType)
throws SQLException Обновляет указанный столбец значением Object. Методы апдейта используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Реализация по умолчанию выбросит SQLFeatureNotSupportedException
- Параметры:
-
columnIndex- первый столбец — 1, второй — 2 и т. д. -
x- новое значение столбца -
targetSqlType- тип SQL, который будет отправлен в базу данных - Исключения:
-
SQLException- если columnIndex недействителен; если произошла ошибка доступа к базе данных; параллельность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод; если JDBC-драйвер не поддерживает указанный targetSqlType - С:
- 1.8
- См. также:
-
JDBCType,SQLType
updateObject
default void updateObject(String columnLabel,
Object x,
SQLType targetSqlType)
throws SQLException Обновляет указанный столбец значением Object. Методы апдейта используются для обновления значений столбцов в текущей строке или строке вставки. Методы апдейта не обновляют базу данных; вместо этого вызываются методы updateRow или insertRow для обновления базы данных.
Реализация по умолчанию выбросит SQLFeatureNotSupportedException
- Параметры:
-
columnLabel- метка столбца, указанная в SQL-оператор AS. Если SQL-оператор AS не был указан, метка — это имя столбца -
x- новое значение столбца -
targetSqlType- тип SQL, который будет отправлен в базу данных - Исключения:
-
SQLException- если columnLabel недействителен; если произошла ошибка доступа к базе данных; параллельность набора результатов —CONCUR_READ_ONLYили этот метод вызван для закрытого набора результатов -
SQLFeatureNotSupportedException- если JDBC-драйвер не поддерживает этот метод; если JDBC-драйвер не поддерживает указанный targetSqlType - С:
- 1.8
- См. также:
-
JDBCType,SQLType
© 1993, 2020, 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.