|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | 생성자 | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
public interface Joinable
Joinable인터페이스는 일치열의 취득과 설정의 메서드를 제공합니다. 이것은 RowSet 객체를 JoinRowSet 객체에 추가하는 것에 의해 형성되는 SQL JOIN
형성의 기초가 됩니다.
표준 RowSet 구현은, JoinRowSet 객체에 추가하기 위해서
Joinable인터페이스를 구현할 수 있습니다. 이 인터페이스를 구현하면, RowSet 객체로 일치열의 설정, 취득, 정보의 취득을 할 수 있는 Joinable 메서드를 사용할 수 있게 됩니다. 어플리케이션은 Joinable인터페이스를 구현하고 있지 않는 RowSet 객체를 JoinRowSet 객체에 추가할 수 있습니다만, 이 때문에는 RowSet 객체와 일치열의 양쪽 모두, 또는 RowSet 객체의 배열과 일치열의 배열의 양쪽 모두를 취하는 몇개의 JoinRowSet.addRowSet 메서드를 사용할 필요가 있습니다.
Joinable인터페이스의 메서드에 액세스 하려면,
RowSet 객체로 5개의 표준 RowSet인터페이스의 쳐 적어도 1개의 인터페이스를 구현해, 또한
Joinable인터페이스도 구현합니다. 또, 대부분의 RowSet객체는 BaseRowSet 클래스를 확장합니다. 다음에 예를 나타냅니다.
class MyRowSetImpl extends BaseRowSet implements CachedRowSet, Joinable {
:
:
}
Joinable인터페이스내의 메서드로RowSet객체는
일치열 (SQL JOIN
베이스가 되는 열)의 설정, 일치열의 취득, 또는 일치열의 설정 해제를 실시합니다. 이러한 메서드를 구현하는 클래스의 인스턴스를 JoinRowSet 객체에 추가하는 것으로 SQL JOIN 관계를 확립할 수 있습니다.
CachedRowSet crs = new MyRowSetImpl();
crs.populate((ResultSet) rs);
(Joinable) crs.setMatchColumnIndex(1);
JoinRowSet jrs = new JoinRowSetImpl();
jrs.addRowSet(crs);
상기의 예에서는 crs가 Joinable인터페이스를 구현한 CachedRowSet 객체입니다. 다음의 예의 crs2는 Joinable인터페이스를 구현하고 있지 않기 때문에
addRowSet 메서드의 인수로서 일치열을 지정할 필요가 있습니다. 이 예에서는 열 1을 일치열로 하고 있습니다. CachedRowSet crs2 = new MyRowSetImpl(); crs2.populate((ResultSet) rs); JoinRowSet jrs2 = new JoinRowSetImpl(); jrs2.addRowSet(crs2, 1);
JoinRowSet인터페이스의 이용에의해 단일의 표에 정리된 1개
이상의 RowSet 객체로부터 데이터를 취득할 수 있게 됩니다. 이 때, 데이타베이스와의 접속을 작성할 필요는 없습니다. 그 때문에
미접속의 RowSet 객체로 사용하는 것에 적합합니다. 그런데도, 접속하고 있을지 어떨지에 관계없이, 모든 RowSet 객체가 이 인터페이스를구현할 수 있습니다. 항상 데이터 소스에 접속되고 있는 JdbcRowSet객체는
JoinRowSet 객체에 포함하지 않아도, 직접 SQL JOIN에 포함할 수 있습니다
.
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 객체 (Joinable인터페이스를 구현하고 있는 RowSet 객체)에 추가할 수 있습니다.
int[] w = {3, 2, 5, 3};
Joinable2.setMatchColumn(w);
복수의 RowSet 객체를 JoinRowSet 객체에 추가할 때, 배열 인덱스의 순서는 특히 중요합니다. 배열의 각 인덱스는 이전에 추가한 RowSet 객체의 대응하는 인덱스와 직접 대응합니다. 오버랩이나 언더 랩이 발생했을 경우, 일치열의 데이터는 Joinable을
구현한 RowSet가 추가된 이벤트내에 보관 유지되어 일치열데이터에 관련지을 필요가 있습니다. 따라서, 어플리케이션은 복수의 일치열을 임의의 차례로 설정할 수 있습니다만, 이 차례는 SQL JOIN
결과에 직접 영향을 미칩니다.
이것은 일치열을 나타내기 위해서 열인덱스가 아니고 렬명을 사용하는 경우에도 완전히 같습니다.
JoinRowSet | 메서드 개요 | |
|---|---|
int[] |
getMatchColumnIndexes ()
setMatchColumn(int[] columnIdxes) 메서드를 사용해, 이 RowSet 객체로 설정된 일치열의 인덱스를 취득합니다. |
String [] |
getMatchColumnNames ()
setMatchColumn(String [] columnNames) 메서드를 사용해, 이 RowSet 객체로 설정된 일치열의 이름을 취득합니다. |
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 객체의 일치열로서 지정된 열의 설정을 해제합니다. |
| 메서드의 상세 |
|---|
void setMatchColumn(int columnIdx)
throws SQLException
RowSet 객체의 일치열로서 설정합니다. JoinRowSet객체는
일치열에 기반해
이 RowSet 객체를 추가할 수 있습니다.
CachedRowSetTM 등의 서브 인터페이스는 CachedRowSet.setKeyColumns 메서드를 정의합니다. 이 메서드를 사용해, 특정의 열에 주키의 시멘틱스를 적용할 수 있습니다. setMatchColumn(int columnIdx) 메서드의 구현에서는 CachedRowSet 객체로 주키열을 일치열로서 설정할 경우에
키열의 제약을 유지할 필요가 있습니다.
columnIdx - 일치열로서 설정되는 열의 인덱스를 나타내는 int
SQLException - 무효인 열인덱스가 설정되었을 경우setMatchColumn(int[]),
unsetMatchColumn(int)
void setMatchColumn(int[] columnIdxes)
throws SQLException
RowSet 객체의 일치열로서 설정합니다. JoinRowSet객체는
일치열에 기반해
이 RowSet 객체를 추가할 수 있습니다.
columnIdxes - 일치열로서 설정되는 열의 인덱스를 나타내는 int
배열
SQLException - 무효인 열인덱스가 설정되었을 경우setMatchColumn(int[]),
unsetMatchColumn(int[])
void setMatchColumn(String columnName)
throws SQLException
RowSet 객체의 일치열로서 설정합니다. JoinRowSet객체는
일치열에 기반해
이 RowSet 객체를 추가할 수 있습니다.
CachedRowSet인터페이스등의 서브 인터페이스는 CachedRowSet.setKeyColumns 메서드를 정의합니다. 이 메서드를 사용해, 특정의 열에 주키의 시멘틱스를 적용할 수 있습니다. setMatchColumn(String columnIdx) 메서드의 구현에서는 CachedRowSet 객체로 주키열을 일치열로서 설정할 경우에
키열의 제약을 유지할 필요가 있습니다.
columnName - 일치열로서 설정되는 열의 이름을 지정하는 String 객체
SQLException - 무효인 렬명이 설정되었을 경우, 렬명이 null인 경우, 또는 렬명이 공문자열의 경우unsetMatchColumn(int),
setMatchColumn(int[])
void setMatchColumn(String [] columnNames)
throws SQLException
RowSet 객체의 일치열로서 설정합니다. JoinRowSet객체는
일치열에 기반해
이 RowSet 객체를 추가할 수 있습니다.
columnNames - 일치열로서 설정되는 열의 이름을 지정하는 String 객체의 배열
SQLException - 무효인 렬명이 설정되었을 경우, 렬명이 null인 경우, 또는 렬명이 공문자열의 경우unsetMatchColumn(int),
setMatchColumn(int[])
int[] getMatchColumnIndexes()
throws SQLException
setMatchColumn(int[] columnIdxes) 메서드를 사용해, 이 RowSet 객체로 설정된 일치열의 인덱스를 취득합니다.
RowSet 객체의 일치열로서 설정된 열의 인덱스를 나타내는 int 배열
SQLException - 일치열이 설정되어 있지 않은 경우setMatchColumn(int),
unsetMatchColumn(int)
String [] getMatchColumnNames()
throws SQLException
setMatchColumn(String [] columnNames) 메서드를 사용해, 이 RowSet 객체로 설정된 일치열의 이름을 취득합니다.
RowSet 객체에 일치열로서 설정된 열의 이름을 지정하는 String 객체의 배열
SQLException - 일치열이 설정되어 있지 않은 경우setMatchColumn(int),
unsetMatchColumn(int)
void unsetMatchColumn(int columnIdx)
throws SQLException
RowSet 객체의 일치열로서 지정된 열의 설정을 해제합니다.
Joinable인터페이스를 구현하는 RowSet객체는
지정된 렬상에서 CachedRowSet.unsetKeyColumns 메서드가 불려 갈 때까지 키와 같은 제약이 실시되는 것을 보증할 필요가 있습니다.
columnIdx - 일치열로서의 설정이 해제되는 열의 인덱스를 나타내는 int
SQLException - 무효인 열인덱스가 지정되었을 경우, 또는 지정된 열이 이전에 일치열로서 설정되어 있지 않은 경우setMatchColumn(int)
void unsetMatchColumn(int[] columnIdxes)
throws SQLException
RowSet 객체의 일치열로서 지정된 열의 설정을 해제합니다.
columnIdxes - 일치열로서의 설정이 해제되는 열의 인덱스를 나타내는 int
배열
SQLException - 무효인 열인덱스가 지정되었을 경우, 또는 지정된 열이 이전에 일치열로서 설정되어 있지 않은 경우setMatchColumn(int)
void unsetMatchColumn(String columnName)
throws SQLException
RowSet 객체의 일치열로서 지정된 열의 설정을 해제합니다.
Joinable인터페이스를 구현하는 RowSet객체는
지정된 렬상에서 CachedRowSet.unsetKeyColumns 메서드가 불려 갈 때까지 키와 같은 제약이 실시되는 것을 보증할 필요가 있습니다.
columnName - 일치열로서의 설정이 해제되는 열의 이름을 지정하는 String 객체
SQLException - 무효인 렬명이 지정되었을 경우, 또는 지정된 열이 이전에 일치열로서 설정되어 있지 않은 경우setMatchColumn(int)
void unsetMatchColumn(String [] columnName)
throws SQLException
RowSet 객체의 일치열로서 지정된 열의 설정을 해제합니다.
columnName - 일치열로서의 설정이 해제되는 열의 이름을 지정하는 String 객체의 배열
SQLException - 무효인 렬명이 지정되었을 경우, 또는 지정된 열이 이전에 일치열로서 설정되어 있지 않은 경우setMatchColumn(int)
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | 생성자 | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.