JavaTM Platform
Standard Ed. 6

javax.sql.rowset
인터페이스 JoinRowSet

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


public interface JoinRowSet
extends WebRowSet

JoinRowSet 인터페이스는, 다른 RowSet 객체의 관련 데이터를, SQL JOIN 를 나타내는 1 개의 JoinRowSet 객체에 정리하는 기구를 제공합니다. 즉,JoinRowSet 객체는, SQL JOIN 관계를 형성하는 RowSet 객체로부터의 데이터의 컨테이너로서 동작합니다.  

Joinable 인터페이스는, SQL JOIN 관계 확립의 기반이 되는 일치열의 설정, 취득, 및 설정 해제의 메소드를 제공합니다. 또는, 일치열은 JointRowSetaddRowSet 메소드의 적절한 버젼을 지정하는 것에 의해도 설정할 수 있습니다.  

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 형을 설정할 수 있습니다.

형태를 설정하고 있지 않는 경우,JOIN 는 자동적으로 내부 결합이 됩니다. JoinRowSet 인터페이스의 필드의 코멘트에, 표준 SQL JOIN 형인 이러한 JOIN 형이 설명되고 있습니다.  

2.0JoinRowSet 객체에 의한 JOIN 의 작성

JoinRowSet 객체의 작성시에는, 이 객체는 빈 상태(empty) 상태입니다. 최초로 추가된 RowSet 객체가 JOIN 관계의 기반으로 됩니다. 어플리케이션에서는,JoinRowSet 객체에 추가하는 각 RowSet 객체의 어느 열을 일치열로 할까를 결정할 필요가 있습니다. 모든 RowSet 객체에 일치열이 포함되어 각 일치열의 값은, 다른 일치열의 값과 비교 가능한 값일 필요가 있습니다. 열에는 같은 이름을 붙이는 것이 많습니다만, 그 필요는 없고, 비교 가능한 데이터형이면, 전혀 같은 데이터형을 포함할 필요도 없습니다.  

일치열은, 다음의 2 통과해 방법으로 설정할 수 있습니다.

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 인터페이스를 구현하고 있기 (위해)때문에,JoinablesetMatchColumn 메소드를 호출할 수가 있습니다.

     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 객체의 정보의 취득을 실시하는 복수의 메소드를 제공합니다.


필드의 개요
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 로부터 상속된 메소드
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 , 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 객체가 JoinablesetMatchColumn 메소드로 설정된 일치열을 벌써 가지고 있는 경우에게만 사용할 필요가 있습니다.  

주:Joinable 객체는,Joinable 인터페이스를 구현하고 있는 임의의 RowSet 객체입니다.

파라미터:
rowset - 이 JoinRowSet 객체에 추가된다 RowSet 객체. Joinable 인터페이스를 구현해, 일치열세트를 가지고 있을 필요가 있다
예외:
SQLException - (1) 이 JoinRowSet 객체에 빈 상태(empty)의 행 세트가 추가되었을 경우, (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 가 빈 상태(empty)의 행 세트의 경우, (2) (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 가 빈 상태(empty)의 행 세트의 경우, (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 객체에 빈 상태(empty)의 행 세트가 추가되었을 경우, (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 객체에 빈 상태(empty)의 행 세트가 추가되었을 경우, (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)

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.