Интерфейс JoinRowSet

Все суперинтерфейсы:: AutoCloseable, CachedRowSet, Joinable, ResultSet, RowSet, WebRowSet, Wrapper

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 JOIN должно применяться, когда приложение добавляет второй или последующий объект 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
Этот метод создаёт копию, которая может быть сохранена в источнике данных.

Поля

Модификатор и тип	Поле и описание
`static int`	`CROSS_JOIN` ANSI-стиль `JOIN` , предоставляющий декартово произведение двух таблиц
`static int`	`FULL_JOIN` ANSI-стиль `JOIN` , предоставляющий полное соединение.
`static int`	`INNER_JOIN` ANSI-стиль `JOIN` , предоставляющий внутреннее соединение между двумя таблицами.
`static int`	`LEFT_OUTER_JOIN` ANSI-стиль `JOIN` , предоставляющий левое внешнее соединение между двумя таблицами.
`static int`	`RIGHT_OUTER_JOIN` ANSI-стиль `JOIN` , предоставляющий правое внешнее соединение между двумя таблицами.

Поля, унаследованные от интерфейса javax.sql.rowset.WebRowSet

PUBLIC_XML_SCHEMA, SCHEMA_SYSTEM_ID

Поля, унаследованные от интерфейса javax.sql.rowset.CachedRowSet

COMMIT_ON_ACCEPT_CHANGES

Поля, унаследованные от интерфейса java.sql.ResultSet

CLOSE_CURSORS_AT_COMMIT, CONCUR_READ_ONLY, CONCUR_UPDATABLE, FETCH_FORWARD, FETCH_REVERSE, FETCH_UNKNOWN, HOLD_CURSORS_OVER_COMMIT, TYPE_FORWARD_ONLY, TYPE_SCROLL_INSENSITIVE, TYPE_SCROLL_SENSITIVE

Методы

Модификатор и тип	Метод и описание
`void`	`addRowSet(Joinable rowset)` Добавляет указанный `RowSet` объект в этот `JoinRowSet` объект.
`void`	`addRowSet(RowSet[] rowset, int[] columnIdx)` Добавляет один или несколько `RowSet` объектов, содержащихся в заданном массиве `RowSet` объектов, в этот `JoinRowSet` объект и устанавливает столбец сопоставления для каждого из `RowSet` объектов в столбцы сопоставления в заданном массиве индексов столбцов.
`void`	`addRowSet(RowSet[] rowset, String[] columnName)` Добавляет один или несколько `RowSet` объектов, содержащихся в заданном массиве `RowSet` объектов, в этот `JoinRowSet` объект и устанавливает столбец сопоставления для каждого из `RowSet` объектов в столбцы сопоставления в заданном массиве имён столбцов.
`void`	`addRowSet(RowSet rowset, int columnIdx)` Добавляет заданный `RowSet` объект в этот `JoinRowSet` объект и устанавливает назначенный столбец в качестве столбца сопоставления для `RowSet` объекта.
`void`	`addRowSet(RowSet rowset, String columnName)` Добавляет rowset в этот `JoinRowSet` объект и устанавливает назначенный столбец в качестве столбца сопоставления.
`int`	`getJoinType()` Возвращает `int`, описывающий набор SQL `JOIN` типов, управляющих этим экземпляром JoinRowSet.
`String[]`	`getRowSetNames()` Возвращает массив `String`, содержащий имена `RowSet` объектов, добавленных в этот `JoinRowSet` объект.
`Collection<?>`	`getRowSets()` Возвращает объект `Collection`, содержащий `RowSet` объекты, которые были добавлены в этот `JoinRowSet` объект.
`String`	`getWhereClause()` Возвращает описание, подобное SQL, для условия WHERE, используемого в объекте JoinRowSet.
`void`	`setJoinType(int joinType)` Позволяет приложению настраивать тип `JOIN`, накладываемый на таблицы, содержащиеся в экземпляре объекта JoinRowSet.
`boolean`	`supportsCrossJoin()` Указывает, поддерживается ли CROSS_JOIN реализацией JoinRowSet.
`boolean`	`supportsFullJoin()` Указывает, поддерживается ли FULL_JOIN реализацией JoinRowSet.
`boolean`	`supportsInnerJoin()` Указывает, поддерживается ли INNER_JOIN реализацией JoinRowSet.
`boolean`	`supportsLeftOuterJoin()` Указывает, поддерживается ли LEFT_OUTER_JOIN реализацией JoinRowSet.
`boolean`	`supportsRightOuterJoin()` Указывает, поддерживается ли RIGHT_OUTER_JOIN реализацией JoinRowSet.
`CachedRowSet`	`toCachedRowSet()` Создаёт новый `CachedRowSet` объект, содержащий данные в этом `JoinRowSet` объекте, который может быть сохранён в источнике данных с использованием объекта `SyncProvider` для объекта `CachedRowSet`.

