Интерфейс 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.

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.