java.sql
인터페이스 Statement

모든 슈퍼 인터페이스:

Wrapper

기존의 서브 인터페이스의 일람:

CallableStatement , PreparedStatement

public interface Statement
extends Wrapper 

정적 SQL 문을 실행해, 작성된 결과를 돌려주기 위해서(때문에) 사용되는 객체입니다.

디폴트에서는,Statement 객체 마다 1 개의 ResultSet 객체만이 동시에 오픈할 수 있습니다. 따라서, 1 개의 ResultSet 객체의 read가, 다른 read에 의해 끼어들어지면(자), 각각은 다른 Statement 객체에 의해 생성된 것이 됩니다. Statement 인터페이스의 모든 execution 메소드는, 문장의 현재의 ResultSet 객체로 오픈되고 있는 것이 존재하면, 그것을 암묵에 클로즈 합니다.

관련 항목:

Connection.createStatement() , ResultSet

필드의 개요

static int	CLOSE_ALL_RESULTS getMoreResults 가 불려 갔을 때에, 직전까지 오픈되고 있던 모든 ResultSet 객체가 클로즈 되는 것을 나타내는 정수입니다.
static int	CLOSE_CURRENT_RESULT getMoreResults 가 불려 갔을 때에, 현재의 ResultSet 객체가 클로즈 되는 것을 나타내는 정수입니다.
static int	EXECUTE_FAILED 배치문의 실행중에 에러가 발생한 것을 나타내는 정수입니다.
static int	KEEP_CURRENT_RESULT getMoreResults 가 불려 갔을 때에, 현재의 ResultSet 객체가 클로즈 되지 않는 것을 나타내는 정수입니다.
static int	NO_GENERATED_KEYS 생성된 키가 검색 가능하게 되지 않는 것을 나타내는 정수입니다.
static int	RETURN_GENERATED_KEYS 생성된 키가 검색 가능하게 되는 것을 나타내는 정수입니다.
static int	SUCCESS_NO_INFO 배치문이 정상적으로 실행되었지만, 영향을 받은 행수가 불명한 일을 나타내는 정수입니다.

메소드의 개요

void	addBatch (String sql) 이 Statement 객체의 현재의 커멘드의 리스트로 지정된 SQL 커멘드를 추가합니다.
void	cancel () DBMS 및 드라이버의 양쪽 모두가 SQL 문의 종료를 지원하는 경우에, 이 Statement 객체를 취소합니다.
void	clearBatch () 이 Statement 객체의 현재의 SQL 커멘드 리스트를 비웁니다.
void	clearWarnings () 이 Statement 객체에 관해서 보고된 모든 경고를 클리어 합니다.
void	close () 자동적으로 클로즈 될 때 Statement 객체의 데이타베이스와 JDBC 자원이 해제되는 것을 기다리는 것이 아니라, 즉시 그것들을 해제합니다.
boolean	execute (String sql) 복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행합니다.
boolean	execute (String sql, int autoGeneratedKeys) 복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 모든 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다.
boolean	execute (String sql, int[] columnIndexes) 복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다.
boolean	execute (String sql, String [] columnNames) 복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다.
int[]	executeBatch () 커멘드의 배치를 데이타베이스에 송신해 실행해, 모든 커멘드가 정상적으로 실행되면(자), 갱신 카운트의 배열을 돌려줍니다.
ResultSet	executeQuery (String sql) 단일의 ResultSet 객체를 돌려주는, 지정된 SQL 문을 실행합니다.
int	executeUpdate (String sql) 지정된 SQL 문을 실행합니다.
int	executeUpdate (String sql, int autoGeneratedKeys) 지정된 SQL 문을 실행해, 이 Statement 객체에 의해 생성된 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 지정된 플래그로 드라이버에 통지합니다.
int	executeUpdate (String sql, int[] columnIndexes) 지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다.
int	executeUpdate (String sql, String [] columnNames) 지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다.
Connection	getConnection () 이 Statement 객체를 생성한 Connection 객체를 가져옵니다.
int	getFetchDirection () 이 Statement 객체로부터 생성된 결과 세트의 디폴트인, 데이타베이스 테이블에서 행을 페치 할 방향을 가져옵니다.
int	getFetchSize () 이 Statement 객체로부터 생성된 ResultSet 객체의 디폴트의 페치 사이즈인, 결과 세트의 행수를 가져옵니다.
ResultSet	getGeneratedKeys () 이 Statement 객체를 실행한 결과적으로 작성된 자동 생성 키를 가져옵니다.
int	getMaxFieldSize () 이 Statement 객체에 의해 생성되는 ResultSet 객체의 문자 및 바이너리의 각 렬치에 대해 반환되는 최대 바이트수를 가져옵니다.
int	getMaxRows () 이 Statement 객체에 의해 생성되는 ResultSet 객체가 포함할 수 있는 최대의 행수를 가져옵니다.
boolean	getMoreResults () Statement 객체의 다음의 결과로 이동합니다.
boolean	getMoreResults (int current) Statement 객체의 다음의 결과로 이동합니다.
int	getQueryTimeout () 드라이버가 Statement 객체의 실행을 기다리는 초수를 가져옵니다.
ResultSet	getResultSet () ResultSet 객체로서 현재의 결과를 가져옵니다.
int	getResultSetConcurrency () 이 Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 병행성을 가져옵니다.
int	getResultSetHoldability () 이 Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 보관 유지 기능을 가져옵니다.
int	getResultSetType () 이 Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 형태를 가져옵니다.
int	getUpdateCount () 갱신 카운트로서 현재의 결과를 가져옵니다.
SQLWarning	getWarnings () 이 Statement 객체에 관한 호출에 의해 보고되는 최초의 경고를 가져옵니다.
boolean	isClosed () 이 Statement 객체가 클로즈 되고 있는지 어떤지를 가져옵니다.
boolean	isPoolable () Statement 가 풀 가능한가 어떤가를 나타내는 값을 돌려줍니다.
void	setCursorName (String name) 후속의 Statement 객체의 execute 메소드에 의해 사용되는 SQL 커서명이 지정된 String 로 설정합니다.
void	setEscapeProcessing (boolean enable) 이스케이프의 처리를 온 또는 오프로 설정합니다.
void	setFetchDirection (int direction) Statement 객체를 사용해 작성된 ResultSet 객체의 행이 처리될 방향에 대한 힌트를 드라이버에 제공합니다.
void	setFetchSize (int rows) 이 Statement 로 작성된 ResultSet 객체로 보다 많은 행이 필요한 때에 데이타베이스로부터 꺼낼 필요가 있는 행수에 대한 힌트를 JDBC 드라이버에 제공합니다.
void	setMaxFieldSize (int max) 이 Statement 객체에 의해 생성되는 ResultSet 객체의 문자 및 바이너리의 각 렬치에 대해 반환되는 최대 바이트수의 제한을 설정합니다.
void	setMaxRows (int max) 이 Statement 객체로 작성된 임의의 ResultSet 객체가 포함할 수 있는 최대행수의 제한치를, 지정된 수로 설정합니다.
void	setPoolable (boolean poolable) Statement 를 풀 하는 것, 또는 풀 하지 않는 것을 요구합니다.
void	setQueryTimeout (int seconds) 드라이버가 Statement 객체의 실행을 기다리는 초수를, 지정된 초수로 설정합니다.

