compact3

javax.sql.rowset

Интерфейс Joinable

Все Известные Подынтерфейсы:

CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, WebRowSet

public interface Joinable

1.0 Фон

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

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

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

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

2.0 Направляющие линии использования

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

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

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

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

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

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

JoinRowSet интерфейс позволяет получить данные от один или больше RowSet объекты, консолидированные в одну таблицу, не имея необходимость подвергаться расходу создания соединения с базой данных. Это поэтому идеально подходит для использования разъединенным RowSet объекты. Однако, любой RowSet объект может реализовать этот интерфейс независимо от того, соединяется ли это или разъединяется. Отметьте это a JdbcRowSet объект, будучи всегда соединенным с его источником данных, может стать частью SQL JOIN непосредственно не имея необходимость становиться частью a 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 объект (a RowSet объект, который реализовал Joinable интерфейс).

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

Когда приложение добавляет два или больше RowSet объекты к a JoinRowSet объект, порядок индексирования в массиве особенно важен. Каждый индексирует карт массива непосредственно к соответствию, индексируют ранее добавленный RowSet объект. Если перекрытие или underlap происходят, данные столбца соответствия сохраняются в конечном счете дополнительное Joinable RowSet добавляется и должен коснуться данных столбца соответствия. Поэтому, приложения могут установить многократные столбцы соответствия в любом порядке, но этот порядок оказывает прямое влияние на результат SQL СОЕДИНЕНИЕ.

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

См. Также:

JoinRowSet

Сводка метода

Модификатор и Тип	Метод и Описание
int[]	getMatchColumnIndexes() Получает индексирование столбцов соответствия, которые были установлены для этого RowSet объект с методом setMatchColumn(int[] columnIdxes).
Строка[]	getMatchColumnNames() Получает имена столбцов соответствия, которые были установлены для этого RowSet объект с методом setMatchColumn(String [] columnNames).
void	setMatchColumn(int columnIdx) Устанавливает определяемый столбец как столбец соответствия для этого RowSet объект.
void	setMatchColumn(int[] columnIdxes) Устанавливает определяемые столбцы как столбец соответствия для этого RowSet объект.
void	setMatchColumn(String columnName) Устанавливает определяемый столбец как столбец соответствия для этого RowSet объект.
void	setMatchColumn(String[] columnNames) Устанавливает определяемые столбцы как столбец соответствия для этого RowSet объект.
void	unsetMatchColumn(int columnIdx) Сбрасывает определяемый столбец как столбец соответствия для этого RowSet объект.
void	unsetMatchColumn(int[] columnIdxes) Сбрасывает определяемые столбцы как столбец соответствия для этого RowSet объект.
void	unsetMatchColumn(String columnName) Сбрасывает определяемый столбец как столбец соответствия для этого RowSet объект.
void	unsetMatchColumn(String[] columnName) Сбрасывает определяемые столбцы как столбцы соответствия для этого RowSet объект.

Деталь метода

setMatchColumn

void setMatchColumn(int columnIdx)
             throws SQLException

Устанавливает определяемый столбец как столбец соответствия для этого RowSet объект. A JoinRowSet объект может теперь добавить это RowSet основанный на объектах на столбце соответствия.

Подинтерфейсы такой как CachedRowSetИнтерфейс ^ТМ определяет метод CachedRowSet.setKeyColumns, который позволяет семантике первичного ключа быть осуществленной на определенных столбцах. Реализации setMatchColumn(int columnIdx) метод должен гарантировать, что ограничения на ключевые столбцы сохраняются когда a CachedRowSet возразите устанавливает столбец первичного ключа как столбец соответствия.

Параметры:

columnIdx - int идентификация индексирования столбца, который будет установлен как столбец соответствия

Броски:

SQLException - если недопустимый столбец индексирует, устанавливается

См. Также:

setMatchColumn(int[]), unsetMatchColumn(int)

setMatchColumn

void setMatchColumn(int[] columnIdxes)
             throws SQLException

Устанавливает определяемые столбцы как столбец соответствия для этого RowSet объект. A JoinRowSet объект может теперь добавить это RowSet основанный на объектах на столбце соответствия.

Параметры:

columnIdxes - массив int идентификация индексирования столбцов, которые будут установлены как столбцы соответствия

Броски:

SQLException - если недопустимый столбец индексирует, устанавливается

См. Также:

setMatchColumn(int[]), unsetMatchColumn(int[])

