java.sql
인터페이스 Statement

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

CallableStatement , PreparedStatement

public interface Statement

정적 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 오브젝트에 관한 호출에 의해 보고되는 최초의 경고를 취득합니다.
void	setCursorName (String name) 후속의 Statement 오브젝트의 execute 메소드에 의해 사용되는 SQL 커서명이 지정된 String 로 설정합니다.
void	setEscapeProcessing (boolean enable) 이스케이프의 처리를 온 또는 오프로 설정합니다.
void	setFetchDirection (int direction) Statement 오브젝트를 사용해 작성된 ResultSet 오브젝트의 행이 처리될 방향에 대한 힌트를 드라이버에 제공합니다.
void	setFetchSize (int rows) 보다 많은 행이 필요한 때에, 데이타베이스로부터 꺼낼 필요가 있는 행수에 대한 힌트를 JDBC 드라이버에 제공합니다.
void	setMaxFieldSize (int max) 캐릭터 또는 바이너리의 값을 저장하는 ResultSet 열에 대한 최대 바이트수의 제한치를, 지정된 바이트수로 설정합니다.
void	setMaxRows (int max) 임의의 ResultSet 오브젝트가 포함할 수 있는 최대행수의 제한치를, 지정된 수로 설정합니다.
void	setQueryTimeout (int seconds) 드라이버가 Statement 오브젝트의 실행을 기다리는 초수를, 지정된 초수로 설정합니다.

필드의 상세

CLOSE_CURRENT_RESULT

public static final int CLOSE_CURRENT_RESULT

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

KEEP_CURRENT_RESULT

public static final int KEEP_CURRENT_RESULT

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

CLOSE_ALL_RESULTS

public static final int CLOSE_ALL_RESULTS

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

SUCCESS_NO_INFO

public static final int SUCCESS_NO_INFO

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

EXECUTE_FAILED

public static final int EXECUTE_FAILED

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

RETURN_GENERATED_KEYS

public static final int RETURN_GENERATED_KEYS

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

NO_GENERATED_KEYS

public static final int NO_GENERATED_KEYS

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

도입된 버젼:

1.4

관련 항목:

정수 필드치

메소드의 상세

executeQuery

public ResultSet  executeQuery(String  sql)
                       throws SQLException 

단일의 ResultSet 오브젝트를 돌려주는 지정된 SQL 문을 실행합니다.

파라미터:

sql - 데이타베이스에 보내지는 SQL 문. 통상 정적 SQL SELECT 문

반환값:

지정된 쿠에리-에 의해 작성된 데이터를 포함한 ResultSet 오브젝트. null 는 되지 않는다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 SQL 문이 단일의 ResultSet 오브젝트 이외의 것을 생성하는 경우

executeUpdate

public int executeUpdate(String  sql)
                  throws SQLException 

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

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문, 혹은 아무것도 돌려주지 않는 SQL 문

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 SQL 문이 ResultSet 오브젝트를 생성하는 경우

close

public void close()
           throws SQLException 

자동적으로 클로우즈 될 때 Statement 오브젝트의 데이타베이스와 JDBC 리소스가 해방되는 것을 기다리는 것이 아니라, 즉시 그것들을 해방합니다. 데이타베이스의 리소스를 점유 하는 것을 피하기 위해서(때문에), 통상은 작업이 종료하자 마자 리소스를 해방하도록 해 주세요.

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

주: Statement 오브젝트는 가베지 컬렉트될 때는 자동적으로 클로우즈 됩니다. Statement 오브젝트가 클로우즈 될 때, 그 현재의 ResultSet 오브젝트가 존재하면, 그것도 클로우즈 됩니다.

예외:

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

getMaxFieldSize

public int getMaxFieldSize()
                    throws SQLException 

이 Statement 오브젝트에 의해 생성되는 ResultSet 오브젝트의 캐릭터 및 바이너리의 각 렬치에 대해 돌려주어지는 최대 바이트수를 취득합니다. 이 제한치는 BINARY,VARBINARY,LONGVARBINARY,CHAR,VARCHAR, 및 LONGVARCHAR 의 각 열에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다.

반환값:

