Интерфейс RowSet
- Все суперинтерфейсы:
-
AutoCloseable,ResultSet,Wrapper
- Все известные подинтерфейсы:
-
CachedRowSet,FilteredRowSet,JdbcRowSet,JoinRowSet,SyncResolver,WebRowSet
public interface RowSet extends ResultSet
Интерфейс, который добавляет поддержку API JDBC для модели компонентов JavaBeans™. Набор строк (rowset), который может использоваться как компонент JavaBeans в визуальной среде разработки Bean, может быть создан и настроен во время проектирования и выполнен во время выполнения.
Интерфейс RowSet предоставляет набор свойств JavaBeans, которые позволяют экземпляру RowSet настраиваться для подключения к источнику данных JDBC и чтения данных из источника данных. Группа методов-сеттеров (setInt, setBytes, setString и т. д.) предоставляет способ передачи входных параметров к свойству команды rowset. Эта команда — это SQL-запрос, который использует rowset, когда получает данные из реляционной базы данных, что обычно и происходит.
Интерфейс RowSet поддерживает события JavaBeans, позволяя другим компонентам в приложении получать уведомления, когда в rowset происходит событие, например, изменение его значения.
Интерфейс RowSet уникален тем, что предназначен для реализации с использованием остальной части API JDBC. Другими словами, реализация RowSet — это слой программного обеспечения, который выполняется «сверху» драйвера JDBC. Реализации интерфейса RowSet могут предоставляться кем угодно, включая поставщиков драйверов JDBC, которые хотят предоставить реализацию RowSet в качестве части своих продуктов JDBC.
Объект RowSet может установить соединение с источником данных и поддерживать это соединение на протяжении всего своего жизненного цикла, в этом случае он называется подключённым rowset. Rowset также может установить соединение с источником данных, получить данные из него и затем закрыть соединение. Такой rowset называется отключённым rowset. Отключенный rowset может вносить изменения в свои данные, пока он отключен, а затем отправлять изменения обратно в исходный источник данных, но для этого он должен восстановить соединение.
Отключенный rowset может иметь Reader (объект RowSetReader) и writer (объект RowSetWriter), связанные с ним. Reader может быть реализован различными способами для заполнения rowset данными, включая получение данных из нереляционного источника данных. Writer также может быть реализован различными способами для распространения изменений, внесенных в данные rowset, обратно в базовый источник данных.
Rowset легко использовать. Интерфейс RowSet расширяет стандартный интерфейс java.sql.ResultSet. Интерфейс RowSetMetaData расширяет интерфейс java.sql.ResultSetMetaData. Таким образом, разработчики, знакомые с API JDBC, должны освоить минимальное количество новых API для работы с rowset. Кроме того, сторонние программные инструменты, которые работают с объектами JDBC ResultSet, также легко адаптируются для работы с rowset.
- С:
- 1.4
Поля
Поля, объявленные в интерфейсе java.sql.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 Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
void | addRowSetListener(RowSetListener listener) | Регистрирует заданный слушатель, чтобы он получал уведомления о событиях, которые происходят на этом объекте |
void | clearParameters() | Очищает параметры, установленные для команды объекта |
void | execute() | Заполняет этот объект |
String | getCommand() | Возвращает свойство команды объекта |
String | getDataSourceName() | Возвращает логическое имя, которое идентифицирует источник данных для объекта |
boolean | getEscapeProcessing() | Возвращает, включена ли обработка экранирования для этого объекта |
int | getMaxFieldSize() | Возвращает максимальное количество байтов, которые могут быть возвращены для определённых значений столбцов. |
int | getMaxRows() | Возвращает максимальное количество строк, которое может содержать объект |
String | getPassword() | Возвращает пароль, используемый для создания подключения к базе данных. |
int | getQueryTimeout() | Возвращает максимальное количество секунд, которое драйвер будет ждать выполнения оператора. |
int | getTransactionIsolation() | Возвращает уровень изоляции транзакций, установленный для этого объекта |
Map<String,Class<?>> | getTypeMap() | Возвращает объект |
String | getUrl() | Возвращает свойство url, которое этот объект |
String | getUsername() | Возвращает имя пользователя, используемое для создания подключения к базе данных для этого объекта |
boolean | isReadOnly() | Возвращает, является ли этот объект |
void | removeRowSetListener(RowSetListener listener) | Удаляет указанного слушателя из списка компонентов, которые будут получать уведомления, когда на этом объекте |
void | setArray(int i,
Array x) | Устанавливает указанный параметр в команде этого объекта |
void | setAsciiStream(int parameterIndex,
InputStream x) | Устанавливает указанный параметр в команде этого объекта |
void | setAsciiStream(int parameterIndex,
InputStream x,
int length) | Устанавливает указанный параметр в команде этого объекта |
void | setAsciiStream(String parameterName,
InputStream x) | Устанавливает указанный параметр в указанный входной поток. |
void | setAsciiStream(String parameterName,
InputStream x,
int length) | Устанавливает указанный параметр в указанный входной поток, который будет содержать указанное количество байтов. |
void | setBigDecimal(int parameterIndex,
BigDecimal x) | Устанавливает указанный параметр в команде этого объекта |
void | setBigDecimal(String parameterName,
BigDecimal x) | Устанавливает указанный параметр со значением |
void | setBinaryStream(int parameterIndex,
InputStream x) | Устанавливает указанный параметр в команде этого объекта |
void | setBinaryStream(int parameterIndex,
InputStream x,
int length) | Устанавливает указанный параметр в команде этого объекта |
void | setBinaryStream(String parameterName,
InputStream x) | Устанавливает указанный параметр в указанный входной поток. |
void | setBinaryStream(String parameterName,
InputStream x,
int length) | Устанавливает указанный параметр в указанный входной поток, который будет содержать указанное количество байтов. |
void | setBlob(int parameterIndex,
InputStream inputStream) | Устанавливает указанный параметр в объект |
void | setBlob(int parameterIndex,
InputStream inputStream,
long length) | Устанавливает указанный параметр в объект |
void | setBlob(int i,
Blob x) | Устанавливает указанный параметр в команде этого объекта |
void | setBlob(String parameterName,
InputStream inputStream) | Устанавливает указанный параметр в объект |
void | setBlob(String parameterName,
InputStream inputStream,
long length) | Устанавливает указанный параметр в объект |
void | setBlob(String parameterName,
Blob x) | Устанавливает указанный параметр в указанный объект |
void | setBoolean(int parameterIndex,
boolean x) | Устанавливает указанный параметр в команде этого объекта |
void | setBoolean(String parameterName,
boolean x) | Устанавливает указанный параметр в значение Java |
void | setByte(int parameterIndex,
byte x) | Устанавливает указанный параметр в команде этого объекта |
void | setByte(String parameterName,
byte x) | Устанавливает указанный параметр в значение Java |
void | setBytes(int parameterIndex,
byte[] x) | Устанавливает указанный параметр в команде этого объекта |
void | setBytes(String parameterName,
byte[] x) | Устанавливает указанный параметр в заданный Java массив байтов. |
void | setCharacterStream(int parameterIndex,
Reader reader) | Устанавливает указанный параметр в команде этого объекта |
void | setCharacterStream(int parameterIndex,
Reader reader,
int length) | Устанавливает указанный параметр в команде этого объекта |
void | setCharacterStream(String parameterName,
Reader reader) | Устанавливает указанный параметр в заданный объект |
void | setCharacterStream(String parameterName,
Reader reader,
int length) | Устанавливает указанный параметр в заданный объект |
void | setClob(int parameterIndex,
Reader reader) | Устанавливает указанный параметр в объект |
void | setClob(int parameterIndex,
Reader reader,
long length) | Устанавливает указанный параметр в объект |
void | setClob(int i,
Clob x) | Устанавливает указанный параметр в команде этого объекта |
void | setClob(String parameterName,
Reader reader) | Устанавливает указанный параметр в объект |
void | setClob(String parameterName,
Reader reader,
long length) | Устанавливает указанный параметр в объект |
void | setClob(String parameterName,
Clob x) | Устанавливает указанный параметр в заданный объект |
void | setCommand(String cmd) | Устанавливает свойство команды этого объекта |
void | setConcurrency(int concurrency) | Устанавливает конкурентность этого объекта |
void | setDataSourceName(String name) | Устанавливает свойство имени источника данных для этого объекта |
void | setDate(int parameterIndex,
Date x) | Устанавливает указанный параметр в команде этого объекта |
void | setDate(int parameterIndex,
Date x,
Calendar cal) | Устанавливает указанный параметр в команде этого объекта |
|---|---|---|
void | setDate(String parameterName,
Date x) | Устанавливает указанный параметр в заданное значение |
void | setDate(String parameterName,
Date x,
Calendar cal) | Устанавливает указанный параметр в заданное значение |
void | setDouble(int parameterIndex,
double x) | Устанавливает указанный параметр в команде этого объекта |
void | setDouble(String parameterName,
double x) | Устанавливает указанный параметр в заданное значение Java |
void | setEscapeProcessing(boolean enable) | Включает или выключает обработку экранирования для этого объекта |
void | setFloat(int parameterIndex,
float x) | Устанавливает указанный параметр в команде этого объекта |
void | setFloat(String parameterName,
float x) | Устанавливает указанный параметр в заданное значение Java |
void | setInt(int parameterIndex,
int x) | Устанавливает указанный параметр в команде этого объекта |
void | setInt(String parameterName,
int x) | Устанавливает указанный параметр в заданное значение Java |
void | setLong(int parameterIndex,
long x) | Устанавливает указанный параметр в команде этого объекта |
void | setLong(String parameterName,
long x) | Устанавливает указанный параметр в заданное значение Java |
void | setMaxFieldSize(int max) | Устанавливает максимальное количество байтов, которое может быть возвращено для значения столбца, в заданное количество байтов. |
void | setMaxRows(int max) | Устанавливает максимальное количество строк, которое может содержать этот объект |
void | setNCharacterStream(int parameterIndex,
Reader value) | Устанавливает указанный параметр в команде этого объекта |
void | setNCharacterStream(int parameterIndex,
Reader value,
long length) | Устанавливает указанный параметр в объект |
void | setNCharacterStream(String parameterName,
Reader value) | Устанавливает указанный параметр в объект |
void | setNCharacterStream(String parameterName,
Reader value,
long length) | Устанавливает указанный параметр в объект |
void | setNClob(int parameterIndex,
Reader reader) | Устанавливает указанный параметр в объект |
void | setNClob(int parameterIndex,
Reader reader,
long length) | Устанавливает указанный параметр в объект |
void | setNClob(int parameterIndex,
NClob value) | Устанавливает указанный параметр в объект |
void | setNClob(String parameterName,
Reader reader) | Устанавливает указанный параметр в объект |
void | setNClob(String parameterName,
Reader reader,
long length) | Устанавливает указанный параметр в объект |
void | setNClob(String parameterName,
NClob value) | Устанавливает указанный параметр в заданный объект |
void | setNString(int parameterIndex,
String value) | Устанавливает указанный параметр в заданный объект |
void | setNString(String parameterName,
String value) | Устанавливает указанный параметр в заданный объект |
void | setNull(int parameterIndex,
int sqlType) | Устанавливает указанный параметр в SQL-команде этого объекта |
void | setNull(int paramIndex,
int sqlType,
String typeName) | Устанавливает указанный параметр в SQL-команде этого объекта |
void | setNull(String parameterName,
int sqlType) | Устанавливает указанный параметр в SQL |
void | setNull(String parameterName,
int sqlType,
String typeName) | Устанавливает указанный параметр в SQL |
void | setObject(int parameterIndex,
Object x) | Устанавливает указанный параметр в команде этого объекта |
void | setObject(int parameterIndex,
Object x,
int targetSqlType) | Устанавливает указанный параметр в команде этого объекта |
void | setObject(int parameterIndex,
Object x,
int targetSqlType,
int scaleOrLength) | Устанавливает указанный параметр в команде этого объекта |
void | setObject(String parameterName,
Object x) | Устанавливает значение указанного параметра с помощью объекта. |
void | setObject(String parameterName,
Object x,
int targetSqlType) | Устанавливает значение указанного параметра с помощью объекта. |
void | setObject(String parameterName,
Object x,
int targetSqlType,
int scale) | Устанавливает значение указанного параметра с помощью объекта. |
void | setPassword(String password) | Устанавливает пароль базы данных для этого объекта |
void | setQueryTimeout(int seconds) | Устанавливает максимальное время ожидания выполнения оператора драйвером в заданное количество секунд. |
void | setReadOnly(boolean value) | Устанавливает, является ли этот объект |
void | setRef(int i,
Ref x) | Устанавливает указанный параметр в команде этого объекта |
void | setRowId(int parameterIndex,
RowId x) | Устанавливает указанный параметр в заданный объект |
void | setRowId(String parameterName,
RowId x) | Устанавливает указанный параметр в заданный объект |
void | setShort(int parameterIndex,
short x) | Устанавливает указанный параметр в команде этого объекта |
void | setShort(String parameterName,
short x) | Устанавливает указанный параметр в заданное значение Java |
void | setSQLXML(int parameterIndex,
SQLXML xmlObject) | Устанавливает указанный параметр в заданный объект |
void | setSQLXML(String parameterName,
SQLXML xmlObject) | Устанавливает указанный параметр в заданный объект |
void | setString(int parameterIndex,
String x) | Устанавливает указанный параметр в команде этого объекта |
void | setString(String parameterName,
String x) | Устанавливает указанный параметр в заданное значение Java |
void | setTime(int parameterIndex,
Time x) | Устанавливает указанный параметр в команде этого объекта |
void | setTime(int parameterIndex,
Time x,
Calendar cal) | Устанавливает указанный параметр в команде этого объекта |
void | setTime(String parameterName,
Time x) | Устанавливает указанный параметр в заданное значение |
void | setTime(String parameterName,
Time x,
Calendar cal) | Устанавливает указанный параметр в заданное значение |
void | setTimestamp(int parameterIndex,
Timestamp x) | Устанавливает указанный параметр в команде этого объекта |
void | setTimestamp(int parameterIndex,
Timestamp x,
Calendar cal) | Устанавливает указанный параметр в команде объекта |
|---|---|---|
void | setTimestamp(String parameterName,
Timestamp x) | Устанавливает указанный параметр в заданное значение |
void | setTimestamp(String parameterName,
Timestamp x,
Calendar cal) | Устанавливает указанный параметр в заданное значение |
void | setTransactionIsolation(int level) | Устанавливает уровень изоляции транзакции для объекта |
void | setType(int type) | Устанавливает тип объекта |
void | setTypeMap(Map<String,Class<?>> map) | Устанавливает заданный объект |
void | setUrl(String url) | Устанавливает URL, который будет использовать объект |
void | setURL(int parameterIndex,
URL x) | Устанавливает указанный параметр в заданное значение |
void | setUsername(String name) | Устанавливает свойство пользователя для этого объекта |
Методы, объявленные в интерфейсе java.sql.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 Методы, объявленные в интерфейсе java.sql.Wrapper
isWrapperFor, unwrap Методы
getUrl
String getUrl()
throws SQLException Возвращает свойство url, которое этот RowSet объект будет использовать для создания подключения, если он использует DriverManager вместо объекта DataSource для установления подключения. Значение по умолчанию — null.
- Возвращает:
- строку url
- Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setUrl(java.lang.String)
setUrl
void setUrl(String url)
throws SQLException Устанавливает URL, который этот RowSet объект будет использовать при использовании DriverManager для создания подключения. Установка этого свойства необязательна. Если используется URL, драйвер JDBC, принимающий этот URL, должен быть загружен до использования набора строк для подключения к базе данных. Набор строк будет использовать URL внутри для создания подключения к базе данных при чтении или записи данных. Для создания подключения используется либо URL, либо имя источника данных, последнее из которых имело значение, отличное от null.
- Параметры:
-
url— строковое значение; может бытьnull - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getUrl()
getDataSourceName
String getDataSourceName()
Возвращает логическое имя, которое идентифицирует источник данных для этого RowSet объекта.
- Возвращает:
- имя источника данных
- См. также:
-
setDataSourceName(java.lang.String),setUrl(java.lang.String)
setDataSourceName
void setDataSourceName(String name)
throws SQLException Устанавливает свойство имени источника данных для этого RowSet объекта на заданное String.
Значение свойства имени источника данных может быть использовано для поиска объекта DataSource, который был зарегистрирован в службе именования. После извлечения объект DataSource может быть использован для создания подключения к источнику данных, который он представляет.
- Параметры:
-
name— логическое имя источника данных для этогоRowSetобъекта; может бытьnull - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getDataSourceName()
getUsername
String getUsername()
Возвращает имя пользователя, используемое для создания подключения к базе данных для этого RowSet объекта. Свойство username устанавливается во время выполнения перед вызовом метода execute. Оно обычно не является частью сериализованного состояния объекта RowSet.
- Возвращает:
- свойство username
- См. также:
setUsername(java.lang.String)
setUsername
void setUsername(String name)
throws SQLException Устанавливает свойство username для этого RowSet объекта на заданное String.
- Параметры:
-
name— имя пользователя - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getUsername()
getPassword
String getPassword()
Возвращает пароль, используемый для создания подключения к базе данных. Свойство password устанавливается во время выполнения перед вызовом метода execute. Оно обычно не является частью сериализованного состояния объекта RowSet.
- Возвращает:
- пароль для подключения к базе данных
- См. также:
setPassword(java.lang.String)
setPassword
void setPassword(String password)
throws SQLException Устанавливает пароль базы данных для этого RowSet объекта на заданное String.
- Параметры:
-
password— строка пароля - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getPassword()
getTransactionIsolation
int getTransactionIsolation()
Возвращает уровень изоляции транзакций, установленный для этого RowSet объекта.
- Возвращает:
- уровень изоляции транзакций; один из
Connection.TRANSACTION_READ_UNCOMMITTED,Connection.TRANSACTION_READ_COMMITTED,Connection.TRANSACTION_REPEATABLE_READилиConnection.TRANSACTION_SERIALIZABLE - См. также:
setTransactionIsolation(int)
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— если произошла ошибка доступа к базе данных - См. также:
getTransactionIsolation()
getTypeMap
Map<String,Class<?>> getTypeMap()
throws SQLException Возвращает объект Map, связанный с этим RowSet объектом, который определяет пользовательское отображение типов SQL, если таковое имеется. По умолчанию карта типов пуста.
- Возвращает:
- объект
java.util.Map, содержащий имена пользовательских типов SQL и Java-классы, которым они должны быть сопоставлены - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setTypeMap(java.util.Map<java.lang.String, java.lang.Class<?>>)
setTypeMap
void setTypeMap(Map<String,Class<?>> map)
throws SQLException Устанавливает заданный объект java.util.Map в качестве карты типов по умолчанию для этого объекта RowSet. Эта карта типов будет использоваться, если другой объект карты типов не передан в качестве параметра метода.
- Параметры:
-
map— объектjava.util.Map, содержащий имена пользовательских типов SQL и Java-классы, которым они должны быть сопоставлены - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getTypeMap()
getCommand
String getCommand()
Возвращает свойство command этого RowSet объекта. Свойство command содержит строку команды, которая должна быть SQL-запросом, который может быть выполнен для заполнения набора строк данными. Значение по умолчанию — null.
- Возвращает:
- строку команды; может быть
null - См. также:
setCommand(java.lang.String)
setCommand
void setCommand(String cmd)
throws SQLException Устанавливает свойство command этого RowSet объекта на заданный SQL-запрос. Это свойство необязательно, когда набор строк получает данные из источника данных, который не поддерживает команды, например, из электронных таблиц.
- Параметры:
-
cmd— SQL-запрос, который будет использоваться для получения данных для этого объектаRowSet; может бытьnull - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getCommand()
isReadOnly
boolean isReadOnly()
Возвращает, является ли этот RowSet объект только для чтения. Если обновления возможны, по умолчанию набор строк является обновляемым.
Попытки обновить набор строк только для чтения приведут к выбрасыванию SQLException.
- Возвращает:
-
true, если этотRowSetобъект только для чтения;false, если он обновляемый - См. также:
setReadOnly(boolean)
setReadOnly
void setReadOnly(boolean value)
throws SQLException Устанавливает, является ли этот RowSet объект только для чтения, на заданное boolean.
- Параметры:
-
value—true, если только для чтения;false, если обновляемый - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
isReadOnly()
getMaxFieldSize
int getMaxFieldSize()
throws SQLException Возвращает максимальное количество байтов, которое может быть возвращено для определенных значений столбцов. Это ограничение относится только к BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR и NVARCHAR столбцам. Если предел превышен, избыточные данные молча отбрасываются.
- Возвращает:
- текущий предел максимального размера столбца; ноль означает, что ограничения нет
- Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setMaxFieldSize(int)
setMaxFieldSize
void setMaxFieldSize(int max)
throws SQLException Устанавливает максимальное количество байтов, которые могут быть возвращены для значения столбца, на заданное количество байтов. Это ограничение относится только к BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR, NCHAR и NVARCHAR столбцам. Если предел превышен, избыточные данные молча отбрасываются. Для максимальной переносимости используйте значения, большие, чем 256.
- Параметры:
-
max— новый предел максимального размера столбца в байтах; ноль означает без ограничений - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getMaxFieldSize()
getMaxRows
int getMaxRows()
throws SQLException Возвращает максимальное количество строк, которое может содержать этот RowSet объект. Если предел превышен, избыточные строки молча отбрасываются.
- Возвращает:
- текущее максимальное количество строк, которое может содержать этот
RowSetобъект; ноль означает без ограничений - Выбрасывает:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setMaxRows(int)
setMaxRows
void setMaxRows(int max)
throws SQLException Устанавливает максимальное количество строк, которое может содержать этот RowSet объект, на указанное значение. Если предел превышен, избыточные строки молча отбрасываются.
- Параметры:
-
max— новое максимальное количество строк; ноль означает неограниченное количество - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getMaxRows()
getEscapeProcessing
boolean getEscapeProcessing()
throws SQLException Возвращает, включена ли обработка экранирования для этого объекта RowSet. Если включено сканирование экранирования, что является значением по умолчанию, драйвер выполнит замену экранирования перед отправкой SQL-запроса в базу данных.
- Возвращаемое значение:
-
true, если обработка экранирования включена;false, если она отключена - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setEscapeProcessing(boolean)
setEscapeProcessing
void setEscapeProcessing(boolean enable)
throws SQLException Включает или отключает обработку экранирования для этого объекта RowSet. Если сканирование экранирования включено (по умолчанию), драйвер выполнит замену экранирования перед отправкой SQL-запроса в базу данных.
- Параметры:
-
enable—true, чтобы включить обработку экранирования;false, чтобы отключить её - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getEscapeProcessing()
getQueryTimeout
int getQueryTimeout()
throws SQLException Возвращает максимальное время в секундах, которое драйвер будет ждать выполнения запроса. Если этот лимит превышен, будет выброшено исключение SQLException.
- Возвращаемое значение:
- текущий лимит таймаута запроса в секундах; ноль означает неограниченное время
- Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
setQueryTimeout(int)
setQueryTimeout
void setQueryTimeout(int seconds)
throws SQLException Устанавливает максимальное время ожидания выполнения запроса драйвером в заданное количество секунд. Если этот лимит превышен, выбрасывается исключение SQLException.
- Параметры:
-
seconds— новый лимит таймаута запроса в секундах; ноль означает отсутствие лимита - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
getQueryTimeout()
setType
void setType(int type)
throws SQLException Устанавливает тип этого объекта RowSet в заданный тип. Этот метод используется для изменения типа набора строк, который по умолчанию является только для чтения и не прокручиваемым.
- Параметры:
-
type— одно из константных значенийResultSet, определяющих тип:ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVEилиResultSet.TYPE_SCROLL_SENSITIVE - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
ResultSet.getType()
setConcurrency
void setConcurrency(int concurrency)
throws SQLException Устанавливает конкурентность этого объекта RowSet на заданный уровень конкурентности. Этот метод используется для изменения уровня конкурентности набора строк, который по умолчанию ResultSet.CONCUR_READ_ONLY
- Параметры:
-
concurrency— одно из константных значенийResultSet, определяющих уровень конкурентности:ResultSet.CONCUR_READ_ONLYилиResultSet.CONCUR_UPDATABLE - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных - См. также:
ResultSet.getConcurrency()
setNull
void setNull(int parameterIndex,
int sqlType)
throws SQLException Устанавливает указанный параметр в SQL-команде этого объекта RowSet в значение SQL NULL.
Примечание: Необходимо указать SQL-тип параметра.
- Параметры:
-
parameterIndex— первый параметр — 1, второй — 2 и т. д. -
sqlType— код SQL-типа, определённыйjava.sql.Types - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setNull
void setNull(String parameterName,
int sqlType)
throws SQLException Устанавливает указанный параметр в значение SQL 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 Устанавливает указанный параметр в SQL-команде этого объекта 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 Устанавливает указанный параметр в значение SQL NULL. Эта версия метода setNull должна использоваться для параметров типа, определённого пользователем, и REF-параметров. Примеры типов, определённых пользователем: STRUCT, DISTINCT, JAVA_OBJECT и именованные массивы.
Примечание: Для обеспечения переносимости приложения должны передаваться код SQL-типа и полное квалифицированное имя SQL-типа при указании NULL-значения параметра типа, определённого пользователем, или REF. В случае типа, определённого пользователем, имя — это имя типа самого параметра. Для REF-параметра имя — это имя типа ссылаемого типа. Если JDBC-драйверу не нужна информация о коде типа или имени типа, он может её проигнорировать. Хотя предназначен для типов, определённых пользователем, и параметров REF, этот метод может использоваться для установки нулевого параметра любого JDBC-типа. Если параметр не имеет типа, определённого пользователем, или REF-типа, заданный typeName игнорируется.
- Параметры:
-
parameterName— имя параметра -
sqlType— значение изjava.sql.Types -
typeName— полное квалифицированное имя SQL-типа, определённого пользователем; игнорируется, если параметр не является типом, определённым пользователем, или SQL-значениемREF - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.4
setBoolean
void setBoolean(int parameterIndex,
boolean x)
throws SQLException Устанавливает указанный параметр в SQL-команде этого объекта RowSet в заданное значение Java boolean. Драйвер преобразует это в значение SQL BIT перед отправкой в базу данных.
- Параметры:
-
parameterIndex— первый параметр — 1, второй — 2 и т. д. -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setBoolean
void setBoolean(String parameterName,
boolean x)
throws SQLException Устанавливает указанный параметр в заданное значение Java boolean. Драйвер преобразует это в значение SQL BIT или BOOLEAN при отправке в базу данных.
- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getBoolean(int)
setByte
void setByte(int parameterIndex,
byte x)
throws SQLException Устанавливает указанный параметр в SQL-команде этого объекта RowSet в заданное значение Java byte. Драйвер преобразует это в значение SQL TINYINT перед отправкой в базу данных.
- Параметры:
-
parameterIndex— первый параметр — 1, второй — 2 и т. д. -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных
setByte
void setByte(String parameterName,
byte x)
throws SQLException Устанавливает указанный параметр в заданное значение Java byte. Драйвер преобразует это в значение SQL TINYINT при отправке в базу данных.
- Параметры:
-
parameterName— имя параметра -
x— значение параметра - Исключения:
-
SQLException— если произошла ошибка доступа к базе данных или этот метод был вызван для закрытого объектаCallableStatement -
SQLFeatureNotSupportedException— если JDBC-драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getByte(int)
setShort
void setShort(int parameterIndex,
short x)
throws SQLException Устанавливает указанный параметр в SQL-команде этого объекта RowSet в заданное значение Java short. Драйвер преобразует это в значение SQL SMALLINT перед отправкой в базу данных.
- Параметры:
-
parameterIndex- первый параметр равен 1, второй - 2, и так далее. -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных
setShort
void setShort(String parameterName,
short x)
throws SQLException Устанавливает указанный параметр в заданное значение Java short. Драйвер преобразует это значение в SQL SMALLINT значение перед отправкой в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getShort(int)
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 Устанавливает указанный параметр в заданное значение Java int. Драйвер преобразует это значение в SQL INTEGER значение перед отправкой в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getInt(int)
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 Устанавливает указанный параметр в заданное значение Java long. Драйвер преобразует это значение в SQL BIGINT значение перед отправкой в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getLong(int)
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 Устанавливает указанный параметр в заданное значение Java float. Драйвер преобразует это значение в SQL FLOAT значение перед отправкой в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getFloat(int)
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 Устанавливает указанный параметр в заданное значение Java double. Драйвер преобразует это значение в SQL DOUBLE значение перед отправкой в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getDouble(int)
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
- См. также:
ResultSet.getBigDecimal(int, int)
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 Устанавливает указанный параметр в заданное значение Java String. Драйвер преобразует это значение в SQL VARCHAR или LONGVARCHAR значение (в зависимости от размера аргумента относительно ограничений драйвера на VARCHAR значения) при отправке в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getString(int)
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 Устанавливает указанный параметр в заданный массив байтов Java. Драйвер преобразует это значение в SQL VARBINARY или LONGVARBINARY (в зависимости от размера аргумента относительно ограничений драйвера на VARBINARY значения) при отправке в базу данных.
- Параметры:
-
parameterName- имя параметра -
x- значение параметра - Исключение:
-
SQLException- если произошла ошибка доступа к базе данных или этот метод был вызван на закрытомCallableStatement -
SQLFeatureNotSupportedException- если JDBC драйвер не поддерживает этот метод - С:
- 1.4
- См. также:
ResultSet.getBytes(int)
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
- См. также:
ResultSet.getTimestamp(int)
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 Устанавливает указанный параметр на заданный входной поток, который будет иметь указанное количество байтов. При вводе очень большого значения ASCII в параметр LONGVARCHAR может быть более практичным отправить его через 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, который имеет заданное количество символов. При вводе очень большого значения UNICODE в параметр LONGVARCHAR может быть более практичным отправить его через объект 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 на заданный входной поток. При вводе очень большого значения ASCII в параметр LONGVARCHAR может быть более практичным отправить его через 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 Устанавливает указанный параметр на заданный входной поток. При вводе очень большого значения ASCII в параметр LONGVARCHAR может быть более практичным отправить его через 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. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть удобнее отправить его с помощью объекта 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. При вводе очень большого значения UNICODE в параметр LONGVARCHAR, может быть удобнее отправить его с помощью объекта 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-объектовInputStreamиReaderэто длина данных в потоке илиReader. Для всех остальных типов это значение будет проигнорировано. - Исключения:
-
SQLException- если произошла ошибка доступа к базе данных - См. также:
Types
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
- См. также:
-
Types,ResultSet.getObject(int)
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
- См. также:
ResultSet.getObject(int)
setObject
void setObject(String parameterName,
Object x)
throws SQLException Устанавливает значение указанного параметра с помощью данного объекта. Второй параметр должен быть типа Object; поэтому для встроенных типов следует использовать соответствующие объекты java.lang.
Спецификация JDBC определяет стандартное отображение Java-типов объектов на типы 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
- См. также:
ResultSet.getObject(int)
setObject
void setObject(int parameterIndex,
Object x)
throws SQLException Устанавливает указанный параметр в команде этого объекта RowSet с помощью Java-объекта Object. Для целочисленных значений следует использовать соответствующие объекты java.lang.
Спецификация JDBC предоставляет стандартное отображение типов Java-объектов на типы 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, принимающей параметр длины.
- Параметры:
-
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, которая принимает параметр длины.
- Параметры:
-
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, которая принимает параметр длины.
- Параметры:
-
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, которая принимает параметр длины.
- Параметры:
-
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
- См. также:
ResultSet.getDate(int)
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
- См. также:
ResultSet.getDate(int)
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
- См. также:
ResultSet.getTime(int)
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
- См. также:
ResultSet.getTime(int)
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
- См. также:
ResultSet.getTimestamp(int)
clearParameters
void clearParameters()
throws SQLException Очищает параметры, установленные для команды этого объекта RowSet.
В общем случае значения параметров сохраняются для повторного использования объекта RowSet. Установка значения параметра автоматически очищает его предыдущее значение. Однако в некоторых случаях полезно немедленно освободить ресурсы, используемые текущими значениями параметров, что можно сделать, вызвав метод clearParameters.
- Исключения:
-
SQLException- если произошла ошибка доступа к базе данных
execute
void execute()
throws SQLException Заполняет этот объект RowSet данными.
Метод execute может использовать следующие свойства для создания подключения для чтения данных: url, имя источника данных, имя пользователя, пароль, изоляция транзакций и тип карты. Метод execute может использовать следующие свойства для создания оператора для выполнения команды: команда, только для чтения, максимальный размер поля, максимальное количество строк, обработка экранирования и таймаут запроса.
Если необходимые свойства не установлены, генерируется исключение. Если этот метод завершился успешно, текущее содержимое набора строк отбрасывается, а метаданные набора строк также (пере)устанавливаются. Если есть незавершенные обновления, они игнорируются.
Если этот объект RowSet не поддерживает постоянное подключение к источнику данных, он может использовать объект Reader (объект RowSetReader) для заполнения себя данными. В этом случае с этим объектом RowSet был зарегистрирован слушатель Reader, и метод execute будет вызывать метод readData слушателя Reader в рамках своей реализации.
- Исключения:
-
SQLException- если произошла ошибка доступа к базе данных или не были установлены необходимые свойства для создания соединения и оператора
addRowSetListener
void addRowSetListener(RowSetListener listener)
Регистрирует заданного слушателя, чтобы он получал уведомления о событиях, происходящих в этом объекте RowSet.
- Параметры:
-
listener- компонент, реализовавший интерфейсRowSetListenerи желающий получать уведомления о событиях в этом объектеRowSet - См. также:
removeRowSetListener(javax.sql.RowSetListener)
removeRowSetListener
void removeRowSetListener(RowSetListener listener)
Удаляет указанного слушателя из списка компонентов, которые будут получать уведомления об событиях в этом объекте RowSet.
- Параметры:
-
listener- компонент, зарегистрированный как слушатель для этого объектаRowSet - См. также:
addRowSetListener(javax.sql.RowSetListener)
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 должен содержать количество символов, указанное длиной, в противном случае будет сгенерирована ошибка SQLException при выполнении CallableStatement. Этот метод отличается от метода setCharacterStream (int, Reader, int), потому что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как NCLOB. Когда используется метод setCharacterStream, драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или NCLOB
- Параметры:
-
parameterName- имя параметра, который нужно установить -
reader- объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если параметрIndex не соответствует марке параметра в операторе 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 должен содержать количество символов, указанное длиной, в противном случае будет сгенерирована ошибка SQLException при выполнении PreparedStatement. Этот метод отличается от метода setCharacterStream (int, Reader, int), потому что он сообщает драйверу, что значение параметра должно быть отправлено на сервер как NCLOB. Когда используется метод setCharacterStream, драйверу может потребоваться выполнить дополнительную работу, чтобы определить, следует ли отправлять данные параметра на сервер как LONGNVARCHAR или NCLOB
- Параметры:
-
parameterIndex- индекс первого параметра - 1, второго - 2 и т.д. -
reader- Объект, содержащий данные для установки значения параметра. -
length- количество символов в данных параметра. - Исключения:
-
SQLException- если параметрIndex не соответствует марке параметра в операторе 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, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.sql/javax/sql/RowSet.html