인터페이스 java.sql. Wrapper 로부터 상속된 메소드

isWrapperFor , unwrap

필드의 상세

CLOSE_CURRENT_RESULT

static final int CLOSE_CURRENT_RESULT

getMoreResults 가 불려 갔을 때에, 현재의 ResultSet 객체가 클로즈 되는 것을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

KEEP_CURRENT_RESULT

static final int KEEP_CURRENT_RESULT

getMoreResults 가 불려 갔을 때에, 현재의 ResultSet 객체가 클로즈 되지 않는 것을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

CLOSE_ALL_RESULTS

static final int CLOSE_ALL_RESULTS

getMoreResults 가 불려 갔을 때에, 직전까지 오픈되고 있던 모든 ResultSet 객체가 클로즈 되는 것을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

SUCCESS_NO_INFO

static final int SUCCESS_NO_INFO

배치문이 정상적으로 실행되었지만, 영향을 받은 행수가 불명한 일을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

EXECUTE_FAILED

static final int EXECUTE_FAILED

배치문의 실행중에 에러가 발생한 것을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

RETURN_GENERATED_KEYS

static final int RETURN_GENERATED_KEYS

생성된 키가 검색 가능하게 되는 것을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

NO_GENERATED_KEYS

static final int NO_GENERATED_KEYS

생성된 키가 검색 가능하게 되지 않는 것을 나타내는 정수입니다.

도입된 버젼:

1.4

관련 항목:

정수 필드치

메소드의 상세

executeQuery

ResultSet  executeQuery(String  sql)
                       throws SQLException 

단일의 ResultSet 객체를 돌려주는, 지정된 SQL 문을 실행합니다.

파라미터:

sql - 데이타베이스에 보내지는 SQL 문. 일반적으로 정적 SQL SELECT 문

반환값:

지정된 쿼리에 의해 작성된 데이터를 포함한 ResultSet 객체. null 는 되지 않는다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 지정된 SQL 문이 단일의 ResultSet 객체 이외의 아무것도 생성하지 않는 경우

executeUpdate

int executeUpdate(String  sql)
                  throws SQLException 

