compact3

javax.sql.rowset

Интерфейс JdbcRowSet

Все Суперинтерфейсы:

AutoCloseable, Joinable, ResultSet, RowSet, Обертка

public interface JdbcRowSet
extends RowSet, Joinable

Стандартный интерфейс, что все стандартные реализации JdbcRowSet должен реализовать.

1.0 Краткий обзор

Обертка вокруг a ResultSet объект, который позволяет использовать набор результатов в качестве компонента ^JavaBeansTM. Таким образом, a JdbcRowSet объект может быть одним из Бобов, которые инструмент делает доступным для того, чтобы составить приложение. Поскольку a JdbcRowSet соединенный набор строк, то есть, он непрерывно поддерживает свое соединение с базой данных, используя поддерживающий технологию драйвер JDBC, он также эффективно делает драйвер компонентом JavaBeans.

Поскольку это всегда соединяется с его базой данных, экземпляром JdbcRowSet может просто принять звонки, вызванные на это, и поочередно обратиться к ним ResultSet объект. Как следствие набор результатов может, например, быть компонентом в приложении Swing.

Другое преимущество a JdbcRowSet объект состоит в том, что это может использоваться, чтобы сделать a ResultSet возразите с возможностью прокрутки и обновляемый. Все RowSet объекты по умолчанию с возможностью прокрутки и обновляемы. Если драйвер и используемая база данных не поддерживают прокрутку и/или обновление наборов результатов, приложение может заполнить a JdbcRowSet объект с данными a ResultSet возразите и затем работайте на JdbcRowSet возразите, как будто это было ResultSet объект.

2.0 Создание a JdbcRowSet Объект

Ссылочная реализация JdbcRowSet интерфейс, JdbcRowSetImpl, обеспечивает реализацию конструктора по умолчанию. Новый экземпляр инициализируется со значениями по умолчанию, которые могут быть установлены с новыми значениями как необходимый. Новый экземпляр не действительно функционален до execute метод вызывают. Вообще, этот метод делает следующее:

• устанавливает соединение с базой данных
• создает a PreparedStatement объект и наборы любой из его параметров заполнителя
• выполняет оператор, чтобы создать a ResultSet объект

Если execute метод успешен, он установит соответствующее частное JdbcRowSet поля со следующим:

• a Connection объект - соединение между набором строк и базой данных
• a PreparedStatement объект - запрос, который производит набор результатов
• a ResultSet объект - набор результатов, что произведенная команда набора строк и это делается, в действительности, компонентом JavaBeans

Если эти поля не были установлены, означая что execute метод не выполнился успешно, никакие методы кроме execute и close может быть вызван на наборе строк. Все другие открытые методы выдадут исключение.

Прежде, чем вызвать execute метод, однако, команда и свойства, необходимые для того, чтобы установить соединение, должны быть установлены. Следующий фрагмент кода создает a JdbcRowSetImpl объект, устанавливает команду и свойства соединения, устанавливает параметры заполнителя, и затем вызывает метод execute.

     JdbcRowSetImpl jrs = new JdbcRowSetImpl();
     jrs.setCommand("SELECT * FROM TITLES WHERE TYPE = ?");
     jrs.setURL("jdbc:myDriver:myAttribute");
     jrs.setUsername("cervantes");
     jrs.setPassword("sancho");
     jrs.setString(1, "BIOGRAPHY");
     jrs.execute();
 

Переменная jrs теперь представляет экземпляр JdbcRowSetImpl это - тонкая обертка вокруг ResultSet объект, содержащий все строки в таблице TITLES где тип книги является биографией. В этой точке обращаются к операциям jrs будет влиять на строки в наборе результатов, который является эффективно компонентом JavaBeans.

Реализация RowSet метод execute в JdbcRowSet ссылочная реализация отличается от этого в CachedRowSetСсылочная реализация ^ТМ, чтобы учесть различные требования соединенных и разъединенных RowSet объекты.

Полевая Сводка

