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

Любое количество объектов RowSet может быть добавлено к экземпляру объекта JoinRowSet , при условии, что они могут быть связаны в 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 . Объект RowSet должен реализовать интерфейс Joinable для использования метода setMatchColumn. После установки значения столбца сопоставления этот метод можно использовать для сброса столбца сопоставления в любое время.
• Вызвать одну из версий метода 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 . В этом случае все лица в рамках плана бонусов являются сотрудниками, поэтому все строки таблицы ESSP_BONUS_PLAN добавляются в объект JoinRowSet . В этом примере оба объекта 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);

Обратите внимание, что поскольку SQL-соединение должно выполняться, когда приложение добавляет второй или последующий объект RowSet , может произойти начальное ухудшение производительности во время выполнения 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 теперь содержит значения из всех трех таблиц. Данные в каждой строке в four01k, в которой значение столбца EMP_ID совпадает со значением столбца EMP_ID в jrs, были добавлены в jrs.

4.0 Методы JoinRowSet

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

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