JoinRowSet (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor　　 | 메서드

상세: 필드 | constructor　　 | 메서드

javax.sql.rowset
인터페이스 JoinRowSet

모든 슈퍼 인터페이스:: CachedRowSet, Joinable, ResultSet, RowSet, WebRowSet

public interface JoinRowSet
extends WebRowSet
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인터페이스는 이 요구에 대응하기 위해서 설계되고 있습니다.

Joinable 객체에 RowSet 객체를 추가해, SQL JOIN 관계를 구성할 수 있습니다. 즉, RowSet객체는 접속되고 있는 경우에서도 미접속의 경우에서도, JOIN를 구성할 수 있습니다 . 접속 환경에서 동작하는 RowSet 객체 (JdbcRowSet 객체)는 이미 접속하고 있는 데이타베이스를 사용해, 표간에 직접 SQL JOIN 관계를 확립하는 것을 추천합니다. 그러나, 필요에 따라서, JoinRowSet 객체에 JdbcRowSet 객체를 추가할 수도 있습니다.

단일의 SQL JOIN에 관련된 JoinRowSet 인스턴스이면, 임의의 수의 RowSet 객체를 JoinRowSet 인스턴스에 추가할 수 있습니다. 정의에의하면 SQL JOIN 문은 복수의 RDB 테이블에 포함된 데이터를, 공통의 속성에 근거해 정리하기 위해서 사용됩니다. Joinable인터페이스는 「일치열」의 설정에 의해 공통 속성을 작성하는 메서드를 제공합니다. 일치열은 일반적으로 주키와 일치합니다만, 반드시 일치열이 주키와 동일한 필요는 없습니다. 열의 일치를 확립해, 적용하는 것으로JoinRowSet객체는 사용 가능한 RDB를 사용하지 않고, 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 자체가 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` 객체를 작성합니다.

인터페이스 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. 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, setBigDecimal, setBinaryStream, setBlob, setBoolean, setByte, setBytes, setCharacterStream, setClob, setCommand, setConcurrency, setDataSourceName, setDate, setDate, setDouble, setEscapeProcessing, setFloat, setInt, setLong, setMaxFieldSize, setMaxRows, setNull, setNull, setObject, setObject, setObject, setPassword, setQueryTimeout, setReadOnly, setRef, setShort, setString, setTime, setTime, setTimestamp, setTimestamp, setTransactionIsolation, setType, setTypeMap, setUrl, setUsername

인터페이스 javax.sql. RowSet 로부터 상속된 메서드

addRowSetListener,
 clearParameters,
 execute,
 getCommand,
 getDataSourceName,
 getEscapeProcessing,
 getMaxFieldSize,
 getMaxRows,
 getPassword,
 getQueryTimeout,
 getTransactionIsolation,
 getTypeMap,
 getUrl,
 getUsername,
 isReadOnly,
 removeRowSetListener,
 setArray,
 setAsciiStream,
 setBigDecimal,
 setBinaryStream,
 setBlob,
 setBoolean,
 setByte,
 setBytes,
 setCharacterStream,
 setClob,
 setCommand,
 setConcurrency,
 setDataSourceName,
 setDate,
 setDate,
 setDouble,
 setEscapeProcessing,
 setFloat,
 setInt,
 setLong,
 setMaxFieldSize,
 setMaxRows,
 setNull,
 setNull,
 setObject,
 setObject,
 setObject,
 setPassword,
 setQueryTimeout,
 setReadOnly,
 setRef,
 setShort,
 setString,
 setTime,
 setTime,
 setTimestamp,
 setTimestamp,
 setTransactionIsolation,
 setType,
 setTypeMap,
 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, getInt, getInt, getLong, getLong, getMetaData, getObject, getObject, getObject, getObject, getRef, getRef, getRow, getShort, getShort, getStatement, getString, getString, getTime, getTime, getTime, getTime, getTimestamp, getTimestamp, getTimestamp, getTimestamp, getType, getUnicodeStream, getUnicodeStream, getURL, getURL, getWarnings, insertRow, isAfterLast, isBeforeFirst, isFirst, isLast, last, moveToCurrentRow, moveToInsertRow, next, previous, refreshRow, relative, rowDeleted, rowInserted, rowUpdated, setFetchDirection, setFetchSize, updateArray, updateArray, updateAsciiStream, updateAsciiStream, updateBigDecimal, updateBigDecimal, updateBinaryStream, updateBinaryStream, updateBlob, updateBlob, updateBoolean, updateBoolean, updateByte, updateByte, updateBytes, updateBytes, updateCharacterStream, updateCharacterStream, updateClob, updateClob, updateDate, updateDate, updateDouble, updateDouble, updateFloat, updateFloat, updateInt, updateInt, updateLong, updateLong, updateNull, updateNull, updateObject, updateObject, updateObject, updateObject, updateRef, updateRef, updateRow, updateShort, updateShort, updateString, updateString, updateTime, updateTime, updateTimestamp, updateTimestamp, wasNull

인터페이스 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,
 getInt,
 getInt,
 getLong,
 getLong,
 getMetaData,
 getObject,
 getObject,
 getObject,
 getObject,
 getRef,
 getRef,
 getRow,
 getShort,
 getShort,
 getStatement,
 getString,
 getString,
 getTime,
 getTime,
 getTime,
 getTime,
 getTimestamp,
 getTimestamp,
 getTimestamp,
 getTimestamp,
 getType,
 getUnicodeStream,
 getUnicodeStream,
 getURL,
 getURL,
 getWarnings,
 insertRow,
 isAfterLast,
 isBeforeFirst,
 isFirst,
 isLast,
 last,
 moveToCurrentRow,
 moveToInsertRow,
 next,
 previous,
 refreshRow,
 relative,
 rowDeleted,
 rowInserted,
 rowUpdated,
 setFetchDirection,
 setFetchSize,
 updateArray,
 updateArray,
 updateAsciiStream,
 updateAsciiStream,
 updateBigDecimal,
 updateBigDecimal,
 updateBinaryStream,
 updateBinaryStream,
 updateBlob,
 updateBlob,
 updateBoolean,
 updateBoolean,
 updateByte,
 updateByte,
 updateBytes,
 updateBytes,
 updateCharacterStream,
 updateCharacterStream,
 updateClob,
 updateClob,
 updateDate,
 updateDate,
 updateDouble,
 updateDouble,
 updateFloat,
 updateFloat,
 updateInt,
 updateInt,
 updateLong,
 updateLong,
 updateNull,
 updateNull,
 updateObject,
 updateObject,
 updateObject,
 updateObject,
 updateRef,
 updateRef,
 updateRow,
 updateShort,
 updateShort,
 updateString,
 updateString,
 updateTime,
 updateTime,
 updateTimestamp,
 updateTimestamp,
 wasNull

인터페이스 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 객체의 어셈블(assemble)시에 에러가 발생했을 경우
관련 항목:: 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을 Throw 합니다.

파라미터:: 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)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor　　 | 메서드

상세: 필드 | constructor　　 | 메서드

javax.sql.rowset 인터페이스 JoinRowSet

1.0 개요

2.0 JoinRowSet 객체에 한 JOIN 작성

3.0 사용예

4.0 JoinRowSet 메서드

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

javax.sql.rowset
인터페이스 JoinRowSet

2.0 `JoinRowSet` 객체에 한 `JOIN` 작성

4.0 `JoinRowSet` 메서드