지정된 SQL 문을 실행합니다. SQL 문은,INSERT 문,UPDATE 문,DELETE 문, 또는 SQL DDL 문과 같은 아무것도 돌려주지 않는 SQL 문의 경우가 있습니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문과 같은 SQL 데이터 조작 언어 (DML) 문, 혹은 DDL 문과 같은 아무것도 돌려주지 않는 SQL 문

반환값:

(1) SQL 데이터 조작 언어 (DML) 문의 경우는 행수, (2) 아무것도 돌려주지 않는 SQL 문의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 지정된 SQL 문이 ResultSet 객체를 생성하는 경우

close

void close()
           throws SQLException 

자동적으로 클로즈 될 때 Statement 객체의 데이타베이스와 JDBC 자원이 해제되는 것을 기다리는 것이 아니라, 즉시 그것들을 해제합니다. 데이타베이스의 자원을 점유 하는 것을 피하기 위해서(때문에), 일반적으로은, 작업이 종료하자 마자 자원을 해제하도록 해 주세요.

벌써 클로즈 된 Statement 객체로 close 메소드를 호출하면(자), 조작은 행해지지 않습니다.

주: Statement 객체가 클로즈 될 때, 그 현재의 ResultSet 객체가 존재하면, 그것도 클로즈 됩니다.

예외:

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

getMaxFieldSize

int getMaxFieldSize()
                    throws SQLException 

이 Statement 객체에 의해 생성되는 ResultSet 객체의 문자 및 바이너리의 각 렬치에 대해 반환되는 최대 바이트수를 가져옵니다. 이 제한치는,BINARY,VARBINARY,LONGVARBINARY,CHAR,VARCHAR,NCHAR,NVARCHAR,LONGNVARCHAR, 및 LONGVARCHAR 의 각 열에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다.

반환값:

문자치 및 바이너리치를 포함하는 열에 대한 현재의 열사이즈의 제한치. 제로는 무제한을 의미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

setMaxFieldSize(int)

setMaxFieldSize

void setMaxFieldSize(int max)
                     throws SQLException 

이 Statement 객체에 의해 생성되는 ResultSet 객체의 문자 및 바이너리의 각 렬치에 대해 반환되는 최대 바이트수의 제한을 설정합니다. 이 제한치는,BINARY,VARBINARY,LONGVARBINARY,CHAR,VARCHAR,NCHAR,NVARCHAR,LONGNVARCHAR, 및 LONGVARCHAR 의 각 필드에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다. 이식성을 최대한으로 하려면 , 256 보다 큰 값을 사용합니다.

파라미터:

max - 바이트 단위의 새로운 열사이즈의 제한치. 제로는 무제한을 의미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 조건 max >= 0 이 채워지지 않은 경우

관련 항목:

getMaxFieldSize()

getMaxRows

int getMaxRows()
               throws SQLException 

이 Statement 객체에 의해 생성되는 ResultSet 객체가 포함할 수 있는 최대의 행수를 가져옵니다. 제한치를 넘은 행은 통지없이 제외됩니다.

반환값:

이 Statement 객체에 의해 생성되는 ResultSet 객체의 현재의 최대행수. 제로는 무제한을 의미한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

setMaxRows(int)

setMaxRows

void setMaxRows(int max)
                throws SQLException 

이 Statement 객체로 작성된 임의의 ResultSet 객체가 포함할 수 있는 최대행수의 제한치를, 지정된 수로 설정합니다. 제한치를 넘은 행은 통지없이 제외됩니다.

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 조건 max >= 0 이 채워지지 않은 경우

관련 항목:

getMaxRows()

setEscapeProcessing

void setEscapeProcessing(boolean enable)
                         throws SQLException 

이스케이프의 처리를 온 또는 오프로 설정합니다. 에스케이프스캐닝이 온의 경우 (디폴트), 드라이버는 SQL 문을 데이타베이스에 보내기 전에 이스케이프 치환을 실행합니다. 주:준비된 문장은, 일반적으로 호출하기 전에 구문 분석 되고 있으므로,PreparedStatement 객체에 대한 이스케이프 처리를 무효로 해도 효과는 없습니다.

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

getQueryTimeout

int getQueryTimeout()
                    throws SQLException 

드라이버가 Statement 객체의 실행을 기다리는 초수를 가져옵니다. 이 시간을 경과하면(자),SQLException 가 throw 됩니다.

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

setQueryTimeout(int)

setQueryTimeout

void setQueryTimeout(int seconds)
                     throws SQLException 

드라이버가 Statement 객체의 실행을 기다리는 초수를, 지정된 초수로 설정합니다. 이 제한 시간을 경과하면(자),SQLException 가 throw 됩니다. JDBC 드라이버는, 이 제한을 execute,executeQuery,executeUpdate 의 각 메소드에 적용할 필요가 있습니다. JDBC 드라이버 구현은, 이 제한을 ResultSet 메소드에 적용하는 일도 있습니다 (자세한 것은, 드라이버 벤더의 메뉴얼을 참조해 주세요).

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 조건 seconds >= 0 이 채워지지 않은 경우

