Joinable (Платформа Java SE 7)

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

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 MyRowSetImpl extends BaseRowSet implements CachedRowSet, Joinable {
         :
         :
     }
 
```
2.0 Инструкции по использованию

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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный Joinable

1.0 Фон

2.0 Инструкции по использованию

3.0 Управление Многократными Столбцами Соответствия

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

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

setMatchColumn

setMatchColumn

setMatchColumn

setMatchColumn

getMatchColumnIndexes

getMatchColumnNames

unsetMatchColumn

unsetMatchColumn

unsetMatchColumn

unsetMatchColumn