Интерфейс JdbcRowSet

public interface JdbcRowSet
extends RowSet, Joinable

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

1.0 Обзор

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