setMatchColumn

void setMatchColumn(String columnName)
             throws SQLException

Устанавливает определяемый столбец как столбец соответствия для этого RowSet объект. A JoinRowSet объект может теперь добавить это RowSet основанный на объектах на столбце соответствия.

Подынтерфейсы такой как CachedRowSet интерфейс определяет метод CachedRowSet.setKeyColumns, который позволяет семантике первичного ключа быть осуществленной на определенных столбцах. Реализации setMatchColumn(String columnIdx) метод должен гарантировать, что ограничения на ключевые столбцы сохраняются когда a CachedRowSet возразите устанавливает столбец первичного ключа как столбец соответствия.

Параметры:

columnName - a String объект, дающий имя столбца, который будет установлен как столбец соответствия

Броски:

SQLException - если недопустимое имя столбца устанавливается, имя столбца является нулем, или имя столбца является пустой строкой

См. Также:

unsetMatchColumn(int), setMatchColumn(int[])

setMatchColumn

void setMatchColumn(String[] columnNames)
             throws SQLException

Устанавливает определяемые столбцы как столбец соответствия для этого RowSet объект. A JoinRowSet объект может теперь добавить это RowSet основанный на объектах на столбце соответствия.

Параметры:

columnNames - массив String объекты, дающие имена столбца, который будет установлен как столбцы соответствия

Броски:

SQLException - если недопустимое имя столбца устанавливается, имя столбца является нулем, или имя столбца является пустой строкой

См. Также:

unsetMatchColumn(int), setMatchColumn(int[])

getMatchColumnIndexes

int[] getMatchColumnIndexes()
                     throws SQLException

Получает индексирование столбцов соответствия, которые были установлены для этого RowSet объект с методом setMatchColumn(int[] columnIdxes).

Возвраты:

int массив, идентифицирующий индексирование столбцов, которые были установлены как столбцы соответствия для этого RowSet объект

Броски:

SQLException - если никакой столбец соответствия не был установлен

См. Также:

setMatchColumn(int), unsetMatchColumn(int)

getMatchColumnNames

String[] getMatchColumnNames()
                      throws SQLException

Получает имена столбцов соответствия, которые были установлены для этого RowSet объект с методом setMatchColumn(String [] columnNames).

Возвраты:

массив String объекты, дающие имена набора столбцов как столбцы соответствия для этого RowSet объект

Броски:

SQLException - если никакой столбец соответствия не был установлен

См. Также:

setMatchColumn(int), unsetMatchColumn(int)

unsetMatchColumn

void unsetMatchColumn(int columnIdx)
               throws SQLException

Сбрасывает определяемый столбец как столбец соответствия для этого RowSet объект.

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

Параметры:

columnIdx - int это идентифицирует индексирование столбца, который должен быть сброшен как столбец соответствия

Броски:

SQLException - если недопустимый столбец индексирует, определяется или если определяемый столбец не был ранее установлен как столбец соответствия

См. Также:

setMatchColumn(int)

unsetMatchColumn

void unsetMatchColumn(int[] columnIdxes)
               throws SQLException

Сбрасывает определяемые столбцы как столбец соответствия для этого RowSet объект.

Параметры:

columnIdxes - arrary int это идентифицирует индексирование столбцов, которые должны быть сброшены как столбцы соответствия

Броски:

SQLException - если недопустимый столбец индексирует, определяется или если определяемый столбец не был ранее установлен как столбец соответствия

См. Также:

setMatchColumn(int)

unsetMatchColumn

void unsetMatchColumn(String columnName)
               throws SQLException

Сбрасывает определяемый столбец как столбец соответствия для этого RowSet объект.

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

Параметры:

columnName - a String объект, дающий имя столбца, который должен быть сброшен как столбец соответствия

Броски:

SQLException - если недопустимое имя столбца определяется, или определяемый столбец не был ранее установлен как столбец соответствия

См. Также:

setMatchColumn(int)

unsetMatchColumn

void unsetMatchColumn(String[] columnName)
               throws SQLException

Сбрасывает определяемые столбцы как столбцы соответствия для этого RowSet объект.

Параметры:

columnName - массив String объекты, дающие имена столбцов, которые должны быть сброшены как столбцы соответствия

Броски:

SQLException - если недопустимое имя столбца определяется, или определяемый столбец не был ранее установлен как столбец соответствия

См. Также:

setMatchColumn(int)