javax.sql
인터페이스 RowSet

모든 슈퍼 인터페이스:

ResultSet

알려진 서브 인터페이스 목록 :

CachedRowSet, FilteredRowSet, JdbcRowSet, JoinRowSet, SyncResolver, WebRowSet

public interface RowSet
extends ResultSet 

JavaBeans^TM 컴퍼넌트 모델의 JDBC API 로 지원 되게 된 인터페이스입니다. 행 세트는 비주얼인 Bean 개발 환경에서 JavaBeans 로서 사용할 수 있습니다. 또, 설계시에 작성 및 구성을의해 실행시에 실행됩니다.

RowSet인터페이스에서는 JavaBeans 프로퍼티의 조를 제공합니다. 이러한 프로퍼티에의해 RowSet인스턴스가 JDBC 데이터 소스에 접속해, 그 데이터 소스로부터 데이터를 읽어내도록 구성할 수 있습니다. 값을 설정하는 메서드 (setInt, setBytes, setString 등)에서는 입력 파라미터를 행 세트의 커멘드 프로퍼티에 건네주는 방법을 제공합니다. 이 커멘드는 행 세트가 일반적으로 관계 데이타베이스로부터 자신의 데이터를 취득할 경우에 사용하는 SQL 쿼리입니다.

RowSet인터페이스에서는 JavaBeans 이벤트를 지원 하고 있어, 행 세트에 이벤트가 발생했을 때 (값의 변경등)에 어플리케이션외의 컴퍼넌트에 통지할 수 있습니다 .

JDBC API 외의 부분을 사용해 구현하도록 하고 있는 점으로써, RowSet인터페이스는 독특합니다. 바꾸어 말하면, RowSet 구현이란 JDBC 드라이버의 최상부에서 실행되는 소프트웨어의 레이어입니다. RowSet인터페이스의 구현은 JDBC 제품의 일부로서 제공하려고 하는 JDBC 드라이버 벤더를 시작해로서 누구라도 제공할 수 있습니다.

RowSet 객체에서는 데이터 소스와의 접속을 작성해, 객체의 라이프 사이클을 통해서 그 접속을 보관 유지합니다. 이러한 경우, 「접속되었다」행 세트로 불립니다. 또, 행 세트는 데이터 소스와 접속해 데이터를 취득해, 접속을 닫을 수도 있습니다. 그러한 행 세트는 「절단 되었다」행 세트로 불립니다. 절단 된 행 세트에서는 절단중에 데이터로 변경을 더하고 나서, 데이터의 원의 소스로 변경을 보내 되돌릴 수가 있습니다. 그러나, 그 때문에(위해)는 접속을 한번 더 확립할 필요가 있습니다.

절단 된 행 세트에는 관련된 리더 (RowSetReader 객체)와 라이터 (RowSetWriter 객체)가 있습니다. 리더는 데이터 첨부로 행 세트를 생성하기 위해서 다양한 방법으로 구현되고 있어 비관계 데이터 소스로부터 데이터를 취득할 수도 있습니다. 라이터도 또 다양한 방법으로 구현되고 있어 행 세트의 데이터에 더해진 변경을 기본이 되는 데이터 출처에 보내 되돌릴 수가 있습니다.

행 세트를 사용하는 것은 간단합니다. RowSet인터페이스는 표준의 java.sql.ResultSet인터페이스를 확장하고 있습니다. 또 RowSetMetaData인터페이스는 java.sql.ResultSetMetaData인터페이스를 확장하고 있습니다. 그것에의해 JDBC API에 정통하고 있는 개발자가 행 세트를 사용하기 위해서는 최소한의 새로운 API를 기억하면 끝납니다. 게다가 JDBC ResultSet 객체와 함께 동작하는 써드파티제의 소프트웨어 툴을 행 세트를 사용해 동작하도록 하는 일도 간단하게 할 수 있습니다.

도입된 버전 :

1.4

필드 개요

인터페이스 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	addRowSetListener (RowSetListener listener) 지정한 이벤트 리스너를 등록해, 이 RowSet 객체로 발생하는 이벤트가 통지되도록 합니다.
void	clearParameters () 이 RowSet 객체의 커멘드용의 파라미터 세트를 클리어 합니다.
void	execute () 이 RowSet 객체에 데이터를 포함합니다.
String	getCommand () 이 RowSet 객체의 command 프로퍼티를 취득합니다.
String	getDataSourceName () 이 RowSet 객체의 데이터 소스를 특정하는 논리명을 취득합니다.
boolean	getEscapeProcessing () 이 RowSet 객체의 이스케이프의 처리가 유효한가 어떤가를 취득합니다.
int	getMaxFieldSize () 있는 렬치로 리턴된 최대 바이트수를 취득합니다.
int	getMaxRows () 이 RowSet 객체에 포함할 수 있는 최대행수를 취득합니다.
String	getPassword () 데이타베이스 접속의 작성에 사용하는 패스워드를 취득합니다.
int	getQueryTimeout () 드라이버가 문장의 실행을 기다리는 최대초수를 취득합니다.
int	getTransactionIsolation () 이 RowSet 객체의 트랜잭션(transaction) 차단 레벨의 설정을 취득합니다.
Map <String, Class <? >>	getTypeMap () 이 RowSet 객체에 관련된 SQL 사용자 정의형의 커스텀 매핑이 있는 경우에는 그것을 지정하는 Map 객체를 취득합니다.
String	getUrl () 이 RowSet 객체가 접속을 확립하는데 DataSource객체는 아니고 DriverManager를 사용하는 경우에 접속을 작성하기 위해서 사용하는 url 프로퍼티를 취득합니다.
String	getUsername () 이 RowSet 객체의 데이타베이스 접속을 작성하기 위해서 사용되는 username를 취득합니다.
boolean	isReadOnly () 이 RowSet 객체가 읽기 전용인가 어떤가를 확인합니다.
void	removeRowSetListener (RowSetListener listener) 지정한 리스너를, 이 RowSet 객체로 이벤트가 발생했을 때에 통지되는 컴퍼넌트의 리스트로부터 삭제합니다.
void	setArray (int i, Array x) 이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 Array값으로 설정합니다.
void	setAsciiStream (int parameterIndex, InputStream x, int length) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.io.InputStream값으로 설정합니다.
void	setBigDecimal (int parameterIndex, BigDecimal x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.math.BigDeciaml값으로 설정합니다.
void	setBinaryStream (int parameterIndex, InputStream x, int length) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.io.InputStream값으로 설정합니다.
void	setBlob (int i, Blob x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Blob값으로 설정합니다.
void	setBoolean (int parameterIndex, boolean x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java boolean값으로 설정합니다.
void	setByte (int parameterIndex, byte x) 이 RowSet 객체의 커멘드에 대해 지정한 파라미터를, 지정한 Java byte값으로 설정합니다.
void	setBytes (int parameterIndex, byte[] x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, byte값의 지정한 Java 배열치로 설정합니다.
void	setCharacterStream (int parameterIndex, Reader reader, int length) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.io.Reader값으로 설정합니다.
void	setClob (int i, Clob x) 이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 Clob값으로 설정합니다.
void	setCommand (String cmd) 이 RowSet 객체의 command 프로퍼티에 SQL 쿼리를 설정합니다.
void	setConcurrency (int concurrency) 이 RowSet 객체의 병행성을 지정한 병행성 레벨로 설정합니다.
void	setDataSourceName (String name) 이 RowSet 객체의 데이터 소스명 프로퍼티를, 지정한 String로 설정합니다.
void	setDate (int parameterIndex, Date x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Date값으로 설정합니다.
void	setDate (int parameterIndex, Date x, Calendar cal) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Date값으로 설정합니다.
void	setDouble (int parameterIndex, double x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java double값으로 설정합니다.
void	setEscapeProcessing (boolean enable) 이 RowSet 객체의 이스케이프의 처리를 온 또는 오프로 설정합니다.
void	setFloat (int parameterIndex, float x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java float값으로 설정합니다.
void	setInt (int parameterIndex, int x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java int값으로 설정합니다.
void	setLong (int parameterIndex, long x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java long값으로 설정합니다.
void	setMaxFieldSize (int max) 렬치에 리턴된 최대 바이트수를, 지정된 바이트수로 설정합니다.
void	setMaxRows (int max) 이 RowSet 객체에 포함할 수 있는 최대의 행수를, 지정한 값으로 설정합니다.
void	setNull (int parameterIndex, int sqlType) 이 RowSet 객체의, 지정한 SQL 커멘드의 파라미터를, SQL NULL로 설정합니다.
void	setNull (int paramIndex, int sqlType, String typeName) 이 RowSet 객체의, 지정한 SQL 커멘드의 파라미터를, SQL NULL로 설정합니다.
void	setObject (int parameterIndex, Object x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java Object로 설정합니다.
void	setObject (int parameterIndex, Object x, int targetSqlType) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java Object로 설정합니다.
void	setObject (int parameterIndex, Object x, int targetSqlType, int scale) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java Object로 설정합니다.
void	setPassword (String password) 이 RowSet 객체의 데이타베이스 패스워드를, 지정한 String로 설정합니다.
void	setQueryTimeout (int seconds) 드라이버가 문장의 실행을 기다리는 최대 시간을 지정한 초수로 설정합니다.
void	setReadOnly (boolean value) 이 RowSet 객체가 읽기 전용인가 어떤가를, 지정한 boolean로 설정합니다.
void	setRef (int i, Ref x) 이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 Java Ref값으로 설정합니다.
void	setShort (int parameterIndex, short x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java short값으로 설정합니다.
void	setString (int parameterIndex, String x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java String값으로 설정합니다.
void	setTime (int parameterIndex, Time x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Time값으로 설정합니다.
void	setTime (int parameterIndex, Time x, Calendar cal) 이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 java.sql.Time값으로 설정합니다.
void	setTimestamp (int parameterIndex, Timestamp x) 이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Timestamp값으로 설정합니다.
void	setTimestamp (int parameterIndex, Timestamp x, Calendar cal) 이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 java.sql.Timestamp값으로 설정합니다.
void	setTransactionIsolation (int level) 이 RowSet 객체의 트랜잭션(transaction) 차단 레벨을 설정합니다.
void	setType (int type) 이 RowSet 객체의 형태를, 지정한 형태로 설정합니다.
void	setTypeMap (Map <String, Class <? >> map) 지정한 java.util.Map 객체를, 이 RowSet 객체의 디폴트형 맵으로서 인스톨 합니다.
void	setUrl (String url) 이 RowSet 객체가 DriverManager를 사용해 접속을 작성할 경우에 사용하는 URL를 설정합니다.
void	setUsername (String name) 이 RowSet 객체의 username 프로퍼티를, 지정한 String로 설정합니다.

인터페이스 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

메서드의 상세

getUrl

String  getUrl()
              throws SQLException 

이 RowSet 객체가 접속을 확립하는데 DataSource객체는 아니고 DriverManager를 사용하는 경우에 접속을 작성하기 위해서 사용하는 url 프로퍼티를 취득합니다. 기본값는 null 입니다.

반환값:

URL를 나타내는 캐릭터 라인

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setUrl(java.lang.String)

setUrl

void setUrl(String  url)
            throws SQLException 

이 RowSet 객체가 DriverManager를 사용해 접속을 작성할 경우에 사용하는 URL를 설정합니다.이 프로퍼티의 설정은 생략 가능합니다. URL를 사용하는 경우는 데이타베이스에의 접속에 행 세트가 사용되기 전에 그 URL를 받아들이는 JDBC 드라이버가 어플리케이션에 의해 로드되어 있지 않으면 안됩니다. 행 세트에서는 데이터를 읽고 쓰기할 경우에 이 URL를 내부적으로 사용해, 데이타베이스 접속을 작성합니다. URL와 데이터 소스명 가운데, 새롭게 지정된 (분)편이 접속의 작성에 사용됩니다.

파라미터:

url - 캐릭터 라인치. null도 가능

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getUrl()

getDataSourceName

String  getDataSourceName()

이 RowSet 객체의 데이터 소스를 특정하는 논리명을 취득합니다. url 프로퍼티와 데이터 소스명 프로퍼티의 어느 쪽인지를 설정하지 않으면 안됩니다. 행 세트에서는 접속을 취득하기 위해서 마지막에 사용한 프로퍼티를 사용합니다.

반환값:

데이터 소스명

관련 항목:

setDataSourceName(java.lang.String), setUrl(java.lang.String)

setDataSourceName

void setDataSourceName(String  name)
                       throws SQLException 

이 RowSet 객체의 데이터 소스명 프로퍼티를, 지정한 String로 설정합니다.

데이터 소스명 프로퍼티의 값은 네임 서비스로 등록된 DataSource 객체를 룩 올라가기 위해서 사용됩니다. 취득된 DataSource 객체를 사용해, 이 객체가 나타내는 데이터 소스에의 접속을 작성할 수 있습니다.

파라미터:

name - 이 RowSet 객체에 대한 데이터 소스의 논리명

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getDataSourceName()

getUsername

String  getUsername()

이 RowSet 객체의 데이타베이스 접속을 작성하기 위해서 사용되는 username를 취득합니다. username 프로퍼티는 실행시에 execute 메서드를 호출하기 전으로 설정됩니다. 보통, 이것은 RowSet 객체의 직렬화 상태의 일부에서는 없습니다.

반환값:

username 프로퍼티

관련 항목:

setUsername(java.lang.String)

setUsername

void setUsername(String  name)
                 throws SQLException 

이 RowSet 객체의 username 프로퍼티를, 지정한 String로 설정합니다.

파라미터:

name - 사용자 명

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getUsername()

getPassword

String  getPassword()

데이타베이스 접속의 작성에 사용하는 패스워드를 취득합니다. password 프로퍼티는 실행시에 execute 메서드를 호출하기 전으로 설정됩니다. 보통, 이것은 RowSet 객체의 직렬화 상태의 일부에서는 없습니다.

반환값:

데이타베이스 접속의 작성에 필요한 패스워드

관련 항목:

setPassword(java.lang.String)

setPassword

void setPassword(String  password)
                 throws SQLException 

이 RowSet 객체의 데이타베이스 패스워드를, 지정한 String로 설정합니다.

파라미터:

password - 패스워드를 나타내는 캐릭터 라인

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getPassword()

getTransactionIsolation

int getTransactionIsolation()

이 RowSet 객체의 트랜잭션(transaction) 차단 레벨의 설정을 취득합니다.

반환값:

트랜잭션(transaction) 차단 레벨. Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, Connection.TRANSACTION_SERIALIZABLE 어떤 것이나

관련 항목:

setTransactionIsolation(int)

setTransactionIsolation

void setTransactionIsolation(int level)
                             throws SQLException 

이 RowSet 객체의 트랜잭션(transaction) 차단 레벨을 설정합니다.

파라미터:

level - 트랜잭션(transaction) 차단 레벨. Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, Connection.TRANSACTION_SERIALIZABLE 어떤 것인가

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getTransactionIsolation()

getTypeMap

Map <String,
Class <? >> getTypeMap()
                                throws SQLException 

이 RowSet 객체에 관련된 SQL 사용자 정의형의 커스텀 매핑이 있는 경우에는 그것을 지정하는 Map 객체를 취득합니다. 형태 맵의 디폴트는 비어있습니다.

반환값:

SQL 사용자 정의형과 그것들이 매핑 되는 Java 클래스가 포함되고 있는 java.util.Map 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setTypeMap(java.util.Map>)

setTypeMap

void setTypeMap(Map <String,
Class <? >> map)
                throws SQLException 

지정한 java.util.Map 객체를, 이 RowSet 객체의 디폴트형 맵으로서 인스톨 합니다. 다른 형태 맵이 메서드의 파라미터로서 지정될 때까지, 이 형태 맵이 사용됩니다.

파라미터:

map - SQL 사용자 정의형과 그것들이 매핑 되는 Java 클래스가 포함되고 있는 java.util.Map 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getTypeMap()

getCommand

String  getCommand()

이 RowSet 객체의 command 프로퍼티를 취득합니다. command 프로퍼티에는 SQL 쿼리인 커멘드 캐릭터 라인이 포함됩니다. 이것은 행 세트에 데이터를 포함하기 위해서 실행됩니다. 기본값는 null 입니다.

반환값:

커멘드 캐릭터 라인. null도 가능

관련 항목:

setCommand(java.lang.String)

setCommand

void setCommand(String  cmd)
                throws SQLException 

이 RowSet 객체의 command 프로퍼티에 SQL 쿼리를 설정합니다. 행 세트가 커멘드를 지원 하지 않는 데이터 소스로부터 데이터를 얻는 경우 (스프레드쉬트 등), 이 프로퍼티는 생략 가능합니다.

파라미터:

cmd - 이 RowSet 객체의 데이터를 얻기 위해서 사용되는 SQL 쿼리. null도 가능

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getCommand()

isReadOnly

boolean isReadOnly()

이 RowSet 객체가 읽기 전용인가 어떤가를 확인합니다. 갱신이 가능한 경우, 행 세트의 디폴트는 갱신 가능하게 됩니다.

read 전용의 행 세트를 갱신하려고 하면, SQLException가 발생 됩니다.

반환값:

이 RowSet 객체가 읽기 전용의 경우는 true, 갱신 가능한 경우는 false

관련 항목:

setReadOnly(boolean)

setReadOnly

void setReadOnly(boolean value)
                 throws SQLException 

이 RowSet 객체가 읽기 전용인가 어떤가를, 지정한 boolean로 설정합니다.

파라미터:

value - read 전용의 경우는 true, 갱신 가능한 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

isReadOnly()

getMaxFieldSize

int getMaxFieldSize()
                    throws SQLException 

어느 렬치로 리턴된 최대 바이트수를 취득합니다. 이 제한치는 BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR 및 LONGVARCHAR 각 열에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다.

반환값:

현재의 최대열사이즈 제한치. 0 은 제한이 없는 것을 나타낸다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max)
                     throws SQLException 

렬치에 리턴된 최대 바이트수를, 지정된 바이트수로 설정합니다. 이 제한치는 BINARY, VARBINARY, LONGVARBINARYBINARY, CHAR, VARCHAR, LONGVARCHAR 각 열인 만큼 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다. 이식성을 최대한으로 하려면, 256 보다 큰 값을 사용합니다.

파라미터:

max - 새로운 최대열사이즈의 제한치 (바이트). 제로는 무제한을 미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getMaxFieldSize()

getMaxRows

int getMaxRows()
               throws SQLException 

이 RowSet 객체에 포함할 수 있는 최대행수를 취득합니다. 제한치를 넘은 행은 통지없이 제외됩니다.

반환값:

이 RowSet 객체에 포함할 수 있는 현재의 최대행수. 제로는 무제한을 미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setMaxRows(int)

setMaxRows

void setMaxRows(int max)
                throws SQLException 

이 RowSet 객체에 포함할 수 있는 최대의 행수를, 지정한 값으로 설정합니다. 제한치를 넘은 행은 통지없이 제외됩니다.

파라미터:

max - 새로운 최대행수. 제로는 무제한을 미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getMaxRows()

getEscapeProcessing

boolean getEscapeProcessing()
                            throws SQLException 

이 RowSet 객체의 이스케이프의 처리가 유효한가 어떤가를 취득합니다. 에스케이프스캐닝이 온의 경우 (디폴트), 드라이버는 SQL 문을 데이타베이스에 보내기 전에 이스케이프 치환을 실행합니다.

반환값:

이스케이프 처리가 유효한 경우는 true, 무효인 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setEscapeProcessing(boolean)

setEscapeProcessing

void setEscapeProcessing(boolean enable)
                         throws SQLException 

이 RowSet 객체의 이스케이프의 처리를 온 또는 오프로 설정합니다. 에스케이프스캐닝이 온의 경우 (디폴트), 드라이버는 SQL 문을 데이타베이스에 보내기 전에 이스케이프 치환을 실행합니다.

파라미터:

enable - 이스케이프 처리를 유효하게 하는 경우는 true, 무효로 하는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getEscapeProcessing()

getQueryTimeout

int getQueryTimeout()
                    throws SQLException 

드라이버가 문장의 실행을 기다리는 최대초수를 취득합니다. 이 제한 시간을 경과하면, SQLException가 발생 됩니다.

반환값:

현재의 쿼리타임 아웃의 제한치 (초수). 제로는 무제한을 미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds)
                     throws SQLException 

드라이버가 문장의 실행을 기다리는 최대 시간을 지정한 초수로 설정합니다. 이 제한 시간을 경과하면, SQLException가 발생 됩니다.

파라미터:

seconds - 새로운 쿼리타임 아웃의 제한치의 초수. 제로는 무제한을 미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getQueryTimeout()

setType

void setType(int type)
             throws SQLException 

이 RowSet 객체의 형태를, 지정한 형태로 설정합니다. 이 메서드는 디폴트로 읽기 전용으로 스크롤 불가의 행 세트의 형태를 변경하기 위해서 이용됩니다.

파라미터:

type - 형을 지정하는 ResultSet 정수인ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

ResultSet.getType()

setConcurrency

void setConcurrency(int concurrency)
                    throws SQLException 

이 RowSet 객체의 병행성을 지정한 병행성 레벨로 설정합니다. 이 메서드는 디폴트로 ResultSet.CONCUR_READ_ONLY인 행 세트의 병행성 레벨을 변경하기 위해서 이용됩니다.

파라미터:

concurrency - 병행성 레벨을 지정하는 ResultSet 정수. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE 어느 쪽인지

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

ResultSet.getConcurrency()

setNull

void setNull(int parameterIndex,
             int sqlType)
             throws SQLException 

이 RowSet 객체의, 지정한 SQL 커멘드의 파라미터를, SQL NULL로 설정합니다.

주: 파라미터의 SQL 형태를 지정할 필요가 있습니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

sqlType - java.sql.Types에 의해 정의되는 SQL 형태의 코드

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setNull

void setNull(int paramIndex,
             int sqlType,
             String  typeName)
             throws SQLException 

이 RowSet 객체의, 지정한 SQL 커멘드의 파라미터를, SQL NULL로 설정합니다. SQL 사용자 정의형 (UDT) 및 REF 형의 파라미터에서는 이 버전의 setNull 메서드를 사용할 필요가 있습니다. UDT 예에는 STRUCT, DISTINCT, JAVA_OBJECT 및 이름 첨부 배열이 있습니다.

주: 이식성을 실현하기 위해서는 어플리케이션은 NULL 사용자 정의 파라미터 또는 REF 파라미터를 지정할 경우에 SQL 형 코드 및 완전 지정의 SQL 형명을 지정하지 않으면 안됩니다. 사용자 정의형의 경우, 이름은 파라미터 자체의 형명입니다. REF 파라미터의 경우, 이름은 참조되는 형태의 형명입니다. JDBC 드라이버가 형태 코드 또는 형명의 정보를 필요로 하지 않는 경우, 그것은 무시됩니다. UDT 및 REF 파라미터를 대상으로 하고 있습니다만, 이 메서드는 임의의 JDBC 형의 null 파라미터를 설정하기 위해서 사용할 수 있습니다. 파라미터가 사용자 정의의 형태 또는 REF 형을 가지지 않는 경우, typeName 파라미터는 무시됩니다.

파라미터:

paramIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

sqlType - java.sql.Types로 부터의 값

typeName - SQL UDT 완전 수식명, 또는 REF 형으로 참조되는 SQL 구조형의 형명. 파라미터가 UDT 또는 REF 형이 아닌 경우는 무시된다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBoolean

void setBoolean(int parameterIndex,
                boolean x)
                throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java boolean값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL BIT 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setByte

void setByte(int parameterIndex,
             byte x)
             throws SQLException 

이 RowSet 객체의 커멘드에 대해 지정한 파라미터를, 지정한 Java byte값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL TINYINT 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setShort

void setShort(int parameterIndex,
              short x)
              throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java short값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL SMALLINT 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setInt

void setInt(int parameterIndex,
            int x)
            throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java int값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL INTEGER 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setLong

void setLong(int parameterIndex,
             long x)
             throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java long값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL BIGINT 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setFloat

void setFloat(int parameterIndex,
              float x)
              throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java float값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL REAL 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setDouble

void setDouble(int parameterIndex,
               double x)
               throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java double값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL DOUBLE 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBigDecimal

void setBigDecimal(int parameterIndex,
                   BigDecimal  x)
                   throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.math.BigDeciaml값으로 설정합니다. 이 파라미터는 데이타베이스에 송신되기 전에 드라이버에 의해 SQL NUMERIC 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setString

void setString(int parameterIndex,
               String  x)
               throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java String값으로 설정합니다. 이것은 데이타베이스에의 송신전에 드라이버에 의해 SQL VARCHAR 또는 LONGVARCHAR 치에 변환됩니다 (드라이버의 VARCHAR값의 제한에 관한 인수의 사이즈에 존).

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBytes

void setBytes(int parameterIndex,
              byte[] x)
              throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, byte값의 지정한 Java 배열치로 설정합니다. 이것은 데이타베이스에의 송신전에 드라이버에 의해 SQL VARBINARY 또는 LONGVARBINARY 치에 변환됩니다 (드라이버의 VARBINARY 치에 관한 제한에 관한 인수의 사이즈에 존).

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setDate

void setDate(int parameterIndex,
             Date  x)
             throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Date값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 디폴트의 java.util.Calendar를 사용해 날짜와 시간가 계산되어 드라이버에 의해 SQL DATE 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setTime

void setTime(int parameterIndex,
             Time  x)
             throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Time값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 디폴트의 java.util.Calendar를 사용해 계산되어 드라이버에 의해 SQL TIME 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp  x)
                  throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Timestamp값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 디폴트의 java.util.Calendar를 사용해 계산되어 드라이버에 의해 SQL TIMESTAMP 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setAsciiStream

void setAsciiStream(int parameterIndex,
                    InputStream  x,
                    int length)
                    throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.io.InputStream값으로 설정합니다. java.io.InputStream를 개입시켜 매우 큰 ASCII 치를 송신하는 편이, LONGVARCHAR 파라미터를 사용하는 것보다 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서, 드라이버에 의해 데이터가 스트림로부터 읽어내집니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - ASCII 파라미터값를 포함한 Java 입력 스트림

length - 스트림의 바이트수

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBinaryStream

void setBinaryStream(int parameterIndex,
                     InputStream  x,
                     int length)
                     throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.io.InputStream값으로 설정합니다. java.io.InputStream를 개입시켜 매우 큰 바이너리치를 송신하는 (분)편이, LONGVARBINARY 파라미터를 사용하는 것보다 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서, 드라이버에 의해 데이터가 스트림로부터 읽어내집니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 바이너리 파라미터값를 포함한 Java 입력 스트림

length - 스트림의 바이트수

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setCharacterStream

void setCharacterStream(int parameterIndex,
                        Reader  reader,
                        int length)
                        throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.io.Reader값으로 설정합니다. java.io.Reader를 개입시켜 매우 큰 UNICODE 치를 송신하는 (분)편이, LONGVARCHAR 파라미터를 사용하는 것보다 현실적입니다. 파일의 마지막에 이를 때까지 필요에 따라서, 드라이버에 의해 데이터가 스트림로부터 읽어내집니다.

주: 이 스트림 객체는 표준의 Java 스트림 객체, 또는 표준 인터페이스를 구현하는 독자적인 서브 클래스의 어디라도 괜찮습니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

reader - 설정하는 UNICODE 데이터를 포함한 Reader 객체

length - 스트림내의 문자수

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setObject

void setObject(int parameterIndex,
               Object  x,
               int targetSqlType,
               int scale)
               throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java Object로 설정합니다. 정수값 의 경우는 등가인 java.lang 객체를 사용할 필요가 있습니다 (예를 들어 int에 대해서 Integer 클래스의 인스턴스).

지정된 Java 객체는 데이타베이스에 보내지기 전에 targetSqlType에 변환됩니다.

객체의 클래스가 SQLData를 구현하는 경우는 행 세트로 SQLData.writeSQL 메서드를 호출해, 객체를 SQLOutput 데이터 스트림에 출력할 필요가 있습니다. 객체가 Ref, Struct, Array, Blob, Clob 각 인터페이스의 어떤 것인지를 구현하는 클래스의 인스턴스인 경우, 드라이버는 대응하는 SQL 형에의 디폴트 매핑을 사용합니다.

이 메서드는 데이타베이스 고유의 추상 데이터형을 건네주기 위해서 사용할 수 있는 것에 주의해 주세요.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 입력 파라미터값를 포함한 객체

targetSqlType - 데이타베이스에 보내지는 (java.sql.Types로 정의된다) SQL 형. 스케일 인수로 또한 형태를 한정할 수 있는

scale - java.sql.Types.DECIMAL 이나 java.sql.Types.NUMERIC 형에서는 소수점 아래의 자리수. 다른 모든 형태에서는 이 값은 무시된다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

Types

setObject

void setObject(int parameterIndex,
               Object  x,
               int targetSqlType)
               throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java Object로 설정합니다. 정수값 의 경우는 등가인 java.lang 객체를 사용할 필요가 있습니다. 이 메서드는 전술의 setObject를 닮아 있습니다만, 사용되는 스케일은 2번째의 파라미터의 스케일이 됩니다. 스컬러치의 스케일은 0 입니다. 리터럴값이 보관 유지하는 스케일은 리터럴내에 존재합니다.

부동 소수점의 입력치로 이 메서드를 호출하는 것은 지원 되고 있습니다만 추천은 되지 않습니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 입력 파라미터값를 포함한 객체

targetSqlType - 데이타베이스에 보내지는 (java.sql.Types로 정의된다) SQL 형

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setObject

void setObject(int parameterIndex,
               Object  x)
               throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Java Object로 설정합니다. 정수값 의 경우는 등가인 java.lang 객체를 사용할 필요가 있습니다.

JDBC는 Java Object 형으로부터 SQL 형에의 표준 매핑을 제공합니다. 지정된 Java 객체는 데이타베이스에 보내지기 전에 드라이버에 의해 표준의 SQL 매핑에 변환됩니다.

이 메서드는 드라이버 고유의 Java 형을 사용해, 데이타베이스 고유의 추상 데이터형을 건네주기 위해서 사용하는 것에 주의해 주세요. 객체의 클래스가 SQLData를 구현하는 경우는 행 세트로 SQLData.writeSQL 메서드를 호출해, 객체를 SQLOutput 데이터 스트림에 출력할 필요가 있습니다. 객체가 Ref, Struct, Array, Blob, Clob 각 인터페이스의 어떤 것인지를 구현하는 클래스의 인스턴스인 경우, 드라이버는 대응하는 SQL 형에의 디폴트 매핑을 사용합니다.

예를 들어 객체가 이러한 인터페이스를 복수 구현하는 클래스인 등, 애매함이 있는 경우, 예외가 발생 됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 입력 파라미터값를 포함한 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setRef

void setRef(int i,
            Ref  x)
            throws SQLException 

이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 Java Ref값으로 설정합니다. 이 파라미터는 드라이버에 의해 적절한 Ref(<구조화형 >) 치에 변환됩니다.

파라미터:

i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - SQL REF 형의 데이터를 나타내는 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setBlob

void setBlob(int i,
             Blob  x)
             throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 Blob값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 드라이버에 의해 Blob 객체가 나타내는 BLOB 치에 변환됩니다.

파라미터:

i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - BLOB를 나타내는 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setClob

void setClob(int i,
             Clob  x)
             throws SQLException 

이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 Clob값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 드라이버에 의해 Clob 객체가 나타내는 CLOB 치에 변환됩니다.

파라미터:

i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - CLOB를 나타내는 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setArray

void setArray(int i,
              Array  x)
              throws SQLException 

이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 Array값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 드라이버에 의해 Array 객체가 나타내는 ARRAY 치에 변환됩니다.

파라미터:

i - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - SQL 배열을 나타내는 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setDate

void setDate(int parameterIndex,
             Date  x,
             Calendar  cal)
             throws SQLException 

이 RowSet 객체의 커멘드내의 지정한 파라미터를, 지정한 java.sql.Date값으로 설정합니다. 이 파라미터는 지정한 java.util.Calendar 객체를 사용해 날짜와 시간가 계산되어 드라이버에 의해 SQL DATE 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

cal - 날짜와 시간의 계산에 사용하는 java.util.Calendar 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setTime

void setTime(int parameterIndex,
             Time  x,
             Calendar  cal)
             throws SQLException 

이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 java.sql.Time값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 지정한 java.util.Calendar 객체를 사용해 날짜와 시간가 계산되어 드라이버에 의해 SQL TIME 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

cal - 시각의 계산에 사용하는 java.util.Calendar 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

setTimestamp

void setTimestamp(int parameterIndex,
                  Timestamp  x,
                  Calendar  cal)
                  throws SQLException 

이 RowSet 객체의 커멘드로 지정한 파라미터를, 지정한 java.sql.Timestamp값으로 설정합니다. 이 파라미터는 데이타베이스에의 송신전에 지정한 java.util.Calendar 객체를 사용해 날짜와 시간가 계산되어 드라이버에 의해 SQL TIMESTAMP 치에 변환됩니다.

파라미터:

parameterIndex - 최초의 파라미터는 1, 2번째의 파라미터는 2,... 되는

x - 파라미터값

cal - 타임 스탬프의 계산에 사용하는 java.util.Calendar 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

clearParameters

void clearParameters()
                     throws SQLException 

이 RowSet 객체의 커멘드용의 파라미터 세트를 클리어 합니다.

보통, RowSet 객체를 반복해 사용하기 위해서 파라미터값는 강제적으로 남겨집니다. 파라미터값를 설정하면, 전의 값은 자동적으로 클리어 됩니다. 그러나, 현재의 파라미터값에 의해 사용된 자원을 즉시 해방한 (분)편이 도움이 되는 경우가 있습니다. 이것은 메서드 clearParameters를 호출해 실행할 수 있습니다 .

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

execute

void execute()
             throws SQLException 

이 RowSet 객체에 데이터를 포함합니다.

execute 메서드는 데이터를 읽어내기 위한 접속을 작성할 때, url, 데이터 소스명, 사용자 명, 패스워드, 트랜잭션(transaction) 차단, 형태 맵의 각 프로퍼티를 사용할 수 있습니다. 또, execute 메서드는 커멘드의 실행문을 작성할 때, 커멘드, 읽기 전용, 최대 필드 사이즈, 최대행수, 이스케이프 처리, 쿠에리 타임 아웃의 각 프로퍼티를 사용할 수 있습니다.

요구한 프로퍼티가 설정되어 있지 않은 경우는 예외가 발생 됩니다. 이 메서드의 실행이 성공하면, 행 세트의 현재의 내용은 파기되어 행 세트의 메타데이타도 (재) 설정됩니다. 미처리의 갱신이 있는 경우, 이것들은 무시됩니다.

이 RowSet 객체가 데이터의 소스와의 연속한 접속을 보관 유지할 수 없는 경우는 리더 (RowSetReader 객체)가 데이터를 넣기 위해서 사용됩니다. 이 경우 리더는 이 RowSet 객체로 등록되어 있어execute 메서드에서는 구현의 일부로서 리더의 readData 메서드를 호출합니다.

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 혹은 접속을 작성해, 문장을 작성하기 위해서 필요한 프로퍼티의 어떤 것인가가 설정되어 있지 않은 경우

addRowSetListener

void addRowSetListener(RowSetListener  listener)

지정한 이벤트 리스너를 등록해, 이 RowSet 객체로 발생하는 이벤트가 통지되도록 합니다.

파라미터:

listener - RowSetListener인터페이스를 구현해, 한편, 이 RowSet 객체로 이벤트가 발생했을 때에 통지를 받는 컴퍼넌트

관련 항목:

removeRowSetListener(javax.sql.RowSetListener)

removeRowSetListener

void removeRowSetListener(RowSetListener  listener)

지정한 리스너를, 이 RowSet 객체로 이벤트가 발생했을 때에 통지되는 컴퍼넌트의 리스트로부터 삭제합니다.

파라미터:

listener - 이 RowSet 객체의 리스너로서 등록되어 있는 컴퍼넌트

관련 항목:

addRowSetListener(javax.sql.RowSetListener)