관련 항목:

getQueryTimeout()

cancel

void cancel()
            throws SQLException 

DBMS 및 드라이버의 양쪽 모두가 SQL 문의 종료를 지원하는 경우에, 이 Statement 객체를 취소합니다. 이 메소드는, 1 개의 thread가 다른 thread에 의해 실행중의 문장을 취소하는데 사용할 수 있습니다.

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

getWarnings

SQLWarning  getWarnings()
                       throws SQLException 

이 Statement 객체에 관한 호출에 의해 보고되는 최초의 경고를 가져옵니다. 후속의 Statement 객체의 경고는, 이 SQLWarning 객체에 체인 됩니다.

경고 체인은, 문장이 (재) 실행될 때마다 자동적으로 클리어 됩니다. 이 메소드는 클로즈 된 Statement 객체의 호출에는 사용하지 않습니다. 사용하면(자) SQLException 가 throw 됩니다.

주: ResultSet 객체를 처리중의 경우,ResultSet 객체의 읽어들여에 관련하는 경고는 그 객체를 생성한 Statement 객체는 아니고 모두 ResultSet 객체에 체인 됩니다.

반환값:

최초의 SQLWarning 객체. 경고가 없는 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

clearWarnings

void clearWarnings()
                   throws SQLException 

이 Statement 객체에 관해서 보고된 모든 경고를 클리어 합니다. 이 메소드의 호출뒤, 이 Statement 객체에 대한 새로운 경고가 통지될 때까지,getWarnings 메소드는 null 를 돌려줍니다.

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

setCursorName

void setCursorName(String  name)
                   throws SQLException 

후속의 Statement 객체의 execute 메소드에 의해 사용되는 SQL 커서명이 지정된 String 로 설정합니다. 이 이름은, SQL 로 위치 결정 된 갱신문 또는 삭제문으로 사용되어 이 문장으로 생성된 ResultSet 객체내의 현재의 행을 식별할 수 있습니다. 데이타베이스가 위치 결정 된 갱신 또는 삭제를 지원하고 있지 않는 경우, 이 메소드는 아무것도 실행하지 않습니다. 커서가 갱신을 지원하는 적절한 차단 레벨을 가지는 것이 보증되기 위해서(때문에)는, 커서의 SELECT 문은 SELECT FOR UPDATE 형식일 필요가 있습니다. FOR UPDATE 가 존재하지 않는 경우, 위치 결정 된 갱신은 실패합니다.

주: 정의에 의해, 위치 결정 된 갱신 또는 삭제의 실행은, 위치 결정에 사용중의 ResultSet 객체를 생성한 Statement 객체와는 다른 Statement 객체에 의해 실행될 필요가 있습니다. 게다가 커서명은 접속내에서 일의로 할 필요가 있습니다.

파라미터:

name - 새로운 커서명. 접속내에서 일의로 할 필요가 있다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

execute

boolean execute(String  sql)
                throws SQLException 

복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행합니다. 몇개의 (보통이 아니다) 상황에서는, 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있고 있는 스트아드프로시쟈를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로은 이것을 무시할 수 있습니다.

execute 메소드는, SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에,getResultSet 또는 getUpdateCount 메소드를 사용해 결과를 가져옵니다. 그리고,getMoreResults 에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.

파라미터:

sql - 임의의 SQL 문

반환값:

최초의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

getResultSet() , getUpdateCount() , getMoreResults()

getResultSet

ResultSet  getResultSet()
                       throws SQLException 

ResultSet 객체로서 현재의 결과를 가져옵니다. 이 메소드는, 1 개의 결과에 대해 1 회만 호출할 필요가 있습니다.

반환값:

ResultSet 객체로서의 현재의 결과. 갱신 카운트인지, 또는 결과가 없는 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

execute(java.lang.String)

getUpdateCount

int getUpdateCount()
                   throws SQLException 

갱신 카운트로서 현재의 결과를 가져옵니다. 결과가 ResultSet 객체인지, 또는 결과가 없는 경우는 -1 을 돌려줍니다. 이 메소드는, 1 개의 결과에 대해 1 회만 호출할 필요가 있습니다.

반환값:

갱신 카운트 한 현재의 결과. 현재의 결과가 ResultSet 객체인지, 또는 결과가 없는 경우는 -1

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

execute(java.lang.String)

getMoreResults

boolean getMoreResults()
                       throws SQLException 

Statement 객체의 다음의 결과로 이동합니다. 이 결과가 ResultSet 객체의 경우는 true 를 돌려주어,getResultSet 메소드로 얻을 수 있던 현재의 ResultSet 객체를 모두 암묵에 클로즈 합니다.