캐릭터치 및 바이너리치를 저장하는 열에 대한 현재의 열사이즈의 제한치. 제로는 무제한을 의미한다

예외:

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

관련 항목:

setMaxFieldSize(int)

setMaxFieldSize

public void setMaxFieldSize(int max)
                     throws SQLException 

캐릭터 또는 바이너리의 값을 저장하는 ResultSet 열에 대한 최대 바이트수의 제한치를, 지정된 바이트수로 설정합니다. 이 제한치는 BINARY,VARBINARY,LONGVARBINARY,CHAR,VARCHAR,LONGVARCHAR 의 각 필드에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다. 이식성을 최대한으로 하려면 , 256 보다 큰 값을 사용합니다.

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 max >= 0 이 채워지지 않은 경우

관련 항목:

getMaxFieldSize()

getMaxRows

public int getMaxRows()
               throws SQLException 

이 Statement 오브젝트에 의해 생성되는 ResultSet 오브젝트가 포함할 수 있는 최대의 행수를 취득합니다. 제한치를 넘은 행은 통지없이 제외됩니다.

반환값:

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

예외:

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

관련 항목:

setMaxRows(int)

setMaxRows

public void setMaxRows(int max)
                throws SQLException 

임의의 ResultSet 오브젝트가 포함할 수 있는 최대행수의 제한치를, 지정된 수로 설정합니다. 제한치를 넘은 행은 통지없이 제외됩니다.

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 max >= 0 이 채워지지 않은 경우

관련 항목:

getMaxRows()

setEscapeProcessing

public void setEscapeProcessing(boolean enable)
                         throws SQLException 

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

파라미터:

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

예외:

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

getQueryTimeout

public int getQueryTimeout()
                    throws SQLException 

드라이버가 Statement 오브젝트의 실행을 기다리는 초수를 취득합니다. 이 시간을 경과하면(자),SQLException 가 슬로우 됩니다.

반환값:

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

예외:

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

관련 항목:

setQueryTimeout(int)

setQueryTimeout

public void setQueryTimeout(int seconds)
                     throws SQLException 

드라이버가 Statement 오브젝트의 실행을 기다리는 초수를, 지정된 초수로 설정합니다. 이 시간을 경과하면(자),SQLException 가 슬로우 됩니다.

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 seconds >= 0 이 채워지지 않은 경우

관련 항목:

getQueryTimeout()

cancel

public void cancel()
            throws SQLException 

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

예외:

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

getWarnings

public SQLWarning  getWarnings()
                       throws SQLException 

이 Statement 오브젝트에 관한 호출에 의해 보고되는 최초의 경고를 취득합니다. 후속의 Statement 오브젝트의 경고는 이 SQLWarning 오브젝트에 체인 됩니다.

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

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

반환값:

최초의 SQLWarning 오브젝트. 경고가 없는 경우는 null

예외:

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

clearWarnings

public void clearWarnings()
                   throws SQLException 

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

예외:

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

setCursorName

public void setCursorName(String  name)
                   throws SQLException 

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

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

파라미터:

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

예외:

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

execute

public boolean execute(String  sql)
                throws SQLException 

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

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

파라미터:

sql - 임의의 SQL 문

반환값:

최초의 결과가 ResultSet 오브젝트의 경우는 true. 갱신 카운트인지 또는 결과가 없는 경우는 false

예외:

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

관련 항목:

getResultSet() , getUpdateCount() , getMoreResults()

getResultSet

public ResultSet  getResultSet()
                       throws SQLException 

ResultSet 오브젝트로서 현재의 결과를 취득합니다. 이 메소드는 1 개의 결과에 대해 1 회만 호출하지 않으면 안됩니다.

반환값:

ResultSet 오브젝트로서의 현재의 결과. 갱신 카운트인지 또는 결과가 없는 경우는 null

예외:

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

관련 항목:

execute(java.lang.String)

getUpdateCount

public int getUpdateCount()
                   throws SQLException 

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

반환값:

갱신 카운트 한 현재의 결과. 현재의 결과가 ResultSet 오브젝트인지 또는 결과가 없는 경우는 -1

예외:

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

관련 항목:

execute(java.lang.String)

getMoreResults

