Интерфейс JdbcRowSet

public interface JdbcRowSet extends RowSet, Joinable

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

Обзор версии 1.0

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

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

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

Создание объекта 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.