다음에 해당하는 경우, 결과는 없습니다.

// stmt is a Statement object
((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1))
 

반환값:

다음의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

관련 항목:

execute(java.lang.String)

setFetchDirection

void setFetchDirection(int direction)
                       throws SQLException 

Statement 객체를 사용해 작성된 ResultSet 객체의 행이 처리될 방향에 대한 힌트를 드라이버에 제공합니다. 디폴트 값는 ResultSet.FETCH_FORWARD 입니다.

이 메소드는, 이 Statement 객체에 의해 생성되는 결과 세트의 디폴트의 페치 방향을 설정합니다. 각 결과 세트는, 그것 자신의 페치 방향을 취득 및 설정하기 위한 독자적인 메소드를 가집니다.

파라미터:

direction - 행을 처리하는 초기 방향

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 지정된 방향이 ResultSet.FETCH_FORWARD,ResultSet.FETCH_REVERSE, 또는 ResultSet.FETCH_UNKNOWN 의 어떤 것도 아닌 경우

도입된 버젼:

1.2

관련 항목:

getFetchDirection()

getFetchDirection

int getFetchDirection()
                      throws SQLException 

이 Statement 객체로부터 생성된 결과 세트의 디폴트인, 데이타베이스 테이블에서 행을 페치 할 방향을 가져옵니다. 이 Statement 객체가 setFetchDirection 메소드를 호출해 페치 방향을 설정하고 있지 않는 경우, 반환값은 구현에 의존합니다.

반환값:

이 Statement 객체로부터 생성된 결과 세트의 디폴트의 페치 방향

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

도입된 버젼:

1.2

관련 항목:

setFetchDirection(int)

setFetchSize

void setFetchSize(int rows)
                  throws SQLException 

이 Statement 로 작성된 ResultSet 객체로 보다 많은 행이 필요한 때에 데이타베이스로부터 꺼낼 필요가 있는 행수에 대한 힌트를 JDBC 드라이버에 제공합니다. 지정된 값이 0 의 경우, 힌트는 무시됩니다. 디폴트 값는 제로입니다.

파라미터:

rows - 페치 하는 행수

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 조건 rows >= 0 이 채워지지 않은 경우

도입된 버젼:

1.2

관련 항목:

getFetchSize()

getFetchSize

int getFetchSize()
                 throws SQLException 

이 Statement 객체로부터 생성된 ResultSet 객체의 디폴트의 페치 사이즈인, 결과 세트의 행수를 가져옵니다. 이 Statement 객체가 setFetchSize 메소드를 호출해 페치 사이즈를 설정하고 있지 않는 경우, 반환값은 구현에 의존합니다.

반환값:

이 Statement 객체로부터 생성된 결과 세트의 디폴트의 페치 사이즈

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

도입된 버젼:

1.2

관련 항목:

setFetchSize(int)

getResultSetConcurrency

int getResultSetConcurrency()
                            throws SQLException 

이 Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 병행성을 가져옵니다.

반환값:

ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

도입된 버젼:

1.2

getResultSetType

int getResultSetType()
                     throws SQLException 

이 Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 형태를 가져옵니다.

반환값:

ResultSet.TYPE_FORWARD_ONLY,ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1 개

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

도입된 버젼:

1.2

addBatch

void addBatch(String  sql)
              throws SQLException 

이 Statement 객체의 현재의 커멘드의 리스트로 지정된 SQL 커멘드를 추가합니다. 이 리스트의 커멘드는 executeBatch 메소드를 호출하는 것으로, 배치로서 실행할 수 있습니다.

파라미터:

sql - 일반적으로은 SQL INSERT 문 또는 UPDATE 문

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 드라이버가 배치 갱신을 지원하지 않는 경우

도입된 버젼:

1.2

관련 항목:

executeBatch() , DatabaseMetaData.supportsBatchUpdates()

clearBatch

void clearBatch()
                throws SQLException 

이 Statement 객체의 현재의 SQL 커멘드 리스트를 비웁니다.

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 드라이버가 배치 갱신을 지원하지 않는 경우

도입된 버젼:

1.2

관련 항목:

addBatch(java.lang.String) , DatabaseMetaData.supportsBatchUpdates()

executeBatch

int[] executeBatch()
                   throws SQLException 

커멘드의 배치를 데이타베이스에 송신해 실행해, 모든 커멘드가 정상적으로 실행되면(자), 갱신 카운트의 배열을 돌려줍니다. 반환되는 배열의 int 요소는, 배치내의 커멘드에 대응해 돌려주어지고 순서 붙일 수 있습니다. 즉, 배치에 추가된 순서에 따라 순서 붙일 수 있습니다. executeBatch 메소드에 의해 반환되는 배열내의 요소는, 다음의 어느쪽이든 1 개(살)에 해당합니다.

