javax.sql.rowset

インタフェース JoinRowSet

すべてのスーパーインタフェース:

AutoCloseable、CachedRowSet、Joinable、ResultSet、RowSet、WebRowSet、Wrapper

public interface JoinRowSet
extends WebRowSet

JoinRowSet インタフェースは、異なった RowSet オブジェクトの関連データを、SQL JOIN を表す 1 つの JoinRowSet オブジェクトにまとめるメカニズムを提供します。つまり、JoinRowSet オブジェクトは、SQL JOIN 関係を形成する RowSet オブジェクトからのデータのコンテナとして動作します。

Joinable インタフェースは、SQL JOIN 関係確立の基盤となる一致列の設定、取得、および設定解除のメソッドを提供します。または、一致列は JointRowSet の addRowSet メソッドの適切なバージョンを指定することによっても設定できます。

1.0 概要

未接続の RowSet オブジェクト (CachedRowSet オブジェクトと、CachedRowSet インタフェースを拡張する実装) は、データソースに再接続する手間なしで、RowSet オブジェクト間に SQL JOIN を確立する標準の方法を持ちません。JoinRowSet インタフェースは、このニーズに対応するために設計されています。

JoinRowSet オブジェクトに RowSet オブジェクトを追加して、SQL JOIN 関係を構成できます。つまり、RowSet オブジェクトは、接続されている場合でも未接続の場合でも、JOIN を構成することができます。接続環境で動作する RowSet オブジェクト (JdbcRowSet オブジェクト) は、すでに接続しているデータベースを使って、表間に直接 SQL JOIN 関係を確立することをお勧めします。しかし、必要に応じて、JoinRowSet オブジェクトに JdbcRowSet オブジェクトを追加することもできます。

単一の SQL JOIN に関連付けられる JoinRowSet のインスタンスであれば、任意の数の RowSet オブジェクトをそのインスタンスに追加できます。定義によると、SQL JOIN 文は、複数のリレーショナルデータベーステーブルに格納されたデータを、共通の属性に基づいてまとめるために使用されます。Joinable インタフェースは、一致列の設定により共通属性を作成するメソッドを提供します。一致列は、一般的に主キーと一致しますが、必ずしも一致列が主キーと同一である必要はありません。列の一致を確立し、適用することで、JoinRowSet オブジェクトは、使用可能なリレーショナルデータベースを使用せずに、RowSet オブジェクト間に JOIN 関係を確立します。

確立される JOIN の型は、setJoinType メソッドを使って JoinRowSet 定数を 1 つ設定することで決定されます。次の SQL JOIN 型を設定できます。

• CROSS_JOIN
• FULL_JOIN
• INNER_JOIN - JOIN 型が設定されていない場合のデフォルト
• LEFT_OUTER_JOIN
• RIGHT_OUTER_JOIN

型を設定していない場合、JOIN は自動的に内部結合になります。JoinRowSet インタフェースのフィールドのコメントに、標準 SQL JOIN 型であるこれらの JOIN 型が説明されています。

2.0 JoinRowSet オブジェクトによる JOIN の作成

JoinRowSet オブジェクトの作成時には、このオブジェクトは空の状態です。最初に追加された RowSet オブジェクトが JOIN 関係の基盤になります。アプリケーションでは、JoinRowSet オブジェクトに追加する各 RowSet オブジェクトのどの列を一致列にするかを決定する必要があります。すべての RowSet オブジェクトに一致列が格納され、各一致列の値は、ほかの一致列の値と比較可能な値である必要があります。列には同じ名前を付けることが多いですが、その必要はなく、比較可能なデータ型であれば、まったく同じデータ型を格納する必要もありません。

一致列は、次の 2 とおりの方法で設定できます。

• Joinable の setMatchColumn メソッドの呼び出しによる設定。
  これは RowSet オブジェクトを JoinRowSet オブジェクトに追加する前に一致列を設定できる唯一の方法です。setMatchColumn メソッドを使うには、RowSet オブジェクトが Joinable インタフェースを実装している必要があります。一致列値を設定したら、このメソッドを使用して、いつでも一致列をリセットできます。
• 列名または列番号 (または列名または列番号の配列) をとる JoinRowSet の addRowSet メソッドのいずれかのバージョンの呼び出しによる設定。
  5 つの addRowSet メソッドのうち 4 つは、一致列をパラメータに取ります。これらの 4 つのメソッドは、RowSet オブジェクトが JoinRowSet オブジェクトへ追加されるときに、一致列を設定またはリセットします。

3.0 使用例

次のコードの抜粋では、JoinRowSet オブジェクトに 2 つの CachedRowSet オブジェクトを追加します。この例では、SQL JOIN 型ではなく、デフォルトの JOIN 型である INNER_JOIN が確立されている点に注目してください。

次のコードの抜粋では、表 EMPLOYEES (最初の列 EMP_ID が一致列に設定されている) が、JoinRowSet オブジェクト jrs に追加されます。続いて、表 ESSP_BONUS_PLAN (一致列は同じく EMP_ID 列) が追加されます。この 2 番目の表が jrs に追加されるとき、追加されるのは、表 EMPLOYEES 内の EMP_ID 値に一致した EMP_ID 値を持つ ESSP_BONUS_PLAN 内の列だけです。この場合、ボーナス制度 (bonus plan) の全員が従業員 (employee) であるため、表 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 は、2 つの RowSet オブジェクトの EMP_ID 列に基づく内部 JOIN になります。アプリケーションは、あたかも単一の RowSet オブジェクトをブラウズするかのようにして、結合されたデータをブラウズできます。jrs i自体が RowSet オブジェクトなので、アプリケーションは、RowSet メソッドを使って、jrs のナビゲートや変更を行うことができます。

     jrs.first();
     int employeeID = jrs.getInt(1);
     String employeeName = jrs.getString(2);
 

アプリケーションが 2 番目または後続の RowSet オブジェクトを追加する場合は、SQL JOIN を適用する必要があるので、JOIN の実行時に初期パフォーマンスが低下する可能性があります。

次のコードの抜粋は、その他の CachedRowSet オブジェクトを追加します。この例では、JoinRowSet オブジェクトに CachedRowSet が追加されるとき、一致列 (EMP_ID) が設定されます。

     ResultSet rs3 = stmt.executeQuery("SELECT * FROM 401K_CONTRIB");
     CachedRowSet fourO1k = new CachedRowSetImpl();
     four01k.populate(rs3);
     jrs.addRowSet(four01k, 1);
 

JoinRowSet オブジェクト jrs に、3 つの表の値がすべて追加されました。EMP_ID 列の値が jrs 内の EMP_ID 列の値と一致している four01k 内の各行のデータが、jrs に追加されています。

4.0 JoinRowSet のメソッド

JoinRowSet インタフェースは、RowSet オブジェクトの追加や JoinRowSet オブジェクトの情報の取得を行う複数のメソッドを提供します。

• 1 つ以上の RowSet オブジェクトを追加するメソッド
  これらのメソッドを使用すると、アプリケーションに、一度に 1 つの RowSet オブジェクトを追加することも、または同時に複数の RowSet オブジェクトを追加することもできます。どちらの場合でも、メソッドは、追加される各 RowSet オブジェクトの一致列を指定できます。
• 情報を取得するメソッド
  JoinRowSet オブジェクト内の RowSet オブジェクトを取得するメソッド、RowSet 名を取得するメソッドのほか、JOIN を構成するために背後で使用される SQL WHERE 節か、WHERE 節の実行内容を説明するテキストを取得するメソッドがあります。
• JOIN の型に関連するメソッド
  JOIN 型を設定するメソッドが 1 つ、JoinRowSet オブジェクトが指定された型をサポートするかどうかを確認するメソッドが 5 つあります。
• JoinRowSet オブジェクトのコピーを作成するメソッド
  このメソッドは、データソースに対する持続的なコピーを作成します。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static int	CROSS_JOIN 2 つの表のクロス製品を提供する ANSI 型 JOIN です。
static int	FULL_JOIN 完全 JOIN を提供する ANSI 型 JOIN です。
static int	INNER_JOIN 2 つの表を内部結合させる ANSI 型 JOIN です。
static int	LEFT_OUTER_JOIN 2 つの表を左外部結合させる ANSI 型 JOIN です。
static int	RIGHT_OUTER_JOIN 2 つの表を右外部結合させる 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 オブジェクトの配列に含まれる 1 つ以上の RowSet オブジェクトをこの JoinRowSet オブジェクトに追加し、各 RowSet オブジェクトの一致列を指定された列インデックスの配列内の一致列に設定します。
void	addRowSet(RowSet[] rowset, String[] columnName) 指定された RowSet オブジェクトの配列に含まれる 1 つ以上の RowSet オブジェクトをこの JoinRowSet オブジェクトに追加し、各 RowSet オブジェクトの一致列を指定された列名の配列内の一致列に設定します。
void	addRowSet(RowSet rowset, int columnIdx) 指定された RowSet オブジェクトをこの JoinRowSet オブジェクトに追加し、指定された列を RowSet オブジェクトの一致列として設定します。
void	addRowSet(RowSet rowset, String columnName) rowset をこの JoinRowSet オブジェクトに追加し、指定された列を一致列に設定します。
int	getJoinType() この JoinRowSet インスタンスを管理する SQL JOIN 型を記述する int を返します。
String[]	getRowSetNames() この JoinRowSet オブジェクトに追加された RowSet オブジェクトの名前を含む String 配列を返します。
Collection<?>	getRowSets() この JoinRowSet オブジェクトに追加された RowSet オブジェクトを含む Collection オブジェクトを返します。
String	getWhereClause() JoinRowSet オブジェクトで使用される、SQL によく似た WHERE 節の記述を返します。
void	setJoinType(int joinType) アプリケーションに、JoinRowSet オブジェクトインスタンス内の表に適用される JOIN の型の調整を許可します。
boolean	supportsCrossJoin() JoinRowSet 実装が CROSS_JOIN をサポートするかどうかを示します。
boolean	supportsFullJoin() JoinRowSet 実装が FULL_JOIN をサポートするかどうかを示します。
boolean	supportsInnerJoin() JoinRowSet 実装が INNER_JOIN をサポートするかどうかを示します。
boolean	supportsLeftOuterJoin() JoinRowSet 実装が LEFT_OUTER_JOIN をサポートするかどうかを示します。
boolean	supportsRightOuterJoin() JoinRowSet 実装が RIGHT_OUTER_JOIN をサポートするかどうかを示します。
CachedRowSet	toCachedRowSet() この JoinRowSet オブジェクト内のデータを含む新しい CachedRowSet オブジェクトを作成します。これは、CachedRowSet オブジェクトの SyncProvider オブジェクトを使って、データソースに保存することができます。

インタフェース 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, 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

2 つの表のクロス製品を提供する ANSI 型 JOIN です。

関連項目:

定数フィールド値

INNER_JOIN

static final int INNER_JOIN

2 つの表を内部結合させる ANSI 型 JOIN です。結合した表のいずれかに一致しない行がある場合、この行は削除されます。

関連項目:

定数フィールド値

LEFT_OUTER_JOIN

static final int LEFT_OUTER_JOIN

2 つの表を左外部結合させる ANSI 型 JOIN です。SQL では、JOIN 文の左側からすべてのレコードが返される位置として記述されます。

関連項目:

定数フィールド値

RIGHT_OUTER_JOIN

static final int RIGHT_OUTER_JOIN

2 つの表を右外部結合させる ANSI 型 JOIN です。SQL では、左側の表に一致するレコードがない場合でも、JOIN 文の右側の表からすべてのレコードが返される位置として記述されます。

関連項目:

定数フィールド値

FULL_JOIN

static final int FULL_JOIN

完全 JOIN を提供する ANSI 型 JOIN です。一方の表から、もう一方の表の一致レコードとは無関係に返されるすべての行を指定します。

関連項目:

定数フィールド値

メソッドの詳細

addRowSet

void addRowSet(Joinable rowset)
               throws SQLException

指定された RowSet オブジェクトをこの JoinRowSet オブジェクトに追加します。RowSet オブジェクトがこの JoinRowSet オブジェクトに追加される最初のオブジェクトである場合、JOIN 関係が確立される基盤となります。

このメソッドは、指定された RowSet オブジェクトが Joinable の setMatchColumn メソッドで設定された一致列をすでに持っている場合にのみ使用する必要があります。

注: Joinable オブジェクトは、Joinable インタフェースを実装している任意の RowSet オブジェクトです。

パラメータ:

rowset - この JoinRowSet オブジェクトに追加される RowSet オブジェクト。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 - この JoinRowSet オブジェクトに追加される RowSet オブジェクト。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 - この JoinRowSet オブジェクトに追加される RowSet オブジェクト。Joinable インタフェースを実装できる

columnName - 一致列として設定される列の名前を指定する String オブジェクト

例外:

SQLException - (1) rowset が空の行セットの場合、(2) rowset の一致列が JOIN 条件を満たしていない場合

addRowSet

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

指定された RowSet オブジェクトの配列に含まれる 1 つ以上の RowSet オブジェクトをこの JoinRowSet オブジェクトに追加し、各 RowSet オブジェクトの一致列を指定された列インデックスの配列内の一致列に設定します。columnIdx の最初の要素は、rowset の最初の RowSet オブジェクトの一致列、columnIdx の 2 番目の要素は rowset の 2 番目の要素の一致列 (以下同様) に設定されます。

この JoinRowSet オブジェクトに追加される最初の RowSet オブジェクトが、JOIN 関係の基盤になります。

このメソッドは、指定された RowSet オブジェクトがまだ一致列を持たない場合に使用されます。

パラメータ:

rowset - JOIN に追加される 1 つ以上の RowSet オブジェクトの配列。Joinable インタフェースを実装できる

columnIdx - rowset の RowSet オブジェクトの一致列として設定する列のインデックスを示す int 値の配列

例外:

SQLException - (1) この JoinRowSet オブジェクトに空の行セットが追加された場合、(2) rowset 内の RowSet オブジェクトに一致列が設定されていない場合、(3) 追加される RowSet オブジェクトがアクティブな JOIN に違反する場合

addRowSet

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

指定された RowSet オブジェクトの配列に含まれる 1 つ以上の RowSet オブジェクトをこの JoinRowSet オブジェクトに追加し、各 RowSet オブジェクトの一致列を指定された列名の配列内の一致列に設定します。columnName の最初の要素は、rowset の最初の RowSet オブジェクトの一致列、columnName の 2 番目の要素は rowset の 2 番目の要素の一致列 (以下同様) に設定されます。

この JoinRowSet オブジェクトに追加される最初の RowSet オブジェクトが、JOIN 関係の基盤になります。

このメソッドは、指定された RowSet オブジェクト (複数可) がまだ一致列を持たない場合に使用されます。

パラメータ:

rowset - JOIN に追加される 1 つ以上の RowSet オブジェクトの配列。Joinable インタフェースを実装できる

columnName - rowset の RowSet オブジェクトの一致列として設定する列の名前を示す String 値の配列

例外:

SQLException - (1) この JoinRowSet オブジェクトに空の行セットが追加された場合、(2) rowset 内の RowSet オブジェクトに一致列が設定されていない場合、(3) 追加される RowSet オブジェクトがアクティブな JOIN に違反する場合

getRowSets

Collection<?> getRowSets()
                         throws SQLException

この JoinRowSet オブジェクトに追加された RowSet オブジェクトを含む Collection オブジェクトを返します。JOIN 内の RowSet 数 n を返し、この共用体内で発生したすべての更新を保持します。

戻り値:

この JoinRowSet オブジェクトに追加された RowSet オブジェクトで構成される Collection オブジェクト

例外:

SQLException - 返される Collection オブジェクトの生成時にエラーが発生した場合

getRowSetNames

String[] getRowSetNames()
                        throws SQLException

この JoinRowSet オブジェクトに追加された RowSet オブジェクトの名前を含む String 配列を返します。

戻り値:

この JoinRowSet オブジェクト内の RowSet オブジェクトの名前を含む String 配列

例外:

SQLException - RowSet オブジェクトの名前の取得時にエラーが発生した場合

関連項目:

CachedRowSet.setTableName(java.lang.String)

toCachedRowSet

CachedRowSet toCachedRowSet()
                            throws SQLException

この JoinRowSet オブジェクト内のデータを含む新しい CachedRowSet オブジェクトを作成します。これは、CachedRowSet オブジェクトの SyncProvider オブジェクトを使って、データソースに保存することができます。

JoinRowSet に更新または変更を適用した場合、メソッドによって返される CachedRowSet は、その変更をデータソース内の元の行と表内に持続させることができません。返される CachedRowSet インスタンスには、変更データは含まれません。また、元の SQL 文のすべてのプロパティーが消去されます。アプリケーションは、RowSet.setCommand メソッドを使って、この SQL 文をリセットする必要があります。

変更を元の表のデータソースに持続させるためには、acceptChanges メソッドを JoinRowSet オブジェクトインスタンス上に呼び出します。実装では、実装内の内部データと更新追跡機能を利用して、SyncProvider と対話し、変更を持続させられます。

戻り値:

JoinRowSet のコンテンツを含む CachedRowSet

例外:

SQLException - CachedRowSet オブジェクトのアセンブル時にエラーが発生した場合

関連項目:

RowSet、CachedRowSet、SyncProvider

supportsCrossJoin

boolean supportsCrossJoin()

JoinRowSet 実装が CROSS_JOIN をサポートするかどうかを示します。

戻り値:

CROSS_JOIN がサポートされている場合は true、そうでない場合は false

supportsInnerJoin

boolean supportsInnerJoin()

JoinRowSet 実装が INNER_JOIN をサポートするかどうかを示します。

戻り値:

INNER_JOIN がサポートされている場合は true、そうでない場合は false

supportsLeftOuterJoin

boolean supportsLeftOuterJoin()

JoinRowSet 実装が LEFT_OUTER_JOIN をサポートするかどうかを示します。

戻り値:

LEFT_OUTER_JOIN がサポートされている場合は true、そうでない場合は false

supportsRightOuterJoin

boolean supportsRightOuterJoin()

JoinRowSet 実装が RIGHT_OUTER_JOIN をサポートするかどうかを示します。

戻り値:

RIGHT_OUTER_JOIN がサポートされている場合は true、そうでない場合は false

supportsFullJoin

boolean supportsFullJoin()

JoinRowSet 実装が FULL_JOIN をサポートするかどうかを示します。

戻り値:

FULL_JOIN がサポートされている場合は true、そうでない場合は false

setJoinType

void setJoinType(int joinType)
                 throws SQLException

アプリケーションに、JoinRowSet オブジェクトインスタンス内の表に適用される JOIN の型の調整を許可します。実装は、指定された JOIN 型をサポートしない場合、SQLException をスローします。

パラメータ:

joinType - JoinRowSet インスタンスをただちに再構成する、SQL JOIN の標準 JoinRowSet.XXX static フィールド定義。

例外:

SQLException - サポートされていない JOIN 型が設定された場合

関連項目:

getJoinType()

getWhereClause

String getWhereClause()
                      throws SQLException

JoinRowSet オブジェクトで使用される、SQL によく似た WHERE 節の記述を返します。実装は、JOIN の SQL 文字列記述を提供することにより、SQL JOIN の WHERE 節を記述できます。または、JoinRowSet を使用して、アプリケーションを補助するテキスト記述を提供できます。

戻り値:

whereClause。JoinRowSet インスタンスで使用される論理 WHERE 節のテキスト記述または SQL 記述

例外:

SQLException - WHERE 節の表現の生成時にエラーが発生した場合。

getJoinType

int getJoinType()
                throws SQLException

この JoinRowSet インスタンスを管理する SQL JOIN 型を記述する int を返します。返される型は標準 JoinRowSet 型 (CROSS_JOIN、INNER_JOIN、LEFT_OUTER_JOIN、RIGHT_OUTER_JOIN、または FULL_JOIN) のいずれかになります。

戻り値:

SQL JOIN の標準 JoinRowSet static フィールド定義のいずれかの joinType。明示的に型が設定されていない場合は、デフォルトの JOIN 型として JoinRowSet.INNER_JOIN が返される。

例外:

SQLException - JoinRowSet インスタンスによってサポートされる SQL JOIN 型の判断時にエラーが発生した場合。

関連項目:

setJoinType(int)