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