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