Интерфейс 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 в реализации по умолчанию отличается от реализации в реализации CachedRowSet по умолчанию для учёта различных требований к подключённым и неподключённым объектам RowSet.