Интерфейс 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 , возможно временное снижение производительности во время выполнения SQL-соединения.

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