Интерфейс JdbcRowSet

public interface JdbcRowSet extends RowSet, Joinable

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

1.0 Обзор

Обёртка вокруг объекта ResultSet, которая позволяет использовать набор результатов как компонент JavaBeans. Таким образом, объект JdbcRowSet может быть одним из компонентов, которые инструмент предоставляет для построения приложения. Поскольку JdbcRowSet является подключённым набором строк (rowset), то есть постоянно поддерживает подключение к базе данных с помощью драйвера, поддерживающего технологию 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.