Интерфейс Joinable

public interface Joinable

1.0 Общие сведения

Интерфейс Joinable предоставляет методы для получения и установки столбца сопоставления, который является основой для формирования SQL JOIN, образованного путём добавления объектов RowSet к объекту JoinRowSet.

Любая стандартная реализация RowSet может реализовать интерфейс Joinable для добавления к объекту JoinRowSet. Реализация этого интерфейса даёт объекту RowSet возможность использования методов Joinable, которые устанавливают, извлекают и получают информацию о столбцах сопоставления. Приложение может добавить объект RowSet, который не реализовал интерфейс Joinable, к объекту JoinRowSet, но для этого необходимо использовать один из методов JoinRowSet.addRowSet, который принимает как объект RowSet, так и столбец сопоставления или массив объектов RowSet и массив столбцов сопоставления.

Для получения доступа к методам интерфейса Joinable, объект RowSet реализует по меньшей мере один из пяти стандартных интерфейсов RowSet и также реализует интерфейс Joinable. Кроме того, большинство объектов RowSet расширяют класс BaseRowSet. Например:

class MyRowSetImpl extends BaseRowSet implements CachedRowSet, Joinable {
         :
         :
     }

2.0 Руководство по использованию

Методы интерфейса Joinable позволяют объекту RowSet устанавливать столбец сопоставления, извлекать столбец сопоставления или сбрасывать столбец сопоставления, который является столбцом, на основе которого можно построить SQL JOIN. Экземпляр класса, реализующего эти методы, можно добавить к объекту JoinRowSet для построения отношения SQL JOIN.

CachedRowSet crs = new MyRowSetImpl();
     crs.populate((ResultSet)rs);
     (Joinable)crs.setMatchColumnIndex(1);

     JoinRowSet jrs = new JoinRowSetImpl();
     jrs.addRowSet(crs);

В предыдущем примере crs – это объект CachedRowSet, который реализовал интерфейс Joinable. В следующем примере crs2 этого не сделал, поэтому он должен предоставить столбец сопоставления в качестве аргумента методу addRowSet. Этот пример предполагает, что столбец 1 является столбцом сопоставления.

CachedRowSet crs2 = new MyRowSetImpl();
     crs2.populate((ResultSet)rs);

     JoinRowSet jrs2 = new JoinRowSetImpl();
     jrs2.addRowSet(crs2, 1);

Интерфейс JoinRowSet позволяет получить данные из одного или нескольких объектов RowSet, объединённых в одну таблицу, без необходимости создания соединения с базой данных. Поэтому он идеально подходит для использования объектами RowSet без подключения. Тем не менее, любой объект RowSet может реализовать этот интерфейс независимо от того, подключён он или нет. Обратите внимание, что объект JdbcRowSet, всегда подключённый к источнику данных, может стать частью SQL JOIN непосредственно, без необходимости становиться частью объекта JoinRowSet.

3.0 Управление несколькими столбцами сопоставления

Индексный массив, передаваемый в методы setMatchColumn, указывает, сколько столбцов сопоставления устанавливается (длина массива), а также какие столбцы будут использованы для сопоставления. Например:

int[] i = {1, 2, 4, 7}; // indicates four match columns, with column
                             // indexes 1, 2, 4, 7 participating in the JOIN.
     Joinable.setMatchColumn(i);

Последующие столбцы сопоставления можно добавить следующим образом к другому объекту Joinable (объект RowSet, реализующий интерфейс Joinable).

int[] w = {3, 2, 5, 3};
     Joinable2.setMatchColumn(w);

Когда приложение добавляет два или более объектов RowSet к объекту JoinRowSet, порядок индексов в массиве имеет особое значение. Каждый индекс массива напрямую соответствует соответствующему индексу ранее добавленного объекта RowSet. Если возникает перекрытие или несовпадение, данные столбца сопоставления сохраняются в случае добавления дополнительного набора строк Joinable и необходимости связать их с данными столбца сопоставления. Таким образом, приложения могут устанавливать несколько столбцов сопоставления в любом порядке, но этот порядок напрямую влияет на результат объединения SQL JOIN.

Это утверждение применяется в точности так же, когда для указания столбцов сопоставления используются имена столбцов, а не индексы столбцов.