Поля, наследованные от интерфейса 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	commit() Каждый JdbcRowSet содержит a Connection объект от ResultSet или свойства JDBC, которые передают к, это - конструкторы.
boolean	getAutoCommit() Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому.
RowSetWarning	getRowSetWarnings() Получает первое предупреждение, о котором сообщают запросы к этому JdbcRowSet объект.
boolean	getShowDeleted() Получает a boolean указание, появляются ли строки, отмеченные для удаления, в наборе текущих строк.
void	rollback() Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому.
void	rollback(Savepoint s) Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому.
void	setAutoCommit(boolean autoCommit) Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому.
void	setShowDeleted(boolean b) Устанавливает свойство showDeleted к данному boolean значение.

Методы, наследованные от интерфейса javax.sql. RowSet

addRowSetListener, clearParameters, execute, getCommand, getDataSourceName, getEscapeProcessing, getMaxFieldSize, getMaxRows, getPassword, getQueryTimeout, getTransactionIsolation, getTypeMap, getUrl, getUsername, isReadOnly, removeRowSetListener, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBlob, setBlob, setBlob, setBoolean, setBoolean, setByte, setByte, setBytes, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setClob, setClob, setClob, setCommand, setConcurrency, setDataSourceName, setDate, setDate, setDate, setDate, setDouble, setDouble, setEscapeProcessing, setFloat, setFloat, setInt, setInt, setLong, setLong, setMaxFieldSize, setMaxRows, setNCharacterStream, setNCharacterStream, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNClob, setNClob, setNClob, setNString, setNString, setNull, setNull, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setObject, setPassword, setQueryTimeout, setReadOnly, setRef, setRowId, setRowId, setShort, setShort, setSQLXML, setSQLXML, setString, setString, setTime, setTime, setTime, setTime, setTimestamp, setTimestamp, setTimestamp, setTimestamp, setTransactionIsolation, setType, setTypeMap, setURL, setUrl, setUsername

Методы, наследованные от интерфейса 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. Обертка

isWrapperFor, unwrap

Методы, наследованные от интерфейса javax.sql.rowset. Joinable

getMatchColumnIndexes, getMatchColumnNames, setMatchColumn, setMatchColumn, setMatchColumn, setMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn

Деталь метода

getShowDeleted

boolean getShowDeleted()
                throws SQLException

Получает a boolean указание, появляются ли строки, отмеченные для удаления, в наборе текущих строк. Если true возвращается, удаленные строки видимы с текущими строками. Если false возвращается, строки не видимы с набором текущих строк. Значение по умолчанию false.

Стандартные реализации набора строк могут хотеть ограничивать это поведение для соображений безопасности или для определенных сценариев развертывания. Видимость удаленных строк определяется с помощью реализации и не представляет стандартное поведение.

Отметьте: Разрешение удаленных строк остаться видимый усложняет поведение некоторого стандартного JDBC RowSet методы реализаций. Однако, большинство пользователей набора строк может просто проигнорировать эту дополнительную деталь, потому что только очень специализированные приложения будут, вероятно, хотеть использовать в своих интересах эту функцию.

Возвраты:

true если удаленные строки видимы; false иначе

Броски:

SQLException - если реализация набора строк неспособна к определить, остаются ли строки, отмеченные для удаления, видимыми

См. Также:

setShowDeleted(boolean)

setShowDeleted

void setShowDeleted(boolean b)
             throws SQLException

Устанавливает свойство showDeleted к данному boolean значение. Это свойство определяет, продолжают ли строки, отмеченные для удаления, появляться в наборе текущих строк. Если значение устанавливается в true, удаленные строки сразу видимы с набором текущих строк. Если значение устанавливается в false, удаленные строки устанавливаются как невидимые с текущим набором строк.

Стандартные реализации набора строк могут хотеть ограничивать это поведение для соображений безопасности или для определенных сценариев развертывания. Это оставляют как определено с помощью реализации и не представляет стандартное поведение.

Параметры:

b - true если удаленные строки нужно показать; false иначе

Броски:

SQLException - если реализация набора строк неспособна к сбросить, должны ли удаленные строки быть видимыми

См. Также:

getShowDeleted()

getRowSetWarnings

RowSetWarning getRowSetWarnings()
                         throws SQLException

