Интерфейс RowSet
- Все суперинтерфейсы:
AutoCloseable, ResultSet, Wrapper
- Все известные подинтерфейсы:
CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet
public interface RowSet extends ResultSet
Интерфейс RowSet предоставляет набор свойств JavaBeans, позволяющих настроить экземпляр RowSet для подключения к источнику данных JDBC и чтения данных из этого источника. Группа методов установки значений (setInt, setBytes, setString и так далее) позволяет передавать входные параметры свойству команды набора строк. Эта команда представляет собой запрос SQL, который набор строк использует для получения данных из реляционной базы данных, как это обычно и происходит.
Интерфейс RowSet поддерживает события JavaBeans, позволяя другим компонентам приложения получать уведомления о событиях, происходящих с набором строк, например об изменении его значения.
Интерфейс RowSet уникален тем, что его предполагается реализовывать с использованием остальных средств API JDBC. Иными словами, реализация RowSet — это программный слой, работающий «поверх» драйвера JDBC. Реализации интерфейса RowSet может предоставлять кто угодно, включая поставщиков драйверов JDBC, желающих включить реализацию RowSet в состав своих продуктов JDBC.
Объект RowSet может устанавливать соединение с источником данных и поддерживать его в течение всего жизненного цикла; в этом случае такой набор строк называется подключённым. Набор строк также может установить соединение с источником данных, получить из него данные, а затем закрыть соединение. Такой набор строк называется отключённым. Отключённый набор строк может изменять данные, пока соединение отсутствует, а затем отправить изменения обратно в исходный источник данных, но для этого ему необходимо повторно установить соединение.
С отключённым набором строк могут быть связаны Reader (объект RowSetReader) и средство записи (объект RowSetWriter). Reader можно реализовать множеством различных способов для заполнения набора строк данными, в том числе для получения данных из нереляционного источника. Средство записи также можно реализовать различными способами, чтобы передавать изменения данных набора строк обратно в базовый источник данных.
Наборы строк просты в использовании. Интерфейс RowSet расширяет стандартный интерфейс java.sql.ResultSet. Интерфейс RowSetMetaData расширяет интерфейс java.sql.ResultSetMetaData. Поэтому разработчикам, знакомым с API JDBC, потребуется освоить лишь минимальное количество новых API, чтобы использовать наборы строк. Кроме того, сторонние программные средства, работающие с объектами JDBC ResultSet, также будет легко адаптировать для работы с наборами строк.
- Начиная с:
- 1.4
Краткое описание полей
Поля, объявленные в интерфейсе ResultSet
CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE | Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
CLOSE_CURSORS_AT_COMMIT |
Константа, указывающая, что открытые объекты ResultSet с такой возможностью удержания будут закрыты при фиксации текущей транзакции. |
static final int |
CONCUR_READ_ONLY |
Константа, указывающая режим конкурентного доступа для объекта ResultSet, который НЕ может быть обновлён. |
static final int |
CONCUR_UPDATABLE |
Константа, указывающая режим конкурентного доступа для объекта ResultSet, который может быть обновлён. |
static final int |
FETCH_FORWARD |
Константа, указывающая, что строки в результирующем наборе будут обрабатываться в прямом направлении: от первой к последней. |
static final int |
FETCH_REVERSE |
Константа, указывающая, что строки в результирующем наборе будут обрабатываться в обратном направлении: от последней к первой. |
static final int |
FETCH_UNKNOWN |
Константа, указывающая, что порядок обработки строк в результирующем наборе неизвестен. |
static final int |
HOLD_CURSORS_OVER_COMMIT |
Константа, указывающая, что открытые объекты ResultSet с такой возможностью удержания останутся открытыми при фиксации текущей транзакции. |
static final int |
TYPE_FORWARD_ONLY |
Константа, указывающая тип объекта ResultSet, курсор которого может перемещаться только вперёд. |
static final int |
TYPE_SCROLL_INSENSITIVE |
Константа, указывающая тип прокручиваемого объекта ResultSet, который обычно не чувствителен к изменениям данных, лежащих в основе ResultSet. |
static final int |
TYPE_SCROLL_SENSITIVE |
Константа, указывающая тип прокручиваемого объекта ResultSet, который обычно чувствителен к изменениям данных, лежащих в основе ResultSet. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addRowSetListener |
Регистрирует указанный слушатель, чтобы он получал уведомления о событиях, происходящих с этим объектом RowSet. |
void |
clearParameters() |
Очищает параметры, заданные для команды этого объекта RowSet. |
void |
execute() |
Заполняет этот объект RowSet данными. |
String |
getCommand() |
Возвращает свойство команды этого объекта RowSet. |
String |
getDataSourceName() |
Возвращает логическое имя, идентифицирующее источник данных для этого объекта RowSet. |
boolean |
getEscapeProcessing() |
Возвращает информацию о том, включена ли обработка escape-последовательностей для этого объекта RowSet. |
int |
getMaxFieldSize() |
Возвращает максимальное количество байтов, которое может быть возвращено для значений определённых столбцов. |
int |
getMaxRows() |
Возвращает максимальное количество строк, которое может содержать этот объект RowSet. |
String |
getPassword() |
Возвращает пароль, использованный для создания подключения к базе данных. |
int |
getQueryTimeout() |
Возвращает максимальное количество секунд, в течение которого драйвер будет ожидать выполнения оператора. |
int |
getTransactionIsolation() |
Возвращает уровень изоляции транзакций, заданный для этого объекта RowSet. |
Map |
getTypeMap() |
Возвращает объект Map, связанный с этим объектом RowSet, который задаёт пользовательское сопоставление типов SQL, определённых пользователем, если оно имеется. |
String |
getUrl() |
Возвращает свойство url, которое этот объект RowSet будет использовать для создания подключения, если для установки подключения он использует DriverManager вместо объекта DataSource. |
String |
getUsername() |
Возвращает имя пользователя, использованное для создания подключения к базе данных для этого объекта RowSet. |
boolean |
isReadOnly() |
Возвращает информацию о том, доступен ли этот объект RowSet только для чтения. |
void |
removeRowSetListener |
Удаляет указанный слушатель из списка компонентов, которые будут получать уведомления при возникновении события с этим объектом RowSet. |
void |
setArray |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Array. |
void |
setAsciiStream |
Задаёт указанный параметр в команде этого объекта RowSet с помощью заданного входного потока. |
void |
setAsciiStream |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.io.InputStream. |
void |
setAsciiStream |
Задаёт указанный параметр с помощью заданного входного потока. |
void |
setAsciiStream |
Задаёт указанный параметр с помощью заданного входного потока, содержащего указанное количество байтов. |
void |
setBigDecimal |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.math.BigDecimal. |
void |
setBigDecimal |
Задаёт указанный параметр заданным значением java.math.BigDecimal. |
void |
setBinaryStream |
Задаёт указанный параметр в команде этого объекта RowSet с помощью заданного входного потока. |
void |
setBinaryStream |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.io.InputStream. |
void |
setBinaryStream |
Задаёт указанный параметр с помощью заданного входного потока. |
void |
setBinaryStream |
Задаёт указанный параметр с помощью заданного входного потока, содержащего указанное количество байтов. |
void |
setBlob |
Задаёт указанный параметр объектом InputStream. |
void |
setBlob |
Задаёт указанный параметр объектом InputStream. |
void |
setBlob |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Blob. |
void |
setBlob |
Задаёт указанный параметр объектом InputStream. |
void |
setBlob |
Задаёт указанный параметр объектом InputStream. |
void |
setBlob |
Задаёт указанный параметр заданным объектом java.sql.Blob. |
void |
setBoolean |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java boolean. |
void |
setBoolean |
Задаёт указанный параметр заданным значением Java boolean. |
void |
setByte |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java byte. |
void |
setByte |
Задаёт указанный параметр заданным значением Java byte. |
void |
setBytes |
Задаёт указанный параметр в команде этого объекта RowSet заданным массивом Java значений byte. |
void |
setBytes |
Задаёт указанный параметр заданным массивом байтов Java. |
void |
setCharacterStream |
Задаёт указанный параметр в команде этого объекта RowSet заданным объектом Reader. |
void |
setCharacterStream |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.io.Reader. |
void |
setCharacterStream |
Задаёт указанный параметр заданным объектом Reader. |
void |
setCharacterStream |
Задаёт указанный параметр заданным объектом Reader указанной длины в символах. |
void |
setClob |
Задаёт указанный параметр объектом Reader. |
void |
setClob |
Задаёт указанный параметр объектом Reader. |
void |
setClob |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Clob. |
void |
setClob |
Задаёт указанный параметр объектом Reader. |
void |
setClob |
Задаёт указанный параметр объектом Reader. |
void |
setClob |
Задаёт указанный параметр заданным объектом java.sql.Clob. |
void |
setCommand |
Задаёт свойство команды этого объекта RowSet указанным SQL-запросом. |
void |
setConcurrency |
Задаёт для этого объекта RowSet указанный уровень конкурентного доступа. |
void |
setDataSourceName |
Задаёт свойство имени источника данных для этого объекта RowSet указанным значением String. |
void |
setDate |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.sql.Date. |
void |
setDate |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.sql.Date. |
void |
setDate |
Задаёт указанный параметр заданным значением java.sql.Date, используя часовой пояс виртуальной машины, на которой выполняется приложение. |
void |
setDate |
Задаёт указанный параметр заданным значением java.sql.Date, используя указанный объект Calendar. |
void |
setDouble |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java double. |
void |
setDouble |
Задаёт указанный параметр заданным значением Java double. |
void |
setEscapeProcessing |
Включает или отключает обработку escape-последовательностей для этого объекта RowSet. |
void |
setFloat |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java float. |
void |
setFloat |
Задаёт указанный параметр заданным значением Java float. |
void |
setInt |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java int. |
void |
setInt |
Задаёт указанный параметр заданным значением Java int. |
void |
setLong |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java long. |
void |
setLong |
Задаёт указанный параметр заданным значением Java long. |
void |
setMaxFieldSize |
Задаёт максимальное количество байтов, возвращаемых для значения столбца, указанным количеством байтов. |
void |
setMaxRows |
Задаёт для этого объекта RowSet максимальное количество строк, которое он может содержать. |
void |
setNCharacterStream |
Задаёт указанный параметр в команде этого объекта RowSet объектом Reader. |
void |
setNCharacterStream |
Задаёт указанный параметр объектом Reader. |
void |
setNCharacterStream |
Задаёт указанный параметр объектом Reader. |
void |
setNCharacterStream |
Задаёт указанный параметр объектом Reader. |
void |
setNClob |
Задаёт указанный параметр объектом Reader. |
void |
setNClob |
Задаёт указанный параметр объектом Reader. |
void |
setNClob |
Задаёт указанный параметр объектом java.sql.NClob. |
void |
setNClob |
Задаёт указанный параметр объектом Reader. |
void |
setNClob |
Задаёт указанный параметр объектом Reader. |
void |
setNClob |
Задаёт указанный параметр объектом java.sql.NClob. |
void |
setNString |
Задаёт указанный параметр заданным объектом String. |
void |
setNString |
Задаёт указанный параметр заданным объектом String. |
void |
setNull |
Задаёт указанный параметр в SQL-команде этого объекта RowSet значением SQL NULL. |
void |
setNull |
Задаёт указанный параметр в SQL-команде этого объекта RowSet значением SQL NULL. |
void |
setNull |
Задаёт указанный параметр значением SQL NULL. |
void |
setNull |
Задаёт указанный параметр значением SQL NULL. |
void |
setObject |
Задаёт указанный параметр в команде этого объекта RowSet с помощью Java Object. |
void |
setObject |
Задаёт указанный параметр в команде этого объекта RowSet с помощью Java Object. |
void |
setObject |
Задаёт указанный параметр в команде этого объекта RowSet с помощью заданного значения Java Object. |
void |
setObject |
Задаёт значение указанного параметра заданным объектом. |
void |
setObject |
Задаёт значение указанного параметра заданным объектом. |
void |
setObject |
Задаёт значение указанного параметра заданным объектом. |
void |
setPassword |
Задаёт пароль базы данных для этого объекта RowSet указанным значением String. |
void |
setQueryTimeout |
Задаёт максимальное время ожидания выполнения оператора драйвером указанным количеством секунд. |
void |
setReadOnly |
Задаёт, доступен ли этот объект RowSet только для чтения, указанным значением boolean. |
void |
setRef |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Ref. |
void |
setRowId |
Задаёт указанный параметр заданным объектом java.sql.RowId. |
void |
setRowId |
Задаёт указанный параметр заданным объектом java.sql.RowId. |
void |
setShort |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java short. |
void |
setShort |
Задаёт указанный параметр заданным значением Java short. |
void |
setSQLXML |
Задаёт указанный параметр заданным объектом java.sql.SQLXML. |
void |
setSQLXML |
Задаёт указанный параметр заданным объектом java.sql.SQLXML. |
void |
setString |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением Java String. |
void |
setString |
Задаёт указанный параметр заданным значением Java String. |
void |
setTime |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.sql.Time. |
void |
setTime |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.sql.Time. |
void |
setTime |
Задаёт указанный параметр заданным значением java.sql.Time. |
void |
setTime |
Задаёт указанный параметр заданным значением java.sql.Time, используя указанный объект Calendar. |
void |
setTimestamp |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.sql.Timestamp. |
void |
setTimestamp |
Задаёт указанный параметр в команде этого объекта RowSet заданным значением java.sql.Timestamp. |
void |
setTimestamp |
Задаёт указанный параметр заданным значением java.sql.Timestamp. |
void |
setTimestamp |
Задаёт указанный параметр заданным значением java.sql.Timestamp, используя указанный объект Calendar. |
void |
setTransactionIsolation |
Задаёт уровень изоляции транзакций для этого объекта RowSet. |
void |
setType |
Задаёт тип этого объекта RowSet указанным типом. |
void |
setTypeMap |
Устанавливает указанный объект java.util.Map в качестве карты типов по умолчанию для этого объекта RowSet. |
void |
setUrl |
Задаёт URL, который этот объект RowSet будет использовать при создании подключения с помощью DriverManager. |
void |
setURL |
Задаёт указанный параметр заданным значением java.net.URL. |
void |
setUsername |
Задаёт свойство имени пользователя для этого объекта RowSet указанным значением String. |
Методы, объявленные в интерфейсе ResultSet
absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull | Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
absolute |
Перемещает курсор на указанную строку в этом объекте ResultSet. |
void |
afterLast() |
Перемещает курсор в конец этого объекта ResultSet, сразу за последнюю строку. |
void |
beforeFirst() |
Перемещает курсор в начало этого объекта ResultSet, прямо перед первой строкой. |
void |
cancelRowUpdates() |
Отменяет изменения, внесенные в текущую строку этого объекта ResultSet. |
void |
clearWarnings() |
Очищает все предупреждения, зарегистрированные для этого объекта ResultSet. |
void |
close() |
Немедленно освобождает ресурсы базы данных и JDBC этого объекта ResultSet вместо того, чтобы ждать автоматического закрытия. |
void |
deleteRow() |
Удаляет текущую строку из этого объекта ResultSet и из базовой базы данных. |
int |
findColumn |
Сопоставляет указанную метку столбца ResultSet с его индексом столбца ResultSet. |
boolean |
first() |
Перемещает курсор на первую строку этого объекта ResultSet. |
Array |
getArray |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Array в языке программирования Java. |
Array |
getArray |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Array в языке программирования Java. |
InputStream |
getAsciiStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока символов ASCII. |
InputStream |
getAsciiStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока символов ASCII. |
BigDecimal |
getBigDecimal |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как java.math.BigDecimal с полной точностью. |
BigDecimal |
getBigDecimal |
Устарело. |
BigDecimal |
getBigDecimal |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как java.math.BigDecimal с полной точностью. |
BigDecimal |
getBigDecimal |
Устарело. Используйте getBigDecimal(int columnIndex) или getBigDecimal(String columnLabel)
|
InputStream |
getBinaryStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока необработанных байтов. |
InputStream |
getBinaryStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet в виде потока необработанных символов byte. |
Blob |
getBlob |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Blob в языке программирования Java. |
Blob |
getBlob |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Blob в языке программирования Java. |
boolean |
getBoolean |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как boolean в языке программирования Java. |
boolean |
getBoolean |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как boolean в языке программирования Java. |
byte |
getByte |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как byte в языке программирования Java. |
byte |
getByte |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как byte в языке программирования Java. |
byte[] |
getBytes |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как массив byte в языке программирования Java. |
byte[] |
getBytes |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как массив byte в языке программирования Java. |
Reader |
getCharacterStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader. |
Reader |
getCharacterStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader. |
Clob |
getClob |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Clob в языке программирования Java. |
Clob |
getClob |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Clob в языке программирования Java. |
int |
getConcurrency() |
Возвращает режим параллелизма этого объекта ResultSet. |
String |
getCursorName() |
Возвращает имя курсора SQL, используемого этим объектом ResultSet. |
Date |
getDate |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date в языке программирования Java. |
Date |
getDate |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date в языке программирования Java. |
Date |
getDate |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date в языке программирования Java. |
Date |
getDate |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Date в языке программирования Java. |
double |
getDouble |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как double в языке программирования Java. |
double |
getDouble |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как double в языке программирования Java. |
int |
getFetchDirection() |
Возвращает направление извлечения данных для этого объекта ResultSet. |
int |
getFetchSize() |
Возвращает размер выборки для этого объекта ResultSet. |
float |
getFloat |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как float в языке программирования Java. |
float |
getFloat |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как float в языке программирования Java. |
int |
getHoldability() |
Возвращает режим удержания этого объекта ResultSet |
int |
getInt |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как int в языке программирования Java. |
int |
getInt |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как int в языке программирования Java. |
long |
getLong |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как long в языке программирования Java. |
long |
getLong |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как long в языке программирования Java. |
ResultSetMetaData |
getMetaData() |
Возвращает количество, типы и свойства столбцов этого объекта ResultSet. |
Reader |
getNCharacterStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader. |
Reader |
getNCharacterStream |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.io.Reader. |
NClob |
getNClob |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект NClob в языке программирования Java. |
NClob |
getNClob |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект NClob в языке программирования Java. |
String |
getNString |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как String в языке программирования Java. |
String |
getNString |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как String в языке программирования Java. |
Object |
getObject |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как Object в языке программирования Java. |
<T> T |
getObject |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует тип SQL столбца в запрошенный тип данных Java, если такое преобразование поддерживается. |
Object |
getObject |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как Object в языке программирования Java. |
Object |
getObject |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как Object в языке программирования Java. |
<T> T |
getObject |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet и преобразует тип SQL столбца в запрошенный тип данных Java, если такое преобразование поддерживается. |
Object |
getObject |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как Object в языке программирования Java. |
Ref |
getRef |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Ref в языке программирования Java. |
Ref |
getRef |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект Ref в языке программирования Java. |
int |
getRow() |
Возвращает номер текущей строки. |
RowId |
getRowId |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.RowId в языке программирования Java. |
RowId |
getRowId |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.RowId в языке программирования Java. |
short |
getShort |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как short в языке программирования Java. |
short |
getShort |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как short в языке программирования Java. |
SQLXML |
getSQLXML |
Возвращает значение указанного столбца в текущей строке этого ResultSet как объект java.sql.SQLXML в языке программирования Java. |
SQLXML |
getSQLXML |
Возвращает значение указанного столбца в текущей строке этого ResultSet как объект java.sql.SQLXML в языке программирования Java. |
Statement |
getStatement() |
Возвращает объект Statement, создавший этот объект ResultSet. |
String |
getString |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как String в языке программирования Java. |
String |
getString |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как String в языке программирования Java. |
Time |
getTime |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Time в языке программирования Java. |
Time |
getTime |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Time в языке программирования Java. |
Time |
getTime |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Time в языке программирования Java. |
Time |
getTime |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Time в языке программирования Java. |
Timestamp |
getTimestamp |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Timestamp в языке программирования Java. |
Timestamp |
getTimestamp |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Timestamp в языке программирования Java. |
Timestamp |
getTimestamp |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Timestamp в языке программирования Java. |
Timestamp |
getTimestamp |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.sql.Timestamp в языке программирования Java. |
int |
getType() |
Возвращает тип этого объекта ResultSet. |
InputStream |
getUnicodeStream |
Устарело. используйте getCharacterStream вместо getUnicodeStream
|
InputStream |
getUnicodeStream |
Устарело. используйте getCharacterStream вместо него |
URL |
getURL |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.net.URL в языке программирования Java. |
URL |
getURL |
Возвращает значение указанного столбца в текущей строке этого объекта ResultSet как объект java.net.URL в языке программирования Java. |
SQLWarning |
getWarnings() |
Возвращает первое предупреждение, зарегистрированное при вызовах этого объекта ResultSet. |
void |
insertRow() |
Вставляет содержимое строки вставки в этот объект ResultSet и в базу данных. |
boolean |
isAfterLast() |
Возвращает, находится ли курсор после последней строки этого объекта ResultSet. |
boolean |
isBeforeFirst() |
Возвращает, находится ли курсор перед первой строкой этого объекта ResultSet. |
boolean |
isClosed() |
Возвращает, закрыт ли этот объект ResultSet. |
boolean |
isFirst() |
Возвращает, находится ли курсор на первой строке этого объекта ResultSet. |
boolean |
isLast() |
Возвращает, находится ли курсор на последней строке этого объекта ResultSet. |
boolean |
last() |
Перемещает курсор на последнюю строку этого объекта ResultSet. |
void |
moveToCurrentRow() |
Перемещает курсор в сохраненную позицию, обычно на текущую строку. |
void |
moveToInsertRow() |
Перемещает курсор на строку вставки. |
boolean |
next() |
Перемещает курсор на одну строку вперед от текущей позиции. |
boolean |
previous() |
Перемещает курсор на предыдущую строку этого объекта ResultSet. |
void |
refreshRow() |
Обновляет текущую строку, используя ее последнее значение в базе данных. |
boolean |
relative |
Перемещает курсор на относительное число строк в положительном или отрицательном направлении. |
boolean |
rowDeleted() |
Возвращает, была ли удалена строка. |
boolean |
rowInserted() |
Возвращает, была ли вставлена текущая строка. |
boolean |
rowUpdated() |
Возвращает, была ли обновлена текущая строка. |
void |
setFetchDirection |
Подсказывает направление обработки строк в этом объекте ResultSet. |
void |
setFetchSize |
Подсказывает драйверу JDBC количество строк, которое следует извлечь из базы данных, когда для этого объекта ResultSet потребуются дополнительные строки. |
void |
updateArray |
Обновляет указанный столбец значением java.sql.Array. |
void |
updateArray |
Обновляет указанный столбец значением java.sql.Array. |
void |
updateAsciiStream |
Обновляет указанный столбец значением из потока ASCII. |
void |
updateAsciiStream |
Обновляет указанный столбец значением из потока ASCII указанной длины в байтах. |
void |
updateAsciiStream |
Обновляет указанный столбец значением из потока ASCII указанной длины в байтах. |
void |
updateAsciiStream |
Обновляет указанный столбец значением из потока ASCII. |
void |
updateAsciiStream |
Обновляет указанный столбец значением из потока ASCII указанной длины в байтах. |
void |
updateAsciiStream |
Обновляет указанный столбец значением из потока ASCII указанной длины в байтах. |
void |
updateBigDecimal |
Обновляет указанный столбец значением java.math.BigDecimal. |
void |
updateBigDecimal |
Обновляет указанный столбец значением java.sql.BigDecimal. |
void |
updateBinaryStream |
Обновляет указанный столбец значением из двоичного потока. |
void |
updateBinaryStream |
Обновляет указанный столбец значением из двоичного потока указанной длины в байтах. |
void |
updateBinaryStream |
Обновляет указанный столбец значением из двоичного потока указанной длины в байтах. |
void |
updateBinaryStream |
Обновляет указанный столбец значением из двоичного потока. |
void |
updateBinaryStream |
Обновляет указанный столбец значением из двоичного потока указанной длины в байтах. |
void |
updateBinaryStream |
Обновляет указанный столбец значением из двоичного потока указанной длины в байтах. |
void |
updateBlob |
Обновляет указанный столбец, используя заданный входной поток. |
void |
updateBlob |
Обновляет указанный столбец, используя заданный входной поток указанной длины в байтах. |
void |
updateBlob |
Обновляет указанный столбец значением java.sql.Blob. |
void |
updateBlob |
Обновляет указанный столбец, используя заданный входной поток. |
void |
updateBlob |
Обновляет указанный столбец, используя заданный входной поток указанной длины в байтах. |
void |
updateBlob |
Обновляет указанный столбец значением java.sql.Blob. |
void |
updateBoolean |
Обновляет указанную колонку значением boolean. |
void |
updateBoolean |
Обновляет указанную колонку значением boolean. |
void |
updateByte |
Обновляет указанную колонку значением byte. |
void |
updateByte |
Обновляет указанную колонку значением byte. |
void |
updateBytes |
Обновляет указанную колонку значением массива byte. |
void |
updateBytes |
Обновляет указанную колонку значением массива байтов. |
void |
updateCharacterStream |
Обновляет указанную колонку значением символьного потока. |
void |
updateCharacterStream |
Обновляет указанную колонку значением символьного потока, содержащего указанное количество байтов. |
void |
updateCharacterStream |
Обновляет указанную колонку значением символьного потока, содержащего указанное количество байтов. |
void |
updateCharacterStream |
Обновляет указанную колонку значением символьного потока. |
void |
updateCharacterStream |
Обновляет указанную колонку значением символьного потока, содержащего указанное количество байтов. |
void |
updateCharacterStream |
Обновляет указанную колонку значением символьного потока, содержащего указанное количество байтов. |
void |
updateClob |
Обновляет указанную колонку с помощью заданного объекта Reader. |
void |
updateClob |
Обновляет указанную колонку с помощью заданного объекта Reader, длина которого равна указанному количеству символов. |
void |
updateClob |
Обновляет указанную колонку значением java.sql.Clob. |
void |
updateClob |
Обновляет указанную колонку с помощью заданного объекта Reader. |
void |
updateClob |
Обновляет указанную колонку с помощью заданного объекта Reader, длина которого равна указанному количеству символов. |
void |
updateClob |
Обновляет указанную колонку значением java.sql.Clob. |
void |
updateDate |
Обновляет указанную колонку значением java.sql.Date. |
void |
updateDate |
Обновляет указанную колонку значением java.sql.Date. |
void |
updateDouble |
Обновляет указанную колонку значением double. |
void |
updateDouble |
Обновляет указанную колонку значением double. |
void |
updateFloat |
Обновляет указанную колонку значением float. |
void |
updateFloat |
Обновляет указанную колонку значением float. |
void |
updateInt |
Обновляет указанную колонку значением int. |
void |
updateInt |
Обновляет указанную колонку значением int. |
void |
updateLong |
Обновляет указанную колонку значением long. |
void |
updateLong |
Обновляет указанную колонку значением long. |
void |
updateNCharacterStream |
Обновляет указанную колонку значением символьного потока. |
void |
updateNCharacterStream |
Обновляет указанную колонку значением символьного потока, содержащего указанное количество байтов. |
void |
updateNCharacterStream |
Обновляет указанную колонку значением символьного потока. |
void |
updateNCharacterStream |
Обновляет указанную колонку значением символьного потока, содержащего указанное количество байтов. |
void |
updateNClob |
Обновляет указанную колонку с помощью заданного Reader Данные будут считываться из потока по мере необходимости до достижения конца потока. |
void |
updateNClob |
Обновляет указанную колонку с помощью заданного объекта Reader, длина которого равна указанному количеству символов. |
void |
updateNClob |
Обновляет указанную колонку значением java.sql.NClob. |
void |
updateNClob |
Обновляет указанную колонку с помощью заданного объекта Reader. |
void |
updateNClob |
Обновляет указанную колонку с помощью заданного объекта Reader, длина которого равна указанному количеству символов. |
void |
updateNClob |
Обновляет указанную колонку значением java.sql.NClob. |
void |
updateNString |
Обновляет указанную колонку значением String. |
void |
updateNString |
Обновляет указанную колонку значением String. |
void |
updateNull |
Обновляет указанную колонку значением null. |
void |
updateNull |
Обновляет указанную колонку значением null. |
void |
updateObject |
Обновляет указанную колонку значением Object. |
void |
updateObject |
Обновляет указанную колонку значением Object. |
default void |
updateObject |
Обновляет указанную колонку значением Object. |
default void |
updateObject |
Обновляет указанную колонку значением Object. |
void |
updateObject |
Обновляет указанную колонку значением Object. |
void |
updateObject |
Обновляет указанную колонку значением Object. |
default void |
updateObject |
Обновляет указанную колонку значением Object. |
default void |
updateObject |
Обновляет указанную колонку значением Object. |
void |
updateRef |
Обновляет указанную колонку значением java.sql.Ref. |
void |
updateRef |
Обновляет указанную колонку значением java.sql.Ref. |
void |
updateRow() |
Обновляет базу данных, записывая в неё новое содержимое текущей строки этого объекта ResultSet. |
void |
updateRowId |
Обновляет указанную колонку значением RowId. |
void |
updateRowId |
Обновляет указанную колонку значением RowId. |
void |
updateShort |
Обновляет указанную колонку значением short. |
void |
updateShort |
Обновляет указанную колонку значением short. |
void |
updateSQLXML |
Обновляет указанную колонку значением java.sql.SQLXML. |
void |
updateSQLXML |
Обновляет указанную колонку значением java.sql.SQLXML. |
void |
updateString |
Обновляет указанную колонку значением String. |
void |
updateString |
Обновляет указанную колонку значением String. |
void |
updateTime |
Обновляет указанную колонку значением java.sql.Time. |
void |
updateTime |
Обновляет указанную колонку значением java.sql.Time. |
void |
updateTimestamp |
Обновляет указанную колонку значением java.sql.Timestamp. |
void |
updateTimestamp |
Обновляет указанную колонку значением java.sql.Timestamp. |
boolean |
wasNull() |
Сообщает, содержала ли последняя считанная колонка значение SQL NULL. |
Методы, объявленные в интерфейсе Wrapper
isWrapperFor, unwrap | Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
isWrapperFor |
Возвращает true, если этот объект реализует интерфейс, переданный в качестве аргумента, либо прямо или косвенно является оболочкой объекта, который его реализует. |
<T> T |
unwrap |
Возвращает объект, реализующий заданный интерфейс, чтобы обеспечить доступ к нестандартным методам или стандартным методам, не предоставляемым прокси-объектом. |
Подробное описание методов
getUrl
String getUrl() throws SQLException
RowSet будет использовать для создания соединения, если он использует DriverManager вместо объекта DataSource для установления соединения. Значение по умолчанию — null.- Возвращает:
- строку URL
- Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setUrl
void setUrl(String url) throws SQLException
RowSet будет использовать при создании соединения с помощью DriverManager. Установка этого свойства необязательна. Если используется URL, перед подключением набора строк к базе данных необходимо загрузить драйвер JDBC, принимающий этот URL. Набор строк будет использовать URL внутри для создания соединения с базой данных при чтении или записи данных. Для создания соединения используется либо URL, либо имя источника данных — то из них, для которого последним было задано ненулевое значение.- Параметры:
-
url— строковое значение; может быть равноnull - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getDataSourceName
String getDataSourceName()
RowSet.- Возвращает:
- имя источника данных
- См. также:
setDataSourceName
void setDataSourceName(String name) throws SQLException
RowSet, используя указанное значение String. Значение свойства имени источника данных можно использовать для поиска объекта DataSource, зарегистрированного в службе именования. После получения объект DataSource можно использовать для создания соединения с представляемым им источником данных.
- Параметры:
-
name— логическое имя источника данных для этого объектаRowSet; может быть равноnull - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getUsername
String getUsername()
RowSet. Свойство имени пользователя задается во время выполнения перед вызовом метода execute. Обычно оно не входит в сериализованное состояние объекта RowSet.- Возвращает:
- свойство имени пользователя
- См. также:
setUsername
void setUsername(String name) throws SQLException
RowSet указанное значение String.- Параметры:
-
name— имя пользователя - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getPassword
String getPassword()
execute. Обычно оно не входит в сериализованное состояние объекта RowSet.- Возвращает:
- пароль для создания соединения с базой данных
- См. также:
setPassword
void setPassword(String password) throws SQLException
RowSet указанное значение String.- Параметры:
-
password— строка пароля - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getTransactionIsolation
int getTransactionIsolation()
RowSet.- Возвращает:
- уровень изоляции транзакций: одно из значений
Connection.TRANSACTION_READ_UNCOMMITTED,Connection.TRANSACTION_READ_COMMITTED,Connection.TRANSACTION_REPEATABLE_READилиConnection.TRANSACTION_SERIALIZABLE - См. также:
setTransactionIsolation
void setTransactionIsolation(int level) throws SQLException
RowSet.- Параметры:
-
level— уровень изоляции транзакций: одно из значенийConnection.TRANSACTION_READ_UNCOMMITTED,Connection.TRANSACTION_READ_COMMITTED,Connection.TRANSACTION_REPEATABLE_READилиConnection.TRANSACTION_SERIALIZABLE - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getTypeMap
Map<String,Class<?>> getTypeMap() throws SQLException
Map, связанный с этим объектом RowSet, который задает пользовательское сопоставление типов SQL, определяемых пользователем, если оно имеется. По умолчанию карта типов пуста.- Возвращает:
- объект
java.util.Map, содержащий имена пользовательских типов SQL и классы Java, с которыми они сопоставляются - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setTypeMap
void setTypeMap(Map<String,Class<?>> map) throws SQLException
java.util.Map в качестве карты типов по умолчанию для этого объекта RowSet. Эта карта типов будет использоваться, если в качестве параметра метода не передана другая карта типов.- Параметры:
-
map— объектjava.util.Map, содержащий имена пользовательских типов SQL и классы Java, с которыми они сопоставляются - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getCommand
String getCommand()
RowSet. Свойство команды содержит строку команды, которая должна быть SQL-запросом, выполняемым для заполнения набора строк данными. Значение по умолчанию — null.- Возвращает:
- строку команды; может быть равно
null - См. также:
setCommand
void setCommand(String cmd) throws SQLException
RowSet указанный SQL-запрос. Это свойство необязательно, если набор строк получает данные из источника данных, не поддерживающего команды, например электронной таблицы.- Параметры:
-
cmd— SQL-запрос, используемый для получения данных для этого объектаRowSet; может быть равенnull - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
isReadOnly
boolean isReadOnly()
RowSet доступен только для чтения. Если обновления возможны, по умолчанию набор строк доступен для обновления. Попытка обновить набор строк, доступный только для чтения, приведет к выбросу SQLException.
- Возвращает:
-
true, если этот объектRowSetдоступен только для чтения;false, если он доступен для обновления - См. также:
setReadOnly
void setReadOnly(boolean value) throws SQLException
RowSet только для чтения указанным значением boolean.- Параметры:
-
value—true, если объект доступен только для чтения;false, если он доступен для обновления - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getMaxFieldSize
int getMaxFieldSize() throws SQLException
BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR и NVARCHAR. Если ограничение превышено, лишние данные незаметно отбрасываются.- Возвращает:
- текущее ограничение максимального размера столбца; ноль означает отсутствие ограничения
- Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setMaxFieldSize
void setMaxFieldSize(int max) throws SQLException
BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR и NVARCHAR. Если ограничение превышено, лишние данные незаметно отбрасываются. Для максимальной переносимости используйте значения больше 256.- Параметры:
-
max— новое ограничение максимального размера столбца в байтах; ноль означает отсутствие ограничения - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getMaxRows
int getMaxRows() throws SQLException
RowSet. Если ограничение превышено, лишние строки незаметно отбрасываются.- Возвращает:
- текущее максимальное количество строк, которое может содержать этот объект
RowSet; ноль означает отсутствие ограничения - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setMaxRows
void setMaxRows(int max) throws SQLException
RowSet, равным указанному числу. Если ограничение превышено, лишние строки незаметно отбрасываются.- Параметры:
-
max— новое максимальное количество строк; ноль означает отсутствие ограничения - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getEscapeProcessing
boolean getEscapeProcessing() throws SQLException
RowSet. Если сканирование escape-последовательностей включено (по умолчанию), драйвер выполнит замену escape-последовательностей перед отправкой SQL-оператора в базу данных.- Возвращает:
-
true, если обработка escape-последовательностей включена;false, если она отключена - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setEscapeProcessing
void setEscapeProcessing(boolean enable) throws SQLException
RowSet. Если сканирование escape-последовательностей включено (по умолчанию), драйвер выполнит их замену перед отправкой SQL-оператора в базу данных.- Параметры:
-
enable—true, чтобы включить обработку escape-последовательностей;false, чтобы отключить ее - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getQueryTimeout
int getQueryTimeout() throws SQLException
SQLException.- Возвращает:
- текущее ограничение времени ожидания запроса в секундах; ноль означает отсутствие ограничения
- Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setQueryTimeout
void setQueryTimeout(int seconds) throws SQLException
SQLException.- Параметры:
-
seconds— новое ограничение времени ожидания запроса в секундах; ноль означает отсутствие ограничения - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setType
void setType(int type) throws SQLException
RowSet равным указанному типу. Этот метод используется для изменения типа набора строк, который по умолчанию доступен только для чтения и не поддерживает прокрутку.- Параметры:
-
type— одна из константResultSet, задающих тип:ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVEилиResultSet.TYPE_SCROLL_SENSITIVE - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setConcurrency
void setConcurrency(int concurrency) throws SQLException
RowSet равным указанному уровню. Этот метод используется для изменения уровня параллелизма набора строк, который по умолчанию ResultSet.CONCUR_READ_ONLY
- Параметры:
-
concurrency— одна из константResultSet, задающих уровень параллелизма:ResultSet.CONCUR_READ_ONLYилиResultSet.CONCUR_UPDATABLE - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setNull
void setNull(int parameterIndex, int sqlType) throws SQLException
RowSet значение SQL NULL. Примечание: необходимо указать тип SQL параметра.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
sqlType— код типа SQL, определенный вjava.sql.Types - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных
setNull
void setNull(String parameterName, int sqlType) throws SQLException
NULL. Примечание: необходимо указать тип SQL параметра.
- Параметры:
-
parameterName— имя параметра -
sqlType— код типа SQL, определенный вjava.sql.Types - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с:
- 1.4
setNull
void setNull(int paramIndex, int sqlType, String typeName) throws SQLException
RowSet значение SQL NULL. Эту версию метода setNull следует использовать для пользовательских типов SQL (UDT) и параметров типа REF. Примеры UDT: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов. Примечание: для обеспечения переносимости приложения должны указывать код типа SQL и полное имя типа SQL при задании NULL для UDT или параметра REF. Для UDT именем является имя типа самого параметра. Для параметра REF именем является имя типа, на который он ссылается. Если драйверу JDBC не нужны сведения о коде типа или имени типа, он может их игнорировать. Хотя этот метод предназначен для параметров UDT и REF, его можно использовать для задания нулевого значения параметра любого типа JDBC. Если параметр не относится к пользовательскому типу или типу REF, параметр typeName игнорируется.
- Параметры:
-
paramIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
sqlType— значение изjava.sql.Types -
typeName— полное имя пользовательского типа SQL (UDT) или имя типа структурированного типа SQL, на который ссылается типREF; игнорируется, если параметр не относится к UDT или типуREF - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных
setNull
void setNull(String parameterName, int sqlType, String typeName) throws SQLException
NULL. Эту версию метода setNull следует использовать для пользовательских типов и параметров типа REF. Примеры пользовательских типов: STRUCT, DISTINCT, JAVA_OBJECT и именованные типы массивов. Примечание: для обеспечения переносимости приложения должны указывать код типа SQL и полное имя типа SQL при задании NULL для пользовательского параметра или параметра REF. Для пользовательского типа именем является имя типа самого параметра. Для параметра REF именем является имя типа, на который он ссылается. Если драйверу JDBC не нужны сведения о коде типа или имени типа, он может их игнорировать. Хотя этот метод предназначен для пользовательских параметров и параметров REF, его можно использовать для задания нулевого значения параметра любого типа JDBC. Если параметр не относится к пользовательскому типу или типу REF, указанное значение typeName игнорируется.
- Параметры:
-
parameterName— имя параметра -
sqlType— значение изjava.sql.Types -
typeName— полное имя пользовательского типа SQL; игнорируется, если параметр не является пользовательским типом или значением SQLREF - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с:
- 1.4
setBoolean
void setBoolean(int parameterIndex, boolean x) throws SQLException
RowSet указанное значение Java типа boolean. Перед отправкой в базу данных драйвер преобразует его в значение SQL типа BIT.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных
setBoolean
void setBoolean(String parameterName, boolean x) throws SQLException
boolean. При отправке в базу данных драйвер преобразует его в значение SQL типа BIT или BOOLEAN.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с:
- 1.4
- См. также:
setByte
void setByte(int parameterIndex, byte x) throws SQLException
RowSet указанное значение Java типа byte. Перед отправкой в базу данных драйвер преобразует его в значение SQL типа TINYINT.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных
setByte
void setByte(String parameterName, byte x) throws SQLException
byte. При отправке в базу данных драйвер преобразует его в значение SQL типа TINYINT.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с:
- 1.4
- См. также:
setShort
void setShort(int parameterIndex, short x) throws SQLException
RowSet указанное значение Java типа short. Перед отправкой в базу данных драйвер преобразует его в значение SQL типа SMALLINT.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных
setShort
void setShort(String parameterName, short x) throws SQLException
short. При отправке в базу данных драйвер преобразует его в значение SQL типа SMALLINT.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с:
- 1.4
- См. также:
setInt
void setInt(int parameterIndex, int x) throws SQLException
RowSet указанное значение Java типа int. Перед отправкой в базу данных драйвер преобразует его в значение SQL типа INTEGER.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных
setInt
void setInt(String parameterName, int x) throws SQLException
int. При отправке в базу данных драйвер преобразует его в значение SQL типа INTEGER.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с:
- 1.4
- См. также:
setLong
void setLong(int parameterIndex, long x) throws SQLException
RowSet в заданное значение Java long. Перед отправкой в базу данных драйвер преобразует его в значение SQL BIGINT.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setLong
void setLong(String parameterName, long x) throws SQLException
long. При отправке значения в базу данных драйвер преобразует его в значение SQL BIGINT.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setFloat
void setFloat(int parameterIndex, float x) throws SQLException
RowSet в заданное значение Java float. Перед отправкой в базу данных драйвер преобразует его в значение SQL REAL.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setFloat
void setFloat(String parameterName, float x) throws SQLException
float. При отправке значения в базу данных драйвер преобразует его в значение SQL FLOAT.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setDouble
void setDouble(int parameterIndex, double x) throws SQLException
RowSet в заданное значение Java double. Перед отправкой в базу данных драйвер преобразует его в значение SQL DOUBLE.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setDouble
void setDouble(String parameterName, double x) throws SQLException
double. При отправке значения в базу данных драйвер преобразует его в значение SQL DOUBLE.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setBigDecimal
void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException
RowSet в заданное значение java.math.BigDecimal. Перед отправкой в базу данных драйвер преобразует его в значение SQL NUMERIC.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setBigDecimal
void setBigDecimal(String parameterName, BigDecimal x) throws SQLException
java.math.BigDecimal. При отправке значения в базу данных драйвер преобразует его в значение SQL NUMERIC.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setString
void setString(int parameterIndex, String x) throws SQLException
RowSet в заданное значение Java String. Перед отправкой в базу данных драйвер преобразует его в значение SQL VARCHAR или LONGVARCHAR в зависимости от размера аргумента относительно ограничений драйвера на значения VARCHAR.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setString
void setString(String parameterName, String x) throws SQLException
String. При отправке значения в базу данных драйвер преобразует его в значение SQL VARCHAR или LONGVARCHAR (в зависимости от размера аргумента относительно ограничений драйвера на значения VARCHAR).- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setBytes
void setBytes(int parameterIndex, byte[] x) throws SQLException
RowSet в заданный массив значений Java byte. Перед отправкой в базу данных драйвер преобразует его в значение SQL VARBINARY или LONGVARBINARY в зависимости от размера аргумента относительно ограничений драйвера на значения VARBINARY.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setBytes
void setBytes(String parameterName, byte[] x) throws SQLException
VARBINARY или LONGVARBINARY (в зависимости от размера аргумента относительно ограничений драйвера на значения VARBINARY).- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setDate
void setDate(int parameterIndex, Date x) throws SQLException
RowSet в заданное значение java.sql.Date. Перед отправкой в базу данных драйвер преобразует его в значение SQL DATE, используя календарь java.util.Calendar по умолчанию для вычисления даты.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setTime
void setTime(int parameterIndex, Time x) throws SQLException
RowSet в заданное значение java.sql.Time. Перед отправкой в базу данных драйвер преобразует его в значение SQL TIME, используя календарь java.util.Calendar по умолчанию для вычисления значения.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setTimestamp
void setTimestamp(int parameterIndex, Timestamp x) throws SQLException
RowSet в заданное значение java.sql.Timestamp. Перед отправкой в базу данных драйвер преобразует его в значение SQL TIMESTAMP, используя календарь java.util.Calendar по умолчанию для вычисления значения.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setTimestamp
void setTimestamp(String parameterName, Timestamp x) throws SQLException
java.sql.Timestamp. При отправке значения в базу данных драйвер преобразует его в значение SQL TIMESTAMP.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setAsciiStream
void setAsciiStream(int parameterIndex, InputStream x, int length) throws SQLException
RowSet в заданное значение java.io.InputStream. Передавать очень большое значение ASCII через java.io.InputStream может быть практичнее, чем в качестве параметра LONGVARCHAR. Драйвер будет считывать данные из потока по мере необходимости, пока не достигнет конца файла. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— входной поток Java, содержащий значение параметра ASCII -
length— количество байтов в потоке - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setAsciiStream
void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARCHAR передается очень большое значение ASCII, его может быть практичнее передать через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование из ASCII в формат символьных данных базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
- Параметры:
-
parameterName— имя параметра -
x— входной поток Java, содержащий значение параметра ASCII -
length— количество байтов в потоке - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
setBinaryStream
void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
RowSet в заданное значение java.io.InputStream. Передавать очень большое двоичное значение через java.io.InputStream может быть практичнее, чем в качестве параметра LONGVARBINARY. Драйвер будет считывать данные из потока по мере необходимости, пока не достигнет конца файла. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— входной поток Java, содержащий двоичное значение параметра -
length— количество байтов в потоке - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setBinaryStream
void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException
LONGVARBINARY передается очень большое двоичное значение, его может быть практичнее передать через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
- Параметры:
-
parameterName— имя параметра -
x— входной поток Java, содержащий двоичное значение параметра -
length— количество байтов в потоке - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
setCharacterStream
void setCharacterStream(int parameterIndex, Reader reader, int length) throws SQLException
RowSet в заданное значение java.io.Reader. Передавать очень большое значение UNICODE через java.io.Reader может быть практичнее, чем в качестве параметра LONGVARCHAR. Драйвер будет считывать данные из потока по мере необходимости, пока не достигнет конца файла. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
reader— объектReader, содержащий устанавливаемые данные UNICODE -
length— количество символов в потоке - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setCharacterStream
void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException
Reader длиной в указанное количество символов. Если в параметр LONGVARCHAR передается очень большое значение UNICODE, его может быть практичнее передать через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование из UNICODE в формат символьных данных базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
- Параметры:
-
parameterName— имя параметра -
reader— объектjava.io.Reader, содержащий данные UNICODE, используемые в качестве указанного параметра -
length— количество символов в потоке - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
setAsciiStream
void setAsciiStream(int parameterIndex, InputStream x) throws SQLException
RowSet в заданный входной поток. Если в параметр LONGVARCHAR передается очень большое значение ASCII, его может быть практичнее передать через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование из ASCII в формат символьных данных базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setAsciiStream, принимающую параметр длины.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— входной поток Java, содержащий значение параметра ASCII - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setAsciiStream
void setAsciiStream(String parameterName, InputStream x) throws SQLException
LONGVARCHAR передается очень большое значение ASCII, его может быть практичнее передать через java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование из ASCII в формат символьных данных базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setAsciiStream, принимающую параметр длины.
- Параметры:
-
parameterName— имя параметра -
x— входной поток Java, содержащий значение параметра ASCII - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setBinaryStream
void setBinaryStream(int parameterIndex, InputStream x) throws SQLException
RowSet в заданный входной поток. Если в параметр LONGVARBINARY передается очень большое двоичное значение, его может быть практичнее передать через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setBinaryStream, принимающую параметр длины.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
x— входной поток Java, содержащий двоичное значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setBinaryStream
void setBinaryStream(String parameterName, InputStream x) throws SQLException
LONGVARBINARY передается очень большое двоичное значение, его может быть практичнее передать через объект java.io.InputStream. Данные будут считываться из потока по мере необходимости до достижения конца файла. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setBinaryStream, принимающую параметр длины.
- Параметры:
-
parameterName— имя параметра -
x— входной поток Java, содержащий двоичное значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setCharacterStream
void setCharacterStream(int parameterIndex, Reader reader) throws SQLException
RowSet в заданный объект Reader. Если в параметр LONGVARCHAR передается очень большое значение UNICODE, его может быть практичнее передать через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование из UNICODE в формат символьных данных базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setCharacterStream, принимающую параметр длины.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
reader— объектjava.io.Reader, содержащий данные Unicode - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setCharacterStream
void setCharacterStream(String parameterName, Reader reader) throws SQLException
Reader. Если в параметр LONGVARCHAR передается очень большое значение UNICODE, его может быть практичнее передать через объект java.io.Reader. Данные будут считываться из потока по мере необходимости до достижения конца файла. Драйвер JDBC выполнит необходимое преобразование из UNICODE в формат символьных данных базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setCharacterStream, принимающую параметр длины.
- Параметры:
-
parameterName— имя параметра -
reader— объектjava.io.Reader, содержащий данные Unicode - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setNCharacterStream
void setNCharacterStream(int parameterIndex, Reader value) throws SQLException
RowSet в объект Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из формата символов Java в национальный набор символов базы данных. Примечание: Этот объект потока может быть как стандартным объектом потока Java, так и вашим подклассом, реализующим стандартный интерфейс.
Примечание: См. документацию к драйверу JDBC, чтобы выяснить, может ли быть эффективнее использовать версию setNCharacterStream, принимающую параметр длины.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2, ... -
value— значение параметра - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что может произойти ошибка преобразования данных; если произошла ошибка доступа к базе данных; или если этот метод вызван для закрытогоPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setObject
void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) throws SQLException
RowSet с заданным значением Java Object. Для целочисленных значений следует использовать соответствующие объекты-эквиваленты java.lang (например, экземпляр класса Integer для int). Если второй аргумент является InputStream, поток должен содержать указанное в scaleOrLength количество байтов. Если второй аргумент является Reader, Reader должен содержать указанное в scaleOrLength количество символов. Если эти условия не выполняются, драйвер сгенерирует SQLException при выполнении подготовленного оператора. Перед отправкой в базу данных заданный объект Java будет преобразован в targetSqlType.
Если объект принадлежит классу, реализующему SQLData, набор строк должен вызвать метод SQLData.writeSQL, чтобы записать объект в поток данных SQLOutput. Если же объект принадлежит классу, реализующему Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего типа SQL.
Обратите внимание, что этот метод можно использовать для передачи специфичных для базы данных абстрактных типов данных.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, содержащий значение входного параметра -
targetSqlType— тип SQL (определенный вjava.sql.Types), который будет передан в базу данных. Аргумент scale может дополнительно уточнять этот тип. -
scaleOrLength— дляjava.sql.Types.DECIMALилиjava.sql.Types.NUMERIC typesэто количество цифр после десятичной точки. Для типов Java ObjectInputStreamиReaderэто длина данных в потоке илиReader. Для всех остальных типов это значение игнорируется. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setObject
void setObject(String parameterName, Object x, int targetSqlType, int scale) throws SQLException
java.lang. Перед отправкой в базу данных заданный объект Java будет преобразован в указанный targetSqlType. Если объект имеет пользовательское отображение (принадлежит классу, реализующему интерфейс SQLData), драйвер JDBC должен вызвать метод SQLData.writeSQL, чтобы записать его в поток данных SQL. Если же объект принадлежит классу, реализующему Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего типа SQL.
Обратите внимание, что этот метод можно использовать для передачи специфичных для базы данных абстрактных типов данных.
- Параметры:
-
parameterName— имя параметра -
x— объект, содержащий значение входного параметра -
targetSqlType— тип SQL (определенный в java.sql.Types), который будет передан в базу данных. Аргумент scale может дополнительно уточнять этот тип. -
scale— для типов java.sql.Types.DECIMAL или java.sql.Types.NUMERIC это количество цифр после десятичной точки. Для всех остальных типов это значение игнорируется. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— еслиtargetSqlTypeимеет тип данныхARRAY,BLOB,CLOB,DATALINK,JAVA_OBJECT,NCHAR,NCLOB,NVARCHAR,LONGNVARCHAR,REF,ROWID,SQLXMLилиSTRUCT, а драйвер JDBC не поддерживает этот тип данных - Начиная с версии:
- 1.4
- См. также:
setObject
void setObject(int parameterIndex, Object x, int targetSqlType) throws SQLException
RowSet с помощью значения Java Object. Для целочисленных значений следует использовать соответствующие объекты-эквиваленты java.lang. Этот метод аналогичен приведенному выше методу setObject, но использует масштаб второго параметра. Масштаб скалярных значений равен нулю. Литералы имеют масштаб, указанный в литерале. Несмотря на поддержку этого метода, не рекомендуется вызывать его с входными значениями с плавающей точкой.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, содержащий значение входного параметра -
targetSqlType— тип SQL (определенный вjava.sql.Types), который будет передан в базу данных - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setObject
void setObject(String parameterName, Object x, int targetSqlType) throws SQLException
setObject, но предполагает, что масштаб равен нулю.- Параметры:
-
parameterName— имя параметра -
x— объект, содержащий значение входного параметра -
targetSqlType— тип SQL (определенный в java.sql.Types), который будет передан в базу данных - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— еслиtargetSqlTypeимеет тип данныхARRAY,BLOB,CLOB,DATALINK,JAVA_OBJECT,NCHAR,NCLOB,NVARCHAR,LONGNVARCHAR,REF,ROWID,SQLXMLилиSTRUCT, а драйвер JDBC не поддерживает этот тип данных - Начиная с версии:
- 1.4
- См. также:
setObject
void setObject(String parameterName, Object x) throws SQLException
Object; поэтому для встроенных типов следует использовать соответствующие объекты-эквиваленты java.lang. Спецификация JDBC определяет стандартное сопоставление типов Java Object с типами SQL. Перед отправкой в базу данных заданный аргумент будет преобразован в соответствующий тип SQL.
Обратите внимание, что этот метод можно использовать для передачи специфичных для базы данных абстрактных типов данных с помощью специфичного для драйвера типа Java. Если объект принадлежит классу, реализующему интерфейс SQLData, драйвер JDBC должен вызвать метод SQLData.writeSQL, чтобы записать его в поток данных SQL. Если же объект принадлежит классу, реализующему Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего типа SQL.
Этот метод выбрасывает исключение при неоднозначности, например, если объект принадлежит классу, реализующему более одного из перечисленных выше интерфейсов.
- Параметры:
-
parameterName— имя параметра -
x— объект, содержащий значение входного параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных, этот метод вызван для закрытогоCallableStatementили заданный параметрObjectнеоднозначен -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setObject
void setObject(int parameterIndex, Object x) throws SQLException
RowSet с помощью значения Java Object. Для целочисленных значений следует использовать соответствующие объекты-эквиваленты java.lang. Спецификация JDBC определяет стандартное сопоставление типов Java Object с типами SQL. Перед отправкой в базу данных драйвер преобразует заданный объект Java в соответствующее стандартное представление SQL.
Обратите внимание, что этот метод можно использовать для передачи специфичных для базы данных абстрактных типов данных с помощью специфичного для драйвера типа Java. Если объект принадлежит классу, реализующему SQLData, набор строк должен вызвать метод SQLData.writeSQL, чтобы записать объект в поток данных SQLOutput. Если же объект принадлежит классу, реализующему Ref, Blob, Clob, NClob, Struct, java.net.URL или Array, драйвер должен передать его в базу данных как значение соответствующего типа SQL.
При неоднозначности выбрасывается исключение, например, если объект принадлежит классу, реализующему более одного из этих интерфейсов.
- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, содержащий значение входного параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setRef
void setRef(int i, Ref x) throws SQLException
RowSet с заданным значением Ref. Драйвер преобразует его в соответствующее значение REF(<structured-type>).- Параметры:
-
i— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, представляющий данные типа SQLREF - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setBlob
void setBlob(int i, Blob x) throws SQLException
RowSet с заданным значением Blob. Перед отправкой в базу данных драйвер преобразует его в значение BLOB, представляемое объектом Blob.- Параметры:
-
i— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, представляющий BLOB - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setBlob
void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException
InputStream. Объект InputStream должен содержать указанное в length количество символов, иначе при выполнении PreparedStatement будет сгенерировано SQLException. Этот метод отличается от метода setBinaryStream (int, InputStream, int) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARBINARY или BLOB
- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
inputStream— объект, содержащий данные для установки значения параметра. -
length— количество байтов в данных параметра. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных, этот метод вызван для закрытогоPreparedStatement, parameterIndex не соответствует маркеру параметра в операторе SQL, заданная длина меньше нуля или количество байтов вInputStreamне совпадает с заданной длиной. -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setBlob
void setBlob(int parameterIndex, InputStream inputStream) throws SQLException
InputStream. Этот метод отличается от метода setBinaryStream (int, InputStream) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARBINARY или BLOB Примечание: Ознакомьтесь с документацией драйвера JDBC, чтобы выяснить, может ли использование варианта setBlob с параметром length быть более эффективным.
- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
inputStream— объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных, этот метод вызван для закрытогоPreparedStatementили parameterIndex не соответствует маркеру параметра в операторе SQL, -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setBlob
void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException
InputStream. Объект InputStream должен содержать указанное в length количество символов, иначе при выполнении CallableStatement будет сгенерировано SQLException. Этот метод отличается от метода setBinaryStream (int, InputStream, int) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARBINARY или BLOB
- Параметры:
-
parameterName— имя устанавливаемого параметра; второй имеет номер 2 и т. д. -
inputStream— объект, содержащий данные для установки значения параметра. -
length— количество байтов в данных параметра. - Исключения:
-
SQLException— если parameterIndex не соответствует маркеру параметра в операторе SQL или заданная длина меньше нуля; количество байтов вInputStreamне совпадает с заданной длиной; произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setBlob
void setBlob(String parameterName, Blob x) throws SQLException
java.sql.Blob. При отправке в базу данных драйвер преобразует его в значение SQL BLOB.- Параметры:
-
parameterName— имя параметра -
x— объектBlob, соответствующий значению SQLBLOB - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setBlob
void setBlob(String parameterName, InputStream inputStream) throws SQLException
InputStream. Этот метод отличается от метода setBinaryStream (int, InputStream) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как BLOB. При использовании метода setBinaryStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARBINARY или BLOB Примечание: Ознакомьтесь с документацией драйвера JDBC, чтобы выяснить, может ли использование варианта setBlob с параметром length быть более эффективным.
- Параметры:
-
parameterName— имя параметра -
inputStream— объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setClob
void setClob(int i, Clob x) throws SQLException
RowSet с заданным значением Clob. Перед отправкой в базу данных драйвер преобразует его в значение CLOB, представляемое объектом Clob.- Параметры:
-
i— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, представляющий CLOB - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setClob
void setClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader. Объект Reader должен содержать указанное в length количество символов, иначе при выполнении PreparedStatement будет сгенерировано SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как CLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARCHAR или CLOB
- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
reader— объект, содержащий данные для установки значения параметра. -
length— количество символов в данных параметра. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных, этот метод вызван для закрытогоPreparedStatement, parameterIndex не соответствует маркеру параметра в операторе SQL или заданная длина меньше нуля. -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setClob
void setClob(int parameterIndex, Reader reader) throws SQLException
Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как CLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARCHAR или CLOB Примечание: Ознакомьтесь с документацией драйвера JDBC, чтобы выяснить, может ли использование варианта setClob с параметром length быть более эффективным.
- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
reader— объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных, этот метод вызван для закрытогоPreparedStatementили parameterIndex не соответствует маркеру параметра в операторе SQL -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setClob
void setClob(String parameterName, Reader reader, long length) throws SQLException
Reader. Объект Reader должен содержать указанное в length количество символов, иначе при выполнении CallableStatement будет сгенерировано SQLException. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как CLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARCHAR или CLOB
- Параметры:
-
parameterName— имя устанавливаемого параметра -
reader— объект, содержащий данные для установки значения параметра. -
length— количество символов в данных параметра. - Исключения:
-
SQLException— если parameterIndex не соответствует маркеру параметра в операторе SQL; заданная длина меньше нуля; произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setClob
void setClob(String parameterName, Clob x) throws SQLException
java.sql.Clob. При отправке в базу данных драйвер преобразует его в значение SQL CLOB.- Параметры:
-
parameterName— имя параметра -
x— объектClob, соответствующий значению SQLCLOB - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setClob
void setClob(String parameterName, Reader reader) throws SQLException
Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу, что значение параметра следует отправить на сервер как CLOB. При использовании метода setCharacterStream драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправить данные параметра на сервер как LONGVARCHAR или CLOB Примечание: Ознакомьтесь с документацией драйвера JDBC, чтобы выяснить, может ли использование варианта setClob с параметром length быть более эффективным.
- Параметры:
-
parameterName— имя параметра -
reader— объект, содержащий данные для установки значения параметра. - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setArray
void setArray(int i, Array x) throws SQLException
RowSet с заданным значением Array. Перед отправкой в базу данных драйвер преобразует его в значение ARRAY, представляемое объектом Array.- Параметры:
-
i— первый параметр имеет номер 1, второй — 2 и т. д. -
x— объект, представляющий массив SQL - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setDate
void setDate(int parameterIndex, Date x, Calendar cal) throws SQLException
RowSet с заданным значением java.sql.Date. Драйвер преобразует его в значение SQL DATE, используя заданный объект java.util.Calendar для вычисления даты.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра -
cal— объектjava.util.Calendar, используемый для вычисления даты - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setDate
void setDate(String parameterName, Date x) throws SQLException
java.sql.Date, используя часовой пояс по умолчанию виртуальной машины, в которой выполняется приложение. При отправке в базу данных драйвер преобразует его в значение SQL DATE.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод вызван для закрытогоCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setDate
void setDate(String parameterName, Date x, Calendar cal) throws SQLException
java.sql.Date, используя переданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL DATE, которое затем отправляет в базу данных. С помощью объекта Calendar драйвер может вычислить дату с учетом пользовательского часового пояса. Если объект Calendar не указан, драйвер использует часовой пояс по умолчанию — часовой пояс виртуальной машины, в которой выполняется приложение.- Параметры:
-
parameterName— имя параметра -
x— значение параметра -
cal— объектCalendar, который драйвер будет использовать для создания даты - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setTime
void setTime(int parameterIndex, Time x, Calendar cal) throws SQLException
RowSet заданное значение java.sql.Time. Перед отправкой в базу данных драйвер преобразует его в значение SQL TIME, используя для вычисления переданный объект java.util.Calendar.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра -
cal— объектjava.util.Calendar, используемый для вычисления времени - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных
setTime
void setTime(String parameterName, Time x) throws SQLException
java.sql.Time. При отправке в базу данных драйвер преобразует его в значение SQL TIME.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setTime
void setTime(String parameterName, Time x, Calendar cal) throws SQLException
java.sql.Time, используя переданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL TIME, которое затем отправляет в базу данных. С помощью объекта Calendar драйвер может вычислить время с учетом пользовательского часового пояса. Если объект Calendar не указан, драйвер использует часовой пояс по умолчанию — часовой пояс виртуальной машины, в которой выполняется приложение.- Параметры:
-
parameterName— имя параметра -
x— значение параметра -
cal— объектCalendar, который драйвер будет использовать для создания времени - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
setTimestamp
void setTimestamp(int parameterIndex, Timestamp x, Calendar cal) throws SQLException
RowSet заданное значение java.sql.Timestamp. Перед отправкой в базу данных драйвер преобразует его в значение SQL TIMESTAMP, используя для вычисления переданный объект java.util.Calendar.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра -
cal— объектjava.util.Calendar, используемый для вычисления временной метки - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных
setTimestamp
void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException
java.sql.Timestamp, используя переданный объект Calendar. Драйвер использует объект Calendar для создания значения SQL TIMESTAMP, которое затем отправляет в базу данных. С помощью объекта Calendar драйвер может вычислить временную метку с учетом пользовательского часового пояса. Если объект Calendar не указан, драйвер использует часовой пояс по умолчанию — часовой пояс виртуальной машины, в которой выполняется приложение.- Параметры:
-
parameterName— имя параметра -
x— значение параметра -
cal— объектCalendar, который драйвер будет использовать для создания временной метки - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
- См. также:
clearParameters
void clearParameters() throws SQLException
RowSet. Как правило, значения параметров сохраняются при повторном использовании объекта RowSet. Задание значения параметра автоматически очищает его предыдущее значение. Однако в некоторых случаях полезно немедленно освободить ресурсы, используемые текущими значениями параметров. Для этого можно вызвать метод clearParameters.
- Исключения:
-
SQLException— если возникает ошибка доступа к базе данных
execute
void execute() throws SQLException
RowSet данными. Метод execute может использовать следующие свойства для создания подключения для чтения данных: URL, имя источника данных, имя пользователя, пароль, уровень изоляции транзакций и карта типов. Метод execute может использовать следующие свойства для создания оператора, выполняющего команду: команда, режим только для чтения, максимальный размер поля, максимальное количество строк, обработка escape-последовательностей и время ожидания запроса.
Если необходимые свойства не заданы, возникает исключение. Если этот метод выполняется успешно, текущее содержимое набора строк удаляется, а метаданные набора строк также сбрасываются и задаются заново. Незавершенные обновления игнорируются.
Если этот объект RowSet не поддерживает постоянное подключение к источнику данных, для заполнения данными он может использовать объект Reader (объект RowSetReader). В этом случае для этого объекта RowSet будет зарегистрирован объект Reader, а метод execute в рамках своей реализации вызовет метод readData объекта Reader.
- Исключения:
-
SQLException— если возникает ошибка доступа к базе данных или не заданы необходимые для подключения и создания оператора свойства
addRowSetListener
void addRowSetListener(RowSetListener listener)
RowSet.- Параметры:
-
listener— компонент, реализующий интерфейсRowSetListenerи желающий получать уведомления о событиях, происходящих с этим объектомRowSet - См. также:
removeRowSetListener
void removeRowSetListener(RowSetListener listener)
RowSet.- Параметры:
-
listener— компонент, зарегистрированный в качестве прослушивателя этого объектаRowSet - См. также:
setSQLXML
void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException
java.sql.SQLXML. При отправке в базу данных драйвер преобразует его в значение SQL XML.- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
xmlObject— объектSQLXML, соответствующий значению SQLXML - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных, этот метод вызывается для закрытого набора результатов, объектjava.xml.transform.Result,WriterилиOutputStreamне закрыт для объектаSQLXMLлибо при обработке значения XML возникает ошибка. МетодgetCauseисключения может предоставить более подробную информацию, например, если поток не содержит корректный XML. - Начиная с версии:
- 1.6
setSQLXML
void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException
java.sql.SQLXML. При отправке в базу данных драйвер преобразует его в значение SQL XML.- Параметры:
-
parameterName— имя параметра -
xmlObject— объектSQLXML, соответствующий значениюSQL XML - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных, этот метод вызывается для закрытого набора результатов, объектjava.xml.transform.Result,WriterилиOutputStreamне закрыт для объектаSQLXMLлибо при обработке значения XML возникает ошибка. МетодgetCauseисключения может предоставить более подробную информацию, например, если поток не содержит корректный XML. - Начиная с версии:
- 1.6
setRowId
void setRowId(int parameterIndex, RowId x) throws SQLException
java.sql.RowId. При отправке в базу данных драйвер преобразует его в значение SQL ROWID.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— значение параметра - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setRowId
void setRowId(String parameterName, RowId x) throws SQLException
java.sql.RowId. При отправке в базу данных драйвер преобразует его в значение SQL ROWID.- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNString
void setNString(int parameterIndex, String value) throws SQLException
String. При отправке в базу данных драйвер преобразует его в значение SQL NCHAR, NVARCHAR или LONGNVARCHAR (в зависимости от размера аргумента относительно ограничений драйвера на значения NVARCHAR).- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
value— значение параметра - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; или если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNString
void setNString(String parameterName, String value) throws SQLException
String. При отправке в базу данных драйвер преобразует его в значение SQL NCHAR, NVARCHAR или LONGNVARCHAR
- Параметры:
-
parameterName— имя столбца, для которого задается значение -
value— значение параметра - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; или если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNCharacterStream
void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException
Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из символьного формата Java в национальный набор символов базы данных.- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
value— значение параметра -
length— количество символов в данных параметра. - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; или если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException
Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из символьного формата Java в национальный набор символов базы данных.- Параметры:
-
parameterName— имя столбца, для которого задается значение -
value— значение параметра -
length— количество символов в данных параметра. - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; или если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNCharacterStream
void setNCharacterStream(String parameterName, Reader value) throws SQLException
Reader. Объект Reader считывает данные до достижения конца файла. Драйвер выполняет необходимое преобразование из символьного формата Java в национальный набор символов базы данных. Примечание: Объект потока может быть стандартным объектом потока Java или пользовательским подклассом, реализующим стандартный интерфейс.
Примечание: Обратитесь к документации своего драйвера JDBC, чтобы выяснить, может ли быть эффективнее использовать вариант setNCharacterStream, принимающий параметр длины.
- Параметры:
-
parameterName— имя параметра -
value— значение параметра - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если возникает ошибка доступа к базе данных; или если этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setNClob
void setNClob(String parameterName, NClob value) throws SQLException
java.sql.NClob. Этот объект реализует интерфейс java.sql.NClob. Объект NClob соответствует SQL NCLOB.- Параметры:
-
parameterName— имя столбца, для которого задается значение -
value— значение параметра - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; или если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNClob
void setNClob(String parameterName, Reader reader, long length) throws SQLException
Reader. Объект Reader должен содержать указанное в length количество символов, иначе при выполнении объекта SQLException будет сгенерирован CallableStatement. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу: значение параметра следует отправить на сервер как NCLOB. При использовании метода setCharacterStream драйверу может потребоваться дополнительная работа, чтобы определить, следует ли отправить данные параметра на сервер как LONGNVARCHAR или как NCLOB
- Параметры:
-
parameterName— имя задаваемого параметра -
reader— объект, содержащий данные, которые будут присвоены параметру. -
length— количество символов в данных параметра. - Исключения:
-
SQLException— если parameterIndex не соответствует маркеру параметра в операторе SQL; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setNClob
void setNClob(String parameterName, Reader reader) throws SQLException
Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу: значение параметра следует отправить на сервер как NCLOB. При использовании метода setCharacterStream драйверу может потребоваться дополнительная работа, чтобы определить, следует ли отправить данные параметра на сервер как LONGNVARCHAR или как NCLOB Примечание: Обратитесь к документации своего драйвера JDBC, чтобы выяснить, может ли быть эффективнее использовать вариант setNClob, принимающий параметр длины.
- Параметры:
-
parameterName— имя параметра -
reader— объект, содержащий данные, которые будут присвоены параметру. - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setNClob
void setNClob(int parameterIndex, Reader reader, long length) throws SQLException
Reader. Объект Reader должен содержать указанное в length количество символов, иначе при выполнении объекта SQLException будет сгенерирован PreparedStatement. Этот метод отличается от метода setCharacterStream (int, Reader, int) тем, что сообщает драйверу: значение параметра следует отправить на сервер как NCLOB. При использовании метода setCharacterStream драйверу может потребоваться дополнительная работа, чтобы определить, следует ли отправить данные параметра на сервер как LONGNVARCHAR или как NCLOB
- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
reader— объект, содержащий данные, которые будут присвоены параметру. -
length— количество символов в данных параметра. - Исключения:
-
SQLException— если parameterIndex не соответствует маркеру параметра в операторе SQL; если указанная длина меньше нуля; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setNClob
void setNClob(int parameterIndex, NClob value) throws SQLException
java.sql.NClob. При отправке в базу данных драйвер преобразует его в значение SQL NCLOB.- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
value— значение параметра - Исключения:
-
SQLException— если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; или если возникает ошибка доступа к базе данных - Начиная с версии:
- 1.6
setNClob
void setNClob(int parameterIndex, Reader reader) throws SQLException
Reader. Этот метод отличается от метода setCharacterStream (int, Reader) тем, что сообщает драйверу: значение параметра следует отправить на сервер как NCLOB. При использовании метода setCharacterStream драйверу может потребоваться дополнительная работа, чтобы определить, следует ли отправить данные параметра на сервер как LONGNVARCHAR или как NCLOB Примечание: Обратитесь к документации своего драйвера JDBC, чтобы выяснить, может ли быть эффективнее использовать вариант setNClob, принимающий параметр длины.
- Параметры:
-
parameterIndex— индекс первого параметра равен 1, второго — 2 и т. д. -
reader— объект, содержащий данные, которые будут присвоены параметру. - Исключения:
-
SQLException— если parameterIndex не соответствует маркеру параметра в операторе SQL; если драйвер не поддерживает национальные наборы символов; если драйвер может определить, что возможна ошибка преобразования данных; если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.6
setURL
void setURL(int parameterIndex, URL x) throws SQLException
java.net.URL. При отправке в базу данных драйвер преобразует его в значение SQL DATALINK.- Параметры:
-
parameterIndex— первый параметр имеет номер 1, второй — 2 и т. д. -
x— устанавливаемый объектjava.net.URL - Исключения:
-
SQLException— если возникает ошибка доступа к базе данных или этот метод вызывается для закрытого объектаPreparedStatement -
SQLFeatureNotSupportedException— если драйвер JDBC не поддерживает этот метод - Начиная с версии:
- 1.4
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
getBigDecimal(int columnIndex)илиgetBigDecimal(String columnLabel)