public boolean getMoreResults()
                       throws SQLException 

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

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

      (! getMoreResults() && (getUpdateCount() == -1)
 

반환값:

다음의 결과가 ResultSet 오브젝트의 경우는 true. 갱신 카운트인지 또는 결과가 없는 경우는 false

예외:

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

관련 항목:

execute(java.lang.String)

setFetchDirection

public void setFetchDirection(int direction)
                       throws SQLException 

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

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

파라미터:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 방향이 ResultSet.FETCH_FORWARD,ResultSet.FETCH_REVERSE, 또는 ResultSet.FETCH_UNKNOWN 의 어떤 것도 아닌 경우

도입된 버젼:

1.2

관련 항목:

getFetchDirection()

getFetchDirection

public int getFetchDirection()
                      throws SQLException 

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

반환값:

이 Statement 오브젝트로부터 생성된 결과 세트의 디폴트의 페치 방향

예외:

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

도입된 버젼:

1.2

관련 항목:

setFetchDirection(int)

setFetchSize

public void setFetchSize(int rows)
                  throws SQLException 

보다 많은 행이 필요한 때에, 데이타베이스로부터 꺼낼 필요가 있는 행수에 대한 힌트를 JDBC 드라이버에 제공합니다. 지정된 행수는 이 Statement 를 사용해 작성된 결과 세트에만 영향을 줍니다. 지정된 값이 0 의 경우, 힌트는 무시됩니다. 디폴트 값은 0 입니다.

파라미터:

rows - 페치 하는 행수

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 0 <= rows <= this.getMaxRows() 가 채워지지 않은 경우

도입된 버젼:

1.2

관련 항목:

getFetchSize()

getFetchSize

public int getFetchSize()
                 throws SQLException 

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

반환값:

이 Statement 오브젝트로부터 생성된 결과 세트의 디폴트의 페치 사이즈

예외:

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

도입된 버젼:

1.2

관련 항목:

setFetchSize(int)

getResultSetConcurrency

public int getResultSetConcurrency()
                            throws SQLException 

이 Statement 오브젝트로부터 생성된 ResultSet 오브젝트의 결과 세트의 병행성을 취득합니다.

반환값:

ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE

예외:

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

도입된 버젼:

1.2

getResultSetType

public int getResultSetType()
                     throws SQLException 

이 Statement 오브젝트로부터 생성된 ResultSet 오브젝트의 결과 세트의 형태를 취득합니다.

반환값:

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

예외:

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

도입된 버젼:

1.2

addBatch

public void addBatch(String  sql)
              throws SQLException 

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

주: 이 메소드는 옵션입니다.

파라미터:

sql - 통상 정적 SQL INSERT 문, 또는 UPDATE 문

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 드라이버가 배치 갱신을 서포트하고 있지 않는 경우

도입된 버젼:

1.2

관련 항목:

executeBatch()

clearBatch

public void clearBatch()
                throws SQLException 

이 Statement 오브젝트의 현재의 SQL 커멘드 리스트를 비웁니다.

주: 이 메소드는 옵션입니다.

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 드라이버가 배치 갱신을 서포트하고 있지 않는 경우

도입된 버젼:

1.2

관련 항목:

addBatch(java.lang.String)

executeBatch

public int[] executeBatch()
                   throws SQLException 

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

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

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

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

드라이버는 이 메소드를 구현할 필요는 없습니다. Java 2 SDK, Standard Edition, 버젼 1.3 에서는 사용할 수 있는 구현 및 반환값이 수정되어,BatchUpdateException 오브젝트가 슬로우 된 뒤에 배치 갱신내의 커멘드의 처리를 계속할 수 있는 옵션이 준비되어 있습니다.

반환값:

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

예외:

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

도입된 버젼:

1.3

getConnection

public Connection  getConnection()
                         throws SQLException 

이 Statement 오브젝트를 생성한 Connection 오브젝트를 취득합니다.

반환값:

이 문장을 생성한 접속

예외:

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

도입된 버젼:

1.2

getMoreResults

public boolean getMoreResults(int current)
                       throws SQLException 

Statement 오브젝트의 다음의 결과로 이동합니다. 지정된 플래그에 의해 지정된 인스트럭션에 따라 모든 현재의 ResultSet 오브젝트를 처리해, 다음의 결과가 ResultSet 오브젝트의 경우는 true 를 돌려줍니다.

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

      (! getMoreResults() && (getUpdateCount() == -1)
 

파라미터:

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

반환값:

다음의 결과가 ResultSet 오브젝트의 경우는 true. 갱신 카운트인지 또는 결과가 없는 경우는 false

예외:

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

도입된 버젼:

1.4

관련 항목:

execute(java.lang.String)

getGeneratedKeys

public ResultSet  getGeneratedKeys()
                           throws SQLException 

이 Statement 오브젝트를 실행한 결과적으로 작성된 자동 생성 키를 취득합니다. 이 Statement 오브젝트가 키를 생성하지 않았던 경우는 하늘의 ResultSet 오브젝트가 돌려주어집니다.

반환값:

이 Statement 오브젝트의 실행으로 생성된 자동 생성 키를 포함한 ResultSet 오브젝트

예외:

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

도입된 버젼:

1.4

executeUpdate

public int executeUpdate(String  sql,
                         int autoGeneratedKeys)
                  throws SQLException 

지정된 SQL 문을 실행해, 이 Statement 오브젝트에 의해 생성된 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 지정된 플래그로 드라이버에 통지합니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문, 혹은 아무것도 돌려주지 않는 SQL 문이 아니면 안되는

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

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 지정된 SQL 문이 ResultSet 오브젝트를 돌려주는 경우, 또는 지정된 정수가 허가되어 있지 않은 경우

도입된 버젼:

1.4

executeUpdate

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

지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. SQL 문이 INSERT 문이 아닌 경우, 드라이버는 그 배열을 무시합니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문, 혹은 SQL DDL 문과 같은 아무것도 돌려주지 않는 SQL 문

columnIndexes - 삽입된 행으로부터 돌려주어지는 열을 나타내는 열인덱스의 배열

반환값:

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

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 SQL 문이 ResultSet 오브젝트를 돌려주는 경우

도입된 버젼:

1.4

executeUpdate

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

지정된 SQL 문을 실행해, 지정된 배열로 나타난 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. SQL 문이 INSERT 문이 아닌 경우, 드라이버는 그 배열을 무시합니다.

파라미터:

sql - SQL INSERT 문,UPDATE 문, 또는 DELETE 문, 혹은 아무것도 돌려주지 않는 SQL 문

columnNames - 삽입된 행으로부터 돌려주어지는 열의 이름의 배열

반환값:

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

예외:

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

도입된 버젼:

1.4

execute

public boolean execute(String  sql,
                       int autoGeneratedKeys)
                throws SQLException 

복수의 결과를 돌려줄 가능성이 있는 지정된 SQL 문을 실행해, 모든 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 드라이버에 통지합니다. SQL 문이 INSERT 문이 아닌 경우, 드라이버는 이 통지를 무시합니다.

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

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

파라미터:

sql - 임의의 SQL 문

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

반환값:

최초의 결과가 ResultSet 오브젝트의 경우는 true. 갱신 카운트인지 또는 결과가 없는 경우는 false

예외:

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

도입된 버젼:

1.4

관련 항목:

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

execute

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

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

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

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

파라미터:

sql - 임의의 SQL 문

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

반환값:

최초의 결과가 ResultSet 오브젝트의 경우는 true. 갱신 카운트인지 또는 결과가 없는 경우는 false

예외:

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

도입된 버젼:

1.4

관련 항목:

getResultSet() , getUpdateCount() , getMoreResults()

execute

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

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

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

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

파라미터:

sql - 임의의 SQL 문

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

반환값:

다음의 결과가 ResultSet 오브젝트의 경우는 true. 갱신 카운트인지 또는 결과가 없는 경우는 false

예외:

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

도입된 버젼:

1.4

관련 항목:

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

getResultSetHoldability

public int getResultSetHoldability()
                            throws SQLException 

이 Statement 오브젝트로부터 생성된 ResultSet 오브젝트의 결과 세트의 보관 유지 기능을 취득합니다.

반환값:

ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT

예외:

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

도입된 버젼:

1.4