Получает первое предупреждение, о котором сообщают запросы к этому JdbcRowSet объект. Если о втором предупреждении сообщили относительно этого JdbcRowSet объект, это будет объединено в цепочку к первому предупреждению и может быть получено, вызывая метод RowSetWarning.getNextWarning на первом предупреждении. Последующие предупреждения на этом JdbcRowSet объект будет объединен в цепочку к RowSetWarning объекты возвратились методом RowSetWarning.getNextWarning. Цепочка предупреждения автоматически очищается каждый раз читается, когда новая строка. К этому методу нельзя обратиться a RowSet объект, который был закрыт; выполнение так вызовет SQLException быть брошенным.

Поскольку это всегда соединяется с его источником данных, a JdbcRowSet объект может положиться на присутствие активных Statement, Connection, и ResultSet экземпляры. Это означает, что приложения могут получить дополнительный SQLWarning уведомления, вызывая getNextWarning методы, которые они обеспечивают. Разъединенный Rowset объекты, такие как a CachedRowSet возразите, не имейте доступа к ним getNextWarning методы.

Возвраты:

первое RowSetWarning объект сообщил относительно этого JdbcRowSet объект или null если нет ни одного

Броски:

SQLException - если этот метод вызывают на закрытом JdbcRowSet объект

См. Также:

RowSetWarning

фиксация

void commit()
     throws SQLException

Каждый JdbcRowSet содержит a Connection объект от ResultSet или свойства JDBC, которые передают к, это - конструкторы. Этот метод переносится Connection метод фиксации, чтобы позволить гибкой автоматической фиксации или не автоматической фиксации транзакционная поддержка управления.

Делает все изменения сделанными начиная с предыдущей фиксации/отката постоянный и выпускает любые блокировки базы данных, в настоящий момент сохраненные этим объектом Соединения. Этот метод должен использоваться только, когда режим автоматической фиксации был отключен.

Броски:

SQLException - если ошибка доступа к базе данных происходит или этот объект Соединения в пределах этого JdbcRowSet находится в режиме автоматической фиксации

См. Также:

Connection.setAutoCommit(boolean)

getAutoCommit

boolean getAutoCommit()
               throws SQLException

Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому. Этот метод переносится Connection's getAutoCommit метод, чтобы позволить приложению определять JdbcRowSet поведение транзакции.

Наборы режим автоматической фиксации этого соединения к данному состоянию. Если соединение будет в режиме автоматической фиксации, то все его SQL-операторы будут выполняться и фиксироваться как отдельные транзакции. Иначе, его SQL-операторы группируются в транзакции, которые завершаются звонком или фиксация метода или откат метода. По умолчанию новые соединения находятся в режиме автоматической фиксации.

Броски:

SQLException - если ошибка доступа к базе данных происходит

См. Также:

Connection.getAutoCommit()

setAutoCommit

void setAutoCommit(boolean autoCommit)
            throws SQLException

Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому. Этот метод переносится Connection's getAutoCommit метод, чтобы позволить приложению устанавливать JdbcRowSet поведение транзакции.

Устанавливает текущий режим автоматической фиксации для этого Connection объект.

Броски:

SQLException - если ошибка доступа к базе данных происходит

См. Также:

Connection.setAutoCommit(boolean)

откат

void rollback()
       throws SQLException

Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому. Отмены все изменения, произведенные в текущей транзакции и выпусках любая база данных, блокируют в настоящий момент сохраненный этим Connection объект. Этот метод должен использоваться только, когда режим автоматической фиксации был отключен.

Броски:

SQLException - если ошибка доступа к базе данных происходит или это Connection объект в пределах этого JdbcRowSet находится в режиме автоматической фиксации.

См. Также:

rollback(Savepoint)

откат

void rollback(Savepoint s)
       throws SQLException

Каждый JdbcRowSet содержит a Connection объект из оригинала ResultSet или свойства JDBC, которые передают к этому. Отмены все изменения, произведенные в текущей транзакции к последней точке сохранения набора и выпускам любая база данных, блокируют в настоящий момент сохраненный этим Connection объект. Этот метод должен использоваться только, когда режим автоматической фиксации был отключен.

Броски:

SQLException - если ошибка доступа к базе данных происходит или это Connection объект в пределах этого JdbcRowSet находится в режиме автоматической фиксации.

См. Также:

rollback()