Интерфейс 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.

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