Интерфейс JdbcRowSet

public interface JdbcRowSet
extends RowSet, Joinable

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

1.0 Обзор

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

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

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

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

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

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

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

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

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

Однако перед вызовом метода execute необходимо установить команду и свойства, необходимые для установления соединения. Следующий фрагмент кода создает объект 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.

Методы

getShowDeleted

boolean getShowDeleted()
                throws SQLException

Возвращает:

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

Исключение:

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

См. также:

setShowDeleted(boolean)

setShowDeleted

void setShowDeleted(boolean b)
             throws SQLException

Параметры:

b — true если удаленные строки должны отображаться; false в противном случае

Исключение:

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

См. также:

getShowDeleted()

getRowSetWarnings

RowSetWarning getRowSetWarnings()
                         throws SQLException

Возвращает:

первый объект RowSetWarning, зарегистрированный в этом объекте JdbcRowSet, или null при отсутствии предупреждений

Исключение:

SQLException — если этот метод вызывается для закрытого объекта JdbcRowSet

См. также:

RowSetWarning

commit

void commit()
     throws SQLException

Исключение:

SQLException — если произошла ошибка доступа к базе данных или объект Connection в этом JdbcRowSet находится в режиме авто-commit

См. также:

Connection.setAutoCommit(boolean)

getAutoCommit

boolean getAutoCommit()
               throws SQLException

Возвращает:

true если авто-commit включен; false в противном случае

Исключение:

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

См. также:

Connection.getAutoCommit()

setAutoCommit

void setAutoCommit(boolean autoCommit)
            throws SQLException

Параметры:

autoCommit — true для включения авто-commit; false для отключения авто-commit

Исключение:

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

См. также:

Connection.setAutoCommit(boolean)

rollback

void rollback()
       throws SQLException

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

Исключение:

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

См. также:

rollback(Savepoint)

rollback

void rollback(Savepoint s)
       throws SQLException

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

Параметры:

s — Сохраняемый момент, до которого откатить транзакцию

Исключение:

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

См. также:

rollback()