Методы, унаследованные от интерфейса javax.sql.rowset.WebRowSet

readXml, readXml, writeXml, writeXml, writeXml, writeXml

Методы, унаследованные от интерфейса javax.sql.rowset.CachedRowSet

acceptChanges, acceptChanges, columnUpdated, columnUpdated, commit, createCopy, createCopyNoConstraints, createCopySchema, createShared, execute, getKeyColumns, getOriginal, getOriginalRow, getPageSize, getRowSetWarnings, getShowDeleted, getSyncProvider, getTableName, nextPage, populate, populate, previousPage, release, restoreOriginal, rollback, rollback, rowSetPopulated, setKeyColumns, setMetaData, setOriginalRow, setPageSize, setShowDeleted, setSyncProvider, setTableName, size, toCollection, toCollection, toCollection, undoDelete, undoInsert, undoUpdate

Методы, унаследованные от интерфейса javax.sql.RowSet

addRowSetListener, clearParameters, execute, getCommand, getDataSourceName, getEscapeProcessing, getMaxFieldSize, getMaxRows, getPassword, getQueryTimeout, getTransactionIsolation, getTypeMap, getUrl, getUsername, isReadOnly, removeRowSetListener, setArray, setAsciiStream, setAsciiStream, setAsciiStream, setAsciiStream, setBigDecimal, setBigDecimal, setBinaryStream, setBinaryStream, setBinaryStream, setBinaryStream, setBlob, setBlob, setBlob, setBlob, setBlob, setBlob, setBoolean, setBoolean, setByte, setByte, setBytes, setBytes, setCharacterStream, setCharacterStream, setCharacterStream, setCharacterStream, setClob, setClob, setClob, setClob, setClob, setClob, setCommand, setConcurrency, setDataSourceName, setDate, setDate, setDate, setDate, setDouble, setDouble, setEscapeProcessing, setFloat, setFloat, setInt, setInt, setLong, setLong, setMaxFieldSize, setMaxRows, setNCharacterStream, setNCharacterStream, setNCharacterStream, setNCharacterStream, setNClob, setNClob, setNClob, setNClob, setNClob, setNClob, setNString, setNString, setNull, setNull, setNull, setNull, setObject, setObject, setObject, setObject, setObject, setObject, setPassword, setQueryTimeout, setReadOnly, setRef, setRowId, setRowId, setShort, setShort, setSQLXML, setSQLXML, setString, setString, setTime, setTime, setTime, setTime, setTimestamp, setTimestamp, setTimestamp, setTimestamp, setTransactionIsolation, setType, setTypeMap, setURL, setUrl, setUsername

Методы, унаследованные от интерфейса java.sql.ResultSet

absolute, afterLast, beforeFirst, cancelRowUpdates, clearWarnings, close, deleteRow, findColumn, first, getArray, getArray, getAsciiStream, getAsciiStream, getBigDecimal, getBigDecimal, getBigDecimal, getBigDecimal, getBinaryStream, getBinaryStream, getBlob, getBlob, getBoolean, getBoolean, getByte, getByte, getBytes, getBytes, getCharacterStream, getCharacterStream, getClob, getClob, getConcurrency, getCursorName, getDate, getDate, getDate, getDate, getDouble, getDouble, getFetchDirection, getFetchSize, getFloat, getFloat, getHoldability, getInt, getInt, getLong, getLong, getMetaData, getNCharacterStream, getNCharacterStream, getNClob, getNClob, getNString, getNString, getObject, getObject, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getRowId, getRowId, getShort, getShort, getSQLXML, getSQLXML, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isClosed, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateClob, updateClob, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNCharacterStream, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNClob, updateNString, updateNString, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateRowId, updateRowId, updateShort, updateShort, updateSQLXML, updateSQLXML, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull

Методы, унаследованные от интерфейса java.sql.Wrapper

isWrapperFor, unwrap

Методы, унаследованные от интерфейса javax.sql.rowset.Joinable

getMatchColumnIndexes, getMatchColumnNames, setMatchColumn, setMatchColumn, setMatchColumn, setMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn, unsetMatchColumn

Поля

CROSS_JOIN

static final int CROSS_JOIN

Стиль ANSI JOIN, обеспечивающий декартово произведение двух таблиц

См. также:: Constant Field Values

INNER_JOIN

static final int INNER_JOIN

Стиль ANSI JOIN, обеспечивающий внутреннее соединение между двумя таблицами. Любые несоответствующие строки в любой из таблиц соединения должны быть отброшены.

См. также:: Constant Field Values

LEFT_OUTER_JOIN

static final int LEFT_OUTER_JOIN

Стиль ANSI JOIN, обеспечивающий левое внешнее соединение между двумя таблицами. В SQL это описывается как возвращение всех записей с левой стороны оператора JOIN.

См. также:: Constant Field Values

RIGHT_OUTER_JOIN

static final int RIGHT_OUTER_JOIN

Стиль ANSI JOIN, обеспечивающий правое внешнее соединение между двумя таблицами. В SQL это описывается как возвращение всех записей из таблицы в правой части оператора JOIN, даже если в левой таблице нет соответствующей записи.

См. также:: Constant Field Values

FULL_JOIN

static final int FULL_JOIN

Стиль ANSI JOIN, обеспечивающий полное соединение JOIN. Указывает, что должны быть возвращены все строки из любой таблицы независимо от наличия соответствующих записей в другой таблице.

См. также:: Constant Field Values

Методы

addRowSet

void addRowSet(Joinable rowset)
        throws SQLException

Добавляет данный объект RowSet к этому объекту JoinRowSet. Если объект RowSet является первым, который добавляется к этому объекту JoinRowSet, он образует основу связи JOIN, которая будет установлена.

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

Примечание: Объект Joinable — это любой объект RowSet, реализующий интерфейс Joinable.

Параметры:: rowset - объект RowSet, который должен быть добавлен к этому объекту JoinRowSet; он должен реализовывать интерфейс Joinable и иметь установленный столбец соответствия
Исключения:: SQLException - если (1) пустой набор строк добавляется к этому объекту JoinRowSet, (2) столбец соответствия не установлен для rowset или (3) rowset нарушает активный JOIN
См. также:: Joinable.setMatchColumn(int)

addRowSet

void addRowSet(RowSet rowset,
               int columnIdx)
        throws SQLException

Добавляет данный объект RowSet к этому объекту JoinRowSet и устанавливает указанный столбец в качестве столбца соответствия для объекта RowSet. Если объект RowSet является первым, который добавляется к этому объекту JoinRowSet, он образует основу связи JOIN, которая будет установлена.

Этот метод следует использовать, если у RowSet еще не установлен столбец соответствия.

Параметры:: rowset - объект RowSet, который должен быть добавлен к этому объекту JoinRowSet; он может реализовывать интерфейс Joinable; columnIdx - int, идентифицирующий столбец, который станет столбцом соответствия
Исключения:: SQLException - если (1) rowset — это пустой набор строк или (2) rowset нарушает активный JOIN
См. также:: Joinable.unsetMatchColumn(int)

addRowSet

void addRowSet(RowSet rowset,
               String columnName)
        throws SQLException

Добавляет rowset к этому объекту JoinRowSet и устанавливает указанный столбец в качестве столбца соответствия. Если rowset является первым, который добавляется к этому объекту JoinRowSet, он образует основу связи JOIN, которая будет установлена.

Этот метод следует использовать, если у данного объекта RowSet еще не установлен столбец соответствия.

Параметры:: rowset - объект RowSet, который должен быть добавлен к этому объекту JoinRowSet; он может реализовывать интерфейс Joinable; columnName - объект String, указывающий имя столбца, который будет установлен в качестве столбца соответствия
Исключения:: SQLException - если (1) rowset — это пустой набор строк или (2) столбец соответствия для rowset не удовлетворяет условиям JOIN

addRowSet

void addRowSet(RowSet[] rowset,
               int[] columnIdx)
        throws SQLException

Добавляет один или несколько объектов RowSet, содержащихся в данном массиве объектов RowSet, к этому объекту JoinRowSet и устанавливает столбец соответствия для каждого из объектов RowSet в столбцы соответствия в данном массиве индексов столбцов. Первый элемент в columnIdx устанавливается в качестве столбца соответствия для первого объекта RowSet в rowset, второй элемент columnIdx устанавливается в качестве столбца соответствия для второго элемента в rowset и так далее.

Первый объект RowSet, добавленный к этому объекту JoinRowSet, образует основу связи JOIN.

Этот метод следует использовать, если у данного объекта RowSet еще не установлен столбец соответствия.

Параметры:: rowset - массив из одного или нескольких объектов RowSet, которые должны быть добавлены к JOIN; он может реализовывать интерфейс Joinable; columnIdx - массив значений int, указывающих индекс(ы) столбцов, которые должны быть установлены в качестве столбцов соответствия для объектов RowSet в rowset
Исключения:: SQLException - если (1) пустой набор строк добавляется к этому объекту JoinRowSet, (2) столбец соответствия не установлен для объекта RowSet в rowset или (3) добавляемый объект RowSet нарушает активный JOIN

addRowSet

void addRowSet(RowSet[] rowset,
               String[] columnName)
        throws SQLException

Добавляет один или несколько объектов RowSet, содержащихся в данном массиве объектов RowSet, к этому объекту JoinRowSet и устанавливает столбец соответствия для каждого из объектов RowSet в столбцы соответствия в данном массиве имен столбцов. Первый элемент в columnName устанавливается в качестве столбца соответствия для первого объекта RowSet в rowset, второй элемент columnName устанавливается в качестве столбца соответствия для второго элемента в rowset и так далее.

Первый объект RowSet, добавленный к этому объекту JoinRowSet, образует основу связи JOIN.

Этот метод следует использовать, если у данного объекта(ов) RowSet еще не установлен столбец соответствия.

Параметры:: rowset - массив из одного или нескольких объектов RowSet, которые должны быть добавлены к JOIN; он может реализовывать интерфейс Joinable; columnName - массив значений String, указывающих имена столбцов, которые должны быть установлены в качестве столбцов соответствия для объектов RowSet в rowset
Исключения:: SQLException - если (1) пустой набор строк добавляется к этому объекту JoinRowSet, (2) столбец соответствия не установлен для объекта RowSet в rowset или (3) добавляемый объект RowSet нарушает активный JOIN

getRowSets

Collection<?> getRowSets()
                  throws SQLException

Возвращает объект Collection, содержащий объекты RowSet, которые были добавлены к этому объекту JoinRowSet. Это должно возвращать 'n' количество RowSet, содержащихся в JOIN, и сохранять любые обновления, которые произошли во время этого объединения.

Возвращает:: объект Collection, состоящий из объектов RowSet, добавленных к этому объекту JoinRowSet
Исключения:: SQLException - если возникает ошибка при создании объекта Collection, который должен быть возвращен

getRowSetNames

String[] getRowSetNames()
                 throws SQLException

Возвращает массив String, содержащий имена объектов RowSet, добавленных к этому объекту JoinRowSet.

Возвращает:: массив String имен объектов RowSet в этом объекте JoinRowSet
Исключения:: SQLException - если возникает ошибка при извлечении имен объектов RowSet
См. также:: CachedRowSet.setTableName(java.lang.String)

toCachedRowSet

CachedRowSet toCachedRowSet()
                     throws SQLException

Создает новый объект CachedRowSet, содержащий данные в этом объекте JoinRowSet, который может быть сохранен в источник данных с использованием объекта SyncProvider для объекта CachedRowSet.

Если какие-либо обновления или изменения были применены к JoinRowSet, возвращаемый методом CachedRowSet не сможет сохранить свои изменения обратно в исходные строки и таблицы в источнике данных. Возвращаемый экземпляр CachedRowSet не должен содержать данные об изменении, и он должен очистить все свойства своего исходного оператора SQL. Приложение должно сбросить оператор SQL с помощью метода RowSet.setCommand.

Чтобы разрешить сохранение изменений обратно в источник данных в исходные таблицы, следует использовать метод acceptChanges и вызвать его для экземпляра объекта JoinRowSet. Реализации могут использовать внутренние данные и отслеживание изменений в своих реализациях для взаимодействия с SyncProvider для сохранения любых изменений.

Возвращает:: CachedRowSet, содержащий содержимое JoinRowSet
Выбрасывает:: SQLException - если произошла ошибка при сборке объекта CachedRowSet
См. также:: RowSet, CachedRowSet, SyncProvider

supportsCrossJoin

boolean supportsCrossJoin()

Указывает, поддерживается ли CROSS_JOIN реализацией JoinRowSet

Возвращает:: true, если CROSS_JOIN поддерживается; false в противном случае

supportsInnerJoin

boolean supportsInnerJoin()

Указывает, поддерживается ли INNER_JOIN реализацией JoinRowSet

Возвращает:: true, если INNER_JOIN поддерживается; false в противном случае

supportsLeftOuterJoin

boolean supportsLeftOuterJoin()

Указывает, поддерживается ли LEFT_OUTER_JOIN реализацией JoinRowSet

Возвращает:: true, если LEFT_OUTER_JOIN поддерживается; false в противном случае

supportsRightOuterJoin

boolean supportsRightOuterJoin()

Указывает, поддерживается ли RIGHT_OUTER_JOIN реализацией JoinRowSet

Возвращает:: true, если RIGHT_OUTER_JOIN поддерживается; false в противном случае

supportsFullJoin

boolean supportsFullJoin()

Указывает, поддерживается ли FULL_JOIN реализацией JoinRowSet

Возвращает:: true, если FULL_JOIN поддерживается; false в противном случае

setJoinType

void setJoinType(int joinType)
          throws SQLException

Позволяет приложению настроить тип JOIN, накладываемый на таблицы, содержащиеся в объекте JoinRowSet. Реализации должны выбросить SQLException, если они не поддерживают заданный тип JOIN.

Параметры:: joinType - стандартное статическое поле JoinRowSet.XXX, определяющее тип SQL JOIN, чтобы переконфигурировать экземпляр JoinRowSet на лету.
Выбрасывает:: SQLException - если задан неподдерживаемый тип JOIN
См. также:: getJoinType()

getWhereClause

String getWhereClause()
               throws SQLException

Возвращает текстовое описание условия WHERE, используемого в объекте JoinRowSet. Реализация может описать условие WHERE SQL запроса, предоставив строку SQL-описания JOIN, или дать текстовое описание для помощи приложениям, использующим JoinRowSet

Возвращает:: whereClause - текстовое или SQL-описание логического условия WHERE, используемого в экземпляре JoinRowSet
Выбрасывает:: SQLException - если произошла ошибка при генерации представления условия WHERE.

getJoinType

int getJoinType()
         throws SQLException

Возвращает тип int, описывающий установленный SQL тип JOIN для данного экземпляра JoinRowSet. Возвращаемый тип будет одним из стандартных типов JoinRowSet: CROSS_JOIN, INNER_JOIN, LEFT_OUTER_JOIN, RIGHT_OUTER_JOIN или FULL_JOIN.

Возвращает:: joinType - одно из стандартных статических полей JoinRowSet, определяющих тип SQL JOIN. JoinRowSet.INNER_JOIN возвращается как значение по умолчанию, если явным образом не был задан тип JOIN
Выбрасывает:: SQLException - если произошла ошибка при определении типа SQL JOIN, поддерживаемого экземпляром JoinRowSet.
См. также:: setJoinType(int)

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Интерфейс JoinRowSet

1.0 Обзор

2.0 Использование объекта JoinRowSet для создания JOIN

3.0 Пример использования

4.0 Методы JoinRowSet

Поля

Поля, унаследованные от интерфейса javax.sql.rowset.WebRowSet

Поля, унаследованные от интерфейса javax.sql.rowset.CachedRowSet

Поля, унаследованные от интерфейса java.sql.ResultSet

Методы

Методы, унаследованные от интерфейса javax.sql.rowset.WebRowSet

Методы, унаследованные от интерфейса javax.sql.rowset.CachedRowSet

Методы, унаследованные от интерфейса javax.sql.RowSet

Методы, унаследованные от интерфейса java.sql.ResultSet

Методы, унаследованные от интерфейса java.sql.Wrapper

Методы, унаследованные от интерфейса javax.sql.rowset.Joinable

Поля

CROSS_JOIN

INNER_JOIN

LEFT_OUTER_JOIN

RIGHT_OUTER_JOIN

FULL_JOIN

Методы

addRowSet

addRowSet

addRowSet

addRowSet

addRowSet

getRowSets

getRowSetNames

toCachedRowSet

supportsCrossJoin

supportsInnerJoin

supportsLeftOuterJoin

supportsRightOuterJoin

supportsFullJoin

setJoinType

getWhereClause

getJoinType

2.0 Использование объекта `JoinRowSet` для создания `JOIN`

4.0 Методы `JoinRowSet`