Интерфейс JoinRowSet

public interface JoinRowSet extends WebRowSet

Интерфейс JoinRowSet предоставляет механизм объединения связанных данных из разных объектов RowSet в один объект JoinRowSet, представляющий SQL-JOIN. Другими словами, объект JoinRowSet служит контейнером для данных из объектов RowSet, образующих отношение SQL-JOIN.

Интерфейс Joinable предоставляет методы для установки, получения и сброса столбца сопоставления, который служит основой для установления отношения SQL-JOIN. Столбец сопоставления также можно задать, передав его соответствующей версии метода JointRowSet addRowSet.

1.0 Обзор

Отключенные объекты RowSet (объекты CachedRowSet и реализации, расширяющие интерфейс CachedRowSet) не имеют стандартного способа установления SQL-JOIN между объектами RowSet без дорогостоящей операции повторного подключения к источнику данных. Интерфейс JoinRowSet специально разработан для удовлетворения этой потребности.

Любой объект RowSet можно добавить в объект JoinRowSet, чтобы он стал частью отношения SQL-JOIN. Это означает, что в JOIN могут входить как подключенные, так и отключенные объекты RowSet. Объектам RowSet, работающим в подключенной среде (объектам JdbcRowSet), рекомендуется использовать уже имеющееся подключение к базе данных для непосредственного установления отношений SQL-JOIN между таблицами. Однако при необходимости объект JdbcRowSet можно добавить в объект JoinRowSet.

К экземпляру JoinRowSet можно добавить любое количество объектов RowSet, если их можно связать отношением SQL-JOIN. По определению, оператор SQL-JOIN используется для объединения данных из двух или более таблиц реляционной базы данных на основе общего атрибута. Интерфейс Joinable предоставляет методы для задания общего атрибута, для чего устанавливается столбец сопоставления. Столбец сопоставления обычно совпадает с первичным ключом, однако он не обязан совпадать с ним. Устанавливая и затем обеспечивая соответствие столбцов, объект JoinRowSet устанавливает отношения JOIN между объектами RowSet без помощи доступной реляционной базы данных.

Тип создаваемого JOIN определяется установкой одной из констант JoinRowSet с помощью метода setJoinType. Можно задать следующие типы SQL-JOIN:

• CROSS_JOIN
• FULL_JOIN
• INNER_JOIN — используется по умолчанию, если тип JOIN не задан
• LEFT_OUTER_JOIN
• RIGHT_OUTER_JOIN

Обратите внимание: если тип не задан, JOIN автоматически будет внутренним соединением. Комментарии к полям интерфейса JoinRowSet поясняют эти типы JOIN, являющиеся стандартными типами SQL-JOIN.

2.0 Использование объекта JoinRowSet для создания JOIN

При создании объекта JoinRowSet он пуст. Первый добавленный объект RowSet становится основой отношения JOIN. Приложения должны определить, какой столбец в каждом из добавляемых в объект JoinRowSet объектов RowSet следует использовать в качестве столбца сопоставления. Все объекты RowSet должны содержать столбец сопоставления, а значения в каждом столбце сопоставления должны допускать сравнение со значениями в других столбцах сопоставления. Столбцы не обязаны иметь одинаковые имена, хотя часто это так, и в них не обязательно должны храниться данные одного и того же типа, если эти типы данных допускают сравнение.

Столбец сопоставления можно задать двумя способами:

• Вызвав метод Joinable setMatchColumn
  Это единственный метод, с помощью которого можно задать столбец сопоставления до добавления объекта RowSet в объект JoinRowSet. Чтобы использовать метод setMatchColumn, объект RowSet должен реализовывать интерфейс Joinable. После установки значения столбца сопоставления этот метод можно использовать для его сброса в любое время.
• Вызвав одну из версий метода JoinRowSet addRowSet, принимающую имя или номер столбца (либо массив имен или номеров столбцов)
  Четыре из пяти методов addRowSet принимают столбец сопоставления в качестве параметра. Эти четыре метода устанавливают или сбрасывают столбец сопоставления при добавлении объекта RowSet в объект JoinRowSet.

3.0 Пример использования

Следующий фрагмент кода добавляет два объекта CachedRowSet в объект JoinRowSet. Обратите внимание: в этом примере тип SQL-JOIN не задан, поэтому используется тип JOIN по умолчанию — INNER_JOIN.

В следующем фрагменте кода таблица EMPLOYEES, для которой столбцом сопоставления задан первый столбец (EMP_ID), добавляется в объект JoinRowSet jrs. Затем добавляется таблица ESSP_BONUS_PLAN, для которой столбцом сопоставления также является столбец EMP_ID. При добавлении второй таблицы в jrs включаются только те строки из ESSP_BONUS_PLAN, в которых значение EMP_ID совпадает со значением EMP_ID в таблице EMPLOYEES. В данном случае все участники бонусной программы являются сотрудниками, поэтому в объект JoinRowSet добавляются все строки таблицы ESSP_BONUS_PLAN. В этом примере оба добавляемых объекта CachedRowSet реализуют интерфейс Joinable и поэтому могут вызвать метод Joinable setMatchColumn.

    JoinRowSet jrs = new JoinRowSetImpl();

    ResultSet rs1 = stmt.executeQuery("SELECT * FROM EMPLOYEES");
    CachedRowSet empl = new CachedRowSetImpl();
    empl.populate(rs1);
    empl.setMatchColumn(1);
    jrs.addRowSet(empl);

    ResultSet rs2 = stmt.executeQuery("SELECT * FROM ESSP_BONUS_PLAN");
    CachedRowSet bonus = new CachedRowSetImpl();
    bonus.populate(rs2);
    bonus.setMatchColumn(1); // EMP_ID is the first column
    jrs.addRowSet(bonus);

На этом этапе jrs представляет собой внутреннее соединение двух объектов RowSet по их столбцам EMP_ID. Теперь приложение может просматривать объединенные данные так, как если бы оно просматривало один объект RowSet. Поскольку jrs сам является объектом RowSet, приложение может перемещаться по нему или изменять его с помощью методов RowSet.

    jrs.first();
    int employeeID = jrs.getInt(1);
    String employeeName = jrs.getString(2);

Обратите внимание: поскольку при добавлении второго или последующего объекта RowSet приложением необходимо обеспечить выполнение SQL-JOIN, во время выполнения JOIN возможно первоначальное снижение производительности.

Следующий фрагмент кода добавляет еще один объект CachedRowSet. В этом случае столбец сопоставления (EMP_ID) задается при добавлении объекта CachedRowSet в объект JoinRowSet.

    ResultSet rs3 = stmt.executeQuery("SELECT * FROM 401K_CONTRIB");
    CachedRowSet fourO1k = new CachedRowSetImpl();
    four01k.populate(rs3);
    jrs.addRowSet(four01k, 1);

Объект JoinRowSet jrs теперь содержит значения из всех трех таблиц. В jrs добавлены данные из каждой строки таблицы four01k, в которой значение столбца EMP_ID совпадает со значением столбца EMP_ID в jrs.

4.0 Методы JoinRowSet

Интерфейс JoinRowSet предоставляет несколько методов для добавления объектов RowSet и получения сведений об объекте JoinRowSet.

• Методы для добавления одного или нескольких объектов RowSet
  Эти методы позволяют приложению добавлять по одному объекту RowSet или несколько объектов RowSet одновременно. В обоих случаях методы могут задавать столбец сопоставления для каждого добавляемого объекта RowSet.
• Методы для получения сведений
  Один метод получает объекты RowSet из объекта JoinRowSet, а другой — имена RowSet. Третий метод получает либо предложение SQL-WHERE, используемое для формирования JOIN, либо текстовое описание его назначения — того, что делает предложение WHERE.
• Методы, связанные с типом JOIN
  Один метод задает тип JOIN, а пять методов позволяют определить, поддерживает ли объект JoinRowSet указанный тип.
• Метод для создания отдельной копии объекта JoinRowSet
  Этот метод создает копию, которую можно сохранить в источнике данных.