1. 제로 이상의 수치 -- 커멘드가 정상적으로 처리된 것을 나타내, 커멘드의 실행에 의해 영향을 받은 데이타베이스내의 행수를 지정하는 갱신 카운트입니다.
2. SUCCESS_NO_INFO 의 값 -- 커멘드가 정상적으로 처리되었지만, 영향을 받은 행수가 불명한 일을 나타냅니다.

   배치 갱신내의 커멘드의 1 개를 정상적으로 실행할 수 없었던 경우, 이 메소드는 BatchUpdateException 를 throw 해, JDBC 드라이버는 배치내의 나머지의 커멘드의 처리를 계속하는 일도, 중지할 수도 있습니다. 다만, 드라이버의 동작은 특정의 DBMS 와 일관성을 유지할 필요가 있어, 항상 커멘드의 처리를 계속하든가, 혹은 계속하지 않는가의 어딘가에 됩니다. 실패 후, 드라이버가 처리를 계속하는 경우는,BatchUpdateException.getUpdateCounts 메소드로 반환되는 배열에는, 배치내의 커멘드와 같은 수의 요소가 포함되어 그러한 요소의 1 개 이상이 다음에 해당합니다.

3. EXECUTE_FAILED 의 값 -- 실패한 커멘드가 정상적으로 실행된 것을 나타내, 커멘드가 실패한 뒤에, 드라이버가 커멘드의 처리를 계속했을 경우에 한정해 발생합니다.

Java 2 SDK, Standard Edition, Version 1.3 에서는, 사용할 수 있는 구현 및 반환값이 수정되어,BatchUpdateException 객체가 throw 된 뒤에 배치 갱신내의 커멘드의 처리를 계속할 수 있는 옵션이 준비되어 있습니다.

반환값:

배치내의 커멘드 마다 1 개의 요소가 포함되고 있는 갱신 카운트의 배열. 배열의 요소는 커멘드가 배치에 추가된 순서로 늘어놓을 수 있다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 드라이버가 배치문을 지원하지 않는 경우. 데이타베이스에 송신된 커멘드의 1 개가 정상적으로 실행되지 않았던 경우나, 결과 세트를 돌려주려고 하면(자) BatchUpdateException (SQLException 의 서브 클래스)가 throw 되는

도입된 버젼:

1.3

관련 항목:

addBatch(java.lang.String) , DatabaseMetaData.supportsBatchUpdates()

getConnection

Connection  getConnection()
                         throws SQLException 

이 Statement 객체를 생성한 Connection 객체를 가져옵니다.

반환값:

이 문장을 생성한 접속

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

도입된 버젼:

1.2

getMoreResults

boolean getMoreResults(int current)
                       throws SQLException 

Statement 객체의 다음의 결과로 이동합니다. 지정된 플래그에 의해 지정된 명령에 따라 모든 현재의 ResultSet 객체를 처리해, 다음의 결과가 ResultSet 객체의 경우는 true 를 돌려줍니다.

다음에 해당하는 경우, 결과는 없습니다.

// stmt is a Statement object
((stmt.getMoreResults(current) == false) && (stmt.getUpdateCount() == -1))
 

파라미터:

current - getResultSet 메소드를 사용해 취득한 현재의 ResultSet 객체에 생기는 상태를 나타내는 Statement 정수. Statement.CLOSE_CURRENT_RESULT,Statement.KEEP_CURRENT_RESULT, 또는 Statement.CLOSE_ALL_RESULTS 가운데 1 개

반환값:

다음의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 지정된 인수가 Statement.CLOSE_CURRENT_RESULT,Statement.KEEP_CURRENT_RESULT, 또는 Statement.CLOSE_ALL_RESULTS 의 어떤 것도 아닌 경우

SQLFeatureNotSupportedException - DatabaseMetaData.supportsMultipleOpenResults 가 false 를 돌려주어, 지정된 인수가 Statement.KEEP_CURRENT_RESULT 또는 Statement.CLOSE_ALL_RESULTS 인 경우

도입된 버젼:

1.4

관련 항목:

execute(java.lang.String)

getGeneratedKeys

ResultSet  getGeneratedKeys()
                           throws SQLException 

이 Statement 객체를 실행한 결과적으로 작성된 자동 생성 키를 가져옵니다. 이 Statement 객체가 키를 생성하지 않았던 경우는, 빈 상태(empty)의 ResultSet 객체가 돌려주어집니다.

주: 자동 생성 키를 나타내는 열이 지정되지 않았던 경우, JDBC 드라이버 구현에서는, 자동 생성 키를 나타내는데 최적인 열을 판단합니다.

반환값:

이 Statement 객체의 실행으로 생성된 자동 생성 키를 포함한 ResultSet 객체

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

executeUpdate

int executeUpdate(String  sql,
                  int autoGeneratedKeys)
                  throws SQLException 

지정된 SQL 문을 실행해, 이 Statement 객체에 의해 생성된 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 지정된 플래그로 드라이버에 통지합니다. SQL 문이 INSERT 문이 아닌 경우, 또는 자동 생성 키를 돌려줄 수가 있는 SQL 문이 아닌 경우 (그러한 문장의 리스트는 벤더 고유), 드라이버는 플래그를 무시합니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문과 같은 SQL 데이터 조작 언어 (DML) 문, 혹은 DDL 문과 같은 아무것도 돌려주지 않는 SQL 문

autoGeneratedKeys - 자동 생성 키가 검색 가능하게 될지 어떨지를 나타내는 플래그. 정수 Statement.RETURN_GENERATED_KEYS 또는 Statement.NO_GENERATED_KEYS

반환값:

(1) SQL 데이터 조작 언어 (DML) 문의 경우는 행수, (2) 아무것도 돌려주지 않는 SQL 문의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 지정된 SQL 문이 ResultSet 객체를 돌려주는 경우, 또는 지정된 정수가 허가된 정수의 어떤 것도 아닌 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 정수 Statement.RETURN_GENERATED_KEYS 를 지정한 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

executeUpdate

int executeUpdate(String  sql,
                  int[] columnIndexes)
                  throws SQLException 

지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. 이 배열은 검색 가능하게 되는 자동 생성 키를 포함한 타겟 테이블의 열의 인덱스를 포함합니다. SQL 문이 INSERT 문이 아닌 경우, 또는 자동 생성 키를 돌려줄 수가 있는 SQL 문이 아닌 경우, 드라이버는 배열을 무시합니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문과 같은 SQL 데이터 조작 언어 (DML) 문, 혹은 DDL 문과 같은 아무것도 돌려주지 않는 SQL 문

columnIndexes - 삽입된 행으로부터 반환되는 열을 나타내는 열인덱스의 배열

반환값:

(1) SQL 데이터 조작 언어 (DML) 문의 경우는 행수, (2) 아무것도 돌려주지 않는 SQL 문의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, SQL 문이 ResultSet 객체를 돌려주는 경우, 또는 이 메소드로 지정된 2 번째의 인수가, 유효한 열인덱스를 요소로 하는 int 배열이 아닌 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

executeUpdate

int executeUpdate(String  sql,
                  String [] columnNames)
                  throws SQLException 

지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. 이 배열은 검색 가능하게 되는 자동 생성 키를 포함한 타겟 테이블의 열의 이름을 포함합니다. SQL 문이 INSERT 문이 아닌 경우, 또는 자동 생성 키를 돌려줄 수가 있는 SQL 문이 아닌 경우, 드라이버는 배열을 무시합니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문과 같은 SQL 데이터 조작 언어 (DML) 문, 혹은 DDL 문과 같은 아무것도 돌려주지 않는 SQL 문

columnNames - 삽입된 행으로부터 반환되는 열의 이름의 배열

반환값:

INSERT 문,UPDATE 문,DELETE 문의 경우는 행수. 아무것도 돌려주지 않는 SQL 문의 경우는 0

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, SQL 문이 ResultSet 객체를 돌려주는 경우, 또는 이 메소드로 지정된 2 번째의 인수가, 유효한 렬명을 요소로 하는 String 배열이 아닌 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

execute

boolean execute(String  sql,
                int autoGeneratedKeys)
                throws SQLException 

복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 모든 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. SQL 문이 INSERT 문이 아닌 경우, 또는 자동 생성 키를 돌려줄 수가 있는 SQL 문이 아닌 경우 (그러한 문장의 리스트는 벤더 고유), 드라이버는 이 신호를 무시합니다.

몇개의 (보통이 아니다) 상황에서는, 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있고 있는 스트아드프로시쟈를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로은 이것을 무시할 수 있습니다.

execute 메소드는, SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에,getResultSet 또는 getUpdateCount 메소드를 사용해 결과를 가져옵니다. 그리고,getMoreResults 에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.

파라미터:

sql - 임의의 SQL 문

autoGeneratedKeys - getGeneratedKeys 메소드를 사용해, 자동 생성 키를 검색 가능하게 할지 어떨지를 나타내는 정수. 정수 Statement.RETURN_GENERATED_KEYS 또는 Statement.NO_GENERATED_KEYS

반환값:

최초의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 이 메소드로 지정된 2 번째의 파라미터가 Statement.RETURN_GENERATED_KEYS 도 Statement.NO_GENERATED_KEYS 도 아닌 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 정수 Statement.RETURN_GENERATED_KEYS 를 지정한 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

관련 항목:

getResultSet() , getUpdateCount() , getMoreResults() , getGeneratedKeys()

execute

boolean execute(String  sql,
                int[] columnIndexes)
                throws SQLException 

복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. 이 배열은 검색 가능하게 되는 자동 생성 키를 포함한 타겟 테이블의 열의 인덱스를 포함합니다. SQL 문이 INSERT 문이 아닌 경우, 또는 자동 생성 키를 돌려줄 수가 있는 SQL 문이 아닌 경우, 드라이버는 배열을 무시합니다.

몇개의 (보통이 아니다) 상황에서는, 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있고 있는 스트아드프로시쟈를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로은 이것을 무시할 수 있습니다.

execute 메소드는, SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에,getResultSet 또는 getUpdateCount 메소드를 사용해 결과를 가져옵니다. 그리고,getMoreResults 에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.

파라미터:

sql - 임의의 SQL 문

columnIndexes - getGeneratedKeys 메소드의 호출에 의해 검색 가능하게 되는 삽입행의 열인덱스의 배열

반환값:

최초의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 이 메소드에게 건네진 int 배열의 요소가 유효한 열인덱스가 아닌 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

관련 항목:

getResultSet() , getUpdateCount() , getMoreResults()

execute

boolean execute(String  sql,
                String [] columnNames)
                throws SQLException 

복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. 이 배열은 검색 가능하게 되는 자동 생성 키를 포함한 타겟 테이블의 열의 이름을 포함합니다. SQL 문이 INSERT 문이 아닌 경우, 또는 자동 생성 키를 돌려줄 수가 있는 SQL 문이 아닌 경우, 드라이버는 배열을 무시합니다.

몇개의 (보통이 아니다) 상황에서는, 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있고 있는 스트아드프로시쟈를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로은 이것을 무시할 수 있습니다.

execute 메소드는, SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에,getResultSet 또는 getUpdateCount 메소드를 사용해 결과를 가져옵니다. 그리고,getMoreResults 에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.

파라미터:

sql - 임의의 SQL 문

columnNames - getGeneratedKeys 메소드의 호출에 의해 검색 가능하게 되는 삽입행의 렬명의 배열

반환값:

다음의 결과가 ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우, 또는 이 메소드에게 건네진 String 배열의 요소가 유효한 렬명이 아닌 경우

SQLFeatureNotSupportedException - JDBC 드라이버가 이 메소드를 지원하지 않는 경우

도입된 버젼:

1.4

관련 항목:

getResultSet() , getUpdateCount() , getMoreResults() , getGeneratedKeys()

getResultSetHoldability

int getResultSetHoldability()
                            throws SQLException 

이 Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 보관 유지 기능을 가져옵니다.

반환값:

ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메소드가 클로즈 된 Statement 에 대해 불려 갔을 경우

도입된 버젼:

1.4

isClosed

boolean isClosed()
                 throws SQLException 

이 Statement 객체가 클로즈 되고 있는지 어떤지를 가져옵니다. Statement 로 close 메소드가 불려 가는지, 또는 자동적으로 클로즈 되는 경우, 이 객체는 클로즈 됩니다.

반환값:

이 Statement 객체가 클로즈 되고 있는 경우는 true, 아직 오픈 상태의 경우는 false

예외:

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

도입된 버젼:

1.6

setPoolable

void setPoolable(boolean poolable)
                 throws SQLException 

Statement 를 풀 하는 것, 또는 풀 하지 않는 것을 요구합니다. 지정된 값은, 문장의 풀 구현의 힌트로, 어플리케이션으로 문장이 풀 될 필요가 있을지 어떨지를 나타냅니다. 힌트가 사용될지 어떨지는, 문장의 풀 관리 프로그램에 따라서 다릅니다.

문장의 풀 가능한 값은, 드라이버에 의해 구현되는 내부문 캐쉬와 어플리케이션 서버나 그 외의 어플리케이션에 의해 구현되는 외부문 캐쉬의 양쪽 모두에 적용됩니다.

디폴트로,Statement 는 작성시에 풀 가능하지는 않습니다만,PreparedStatement 및 CallableStatement 는 작성시에 풀 가능합니다.

파라미터:

poolable - true 의 경우는 문장을 풀 하는 것, false 의 경우는 문장을 풀 하지 않는 것을 요구한다

예외:

SQLException - 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우

도입된 버젼:

1.6

isPoolable

boolean isPoolable()
                   throws SQLException 

Statement 가 풀 가능한가 어떤가를 나타내는 값을 돌려줍니다.

반환값:

Statement 가 풀 가능한 경우는 true, 그렇지 않은 경우는 false

예외:

SQLException - 이 메소드가 클로즈 된 Statement 로 불려 갔을 경우

도입된 버젼:

1.6

관련 항목:

setPoolable(boolean)