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