|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
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 객체의 실행을 기다리는 초수를, 지정된 초수로 설정합니다. |
| 필드의 상세 |
|---|
static final int CLOSE_CURRENT_RESULT
getMoreResults가 불려 갔을 때에
현재의 ResultSet 객체가 클로우즈 되는 것을 나타내는 정수입니다.
static final int KEEP_CURRENT_RESULT
getMoreResults가 불려 갔을 때에
현재의 ResultSet 객체가 클로우즈 되지 않는 것을 나타내는 정수입니다.
static final int CLOSE_ALL_RESULTS
getMoreResults가 불려 갔을 때에
직전까지 오픈되고 있던 모든 ResultSet 객체가 클로우즈 되는 것을 나타내는 정수입니다.
static final int SUCCESS_NO_INFO
static final int EXECUTE_FAILED
static final int RETURN_GENERATED_KEYS
static final int NO_GENERATED_KEYS
| 메서드의 상세 |
|---|
ResultSet executeQuery(String sql)
throws SQLException
ResultSet 객체를 돌려주는 지정된 SQL 문을 실행합니다.
sql - 데이타베이스에 보내지는 SQL 문. 보통
정적 SQL SELECT 문
ResultSet 객체. null은 되지 않는다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 SQL 문이 단일의 ResultSet 객체 이외의 것을 생성하는 경우
int executeUpdate(String sql)
throws SQLException
INSERT 문, UPDATE 문, DELETE 문, 또는 SQL DDL 문과 같은 아무것도 돌려주지 않는 SQL 문의 경우가 있습니다.
sql - SQL INSERT 문, UPDATE 문, 또는 DELETE 문, 혹은 아무것도 돌려주지 않는 SQL 문
INSERT 문, UPDATE 문, DELETE 문의 경우는 행수. 아무것도 돌려주지 않는 SQL 문의 경우는 0
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 SQL 문이 ResultSet 객체를 생성하는 경우
void close()
throws SQLException
Statement 객체의 데이타베이스와 JDBC 자원이 해방되는 것을 기다리는 것이 아니라, 즉시 그것들을 해방합니다. 데이타베이스의 자원을 점유 하는 것을 피하기 위해서
일반적으로 작업이 종료하자 마자 자원을 해방하도록의해 주세요.
이미
클로우즈 된 Statement 객체로 close 메서드를 호출하면, 조작은 행해지지 않습니다.
주: Statement객체는
가비지 컬렉트될 때는 자동적으로 클로우즈 됩니다. Statement 객체가 클로우즈 될 때, 그 현재의 ResultSet 객체가 존재하면, 그것도 클로우즈 됩니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
int getMaxFieldSize()
throws SQLException
Statement 객체에 의해 생성되는 ResultSet 객체의 문자 및 바이너리의 각 렬치에 대해 리턴된
최대 바이트수를 취득합니다. 이 제한치는 BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR 및 LONGVARCHAR
각 열에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setMaxFieldSize(int)
void setMaxFieldSize(int max)
throws SQLException
ResultSet 열에 대한 최대 바이트수의 제한치를, 지정된 바이트수로 설정합니다. 이 제한치는 BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR, LONGVARCHAR
각 필드에만 적용됩니다. 제한치를 넘은 데이터는 통지없이 파기됩니다. 이식성을 최대한으로 하려면,
256 보다 큰 값을 사용합니다.
max - 바이트 단위의 새로운 열사이즈의 제한치. 제로는 무제한을 미한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 max >= 0 이 채워지지 않은 경우getMaxFieldSize()
int getMaxRows()
throws SQLException
Statement 객체에 의해 생성되는 ResultSet 객체가 포함할 수 있는 최대의 행수를 취득합니다. 제한치를 넘은 행은 통지없이 제외됩니다.
Statement 객체에 의해 생성되는 ResultSet 객체의 현재의 최대행수. 제로는 무제한을 미한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setMaxRows(int)
void setMaxRows(int max)
throws SQLException
ResultSet 객체가 포함할 수 있는 최대행수의 제한치를, 지정된 수로 설정합니다. 제한치를 넘은 행은 통지없이 제외됩니다.
max - 새로운 최대행수의 제한치. 제로는 무제한을 미한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 max >= 0 이 채워지지 않은 경우getMaxRows()
void setEscapeProcessing(boolean enable)
throws SQLException
PreparedStatement 객체에 대한 이스케이프 처리를 무효로 해도 효과는 없습니다.
enable - 이스케이프 처리를 유효하게 하는 경우는 true, 무효로 하는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
int getQueryTimeout()
throws SQLException
Statement 객체의 실행을 기다리는 초수를 취득합니다. 이 시간을 경과하면, SQLException가 발생 됩니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setQueryTimeout(int)
void setQueryTimeout(int seconds)
throws SQLException
Statement 객체의 실행을 기다리는 초수를, 지정된 초수로 설정합니다. 이 시간을 경과하면, SQLException 이 발생 됩니다.
seconds - 새로운 쿼리타임 아웃의 제한치의 초수. 제로는 무제한을 미한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 seconds >= 0 이 채워지지 않은 경우getQueryTimeout()
void cancel()
throws SQLException
Statement 객체를 취소합니다. 이 메서드는 1개의 thread가 다른 thread에 의해 실행중의 문장을 취소하는데 사용할 수 있습니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
SQLWarning getWarnings()
throws SQLException
Statement 객체에 관한 호출에 의해 보고되는 최초의 경고를 취득합니다. 후속의 Statement 객체의 경고는 이 SQLWarning 객체에 체인 됩니다.
경고 체인은 문장이 (재) 실행될 때마다 자동적으로 클리어 됩니다. 이 메서드는 클로우즈 된 Statement 객체의 호출에는 사용하지 않습니다. 사용하면 SQLException가 발생 됩니다.
주: ResultSet 객체를 처리중의 경우, ResultSet 객체의 읽기에 관련된 경고는 그 객체를 생성한 Statement객체는 아니고 모두 ResultSet 객체에 체인 됩니다.
SQLWarning 객체. 경고가 없는 경우는 null
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메서드가 클로우즈 된 문장으로 불려 갔을 경우
void clearWarnings()
throws SQLException
Statement 객체에 관해서 보고된 모든 경고를 클리어 합니다. 이 메서드의 호출뒤, 이 Statement 객체에 대한 새로운 경고가 통지될 때까지, getWarnings 메서드는 null을
리턴합니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
void setCursorName(String name)
throws SQLException
Statement 객체의 execute 메서드에 의해 사용되는 SQL 커서명이 지정된 String로
설정합니다. 이 이름은 SQL 로 위치 결정 된 갱신문 또는 삭제문으로 사용되어 이 문장으로 생성된 ResultSet 객체내의 현재의 행을 식별할 수 있습니다. 데이타베이스가 위치 결정 된 갱신 또는 삭제를 지원
하고 있지 않는 경우, 이 메서드는 아무것도 실행하지 않습니다. 커서가 갱신을 지원하는 적절한 차단 레벨을 가지는 것이 보증되기 위해서는 커서의 SELECT 문은 SELECT FOR UPDATE 형식일 필요가 있습니다. FOR UPDATE가 존재하지 않는 경우, 위치 결정 된 갱신은 실패합니다.
주: 정의에의해 위치 결정 된 갱신 또는 삭제의 실행은 위치 결정에 사용중의 ResultSet 객체를 생성한 Statement 객체와는 다른 Statement 객체에 의해 실행될 필요가 있습니다. 게다가 커서명은 접속내에서 일의로 할 필요가 있습니다.
name - 새로운 커서명. 접속내에서 일의로 할 필요가 있다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
boolean execute(String sql)
throws SQLException
execute 메서드는 SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에
getResultSet 또는 getUpdateCount 메서드를 사용해 결과를 취득합니다. 그리고, getMoreResults에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.
sql - 임의의 SQL 문
ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우getResultSet(),
getUpdateCount(),
getMoreResults()
ResultSet getResultSet()
throws SQLException
ResultSet 객체로서 현재의 결과를 취득합니다. 이 메서드는 1개의 결과에 대해 1회
만 호출하지 않으면 안됩니다.
ResultSet 객체로서의 현재의 결과. 갱신 카운트인지, 또는 결과가 없는 경우는 null
SQLException - 데이타베이스 액세스 에러가 발생했을 경우execute(java.lang.String)
int getUpdateCount()
throws SQLException
ResultSet 객체인지, 또는 결과가 없는 경우는 -1을 리턴합니다. 이 메서드는 1개의 결과에 대해 1회
만 호출할 필요가 있습니다.
ResultSet 객체인지, 또는 결과가 없는 경우는 -1
SQLException - 데이타베이스 액세스 에러가 발생했을 경우execute(java.lang.String)
boolean getMoreResults()
throws SQLException
Statement 객체의 다음의 결과로 이동합니다. 이 결과가 ResultSet 객체의 경우는 true를 돌려주고, getResultSet 메서드로 얻을 수 있던 현재의 ResultSet 객체를 모두 암묵에 닫습니다.
다음에 해당하는 경우, 결과는 없습니다.
// stmt is a Statement object ((stmt.getMoreResults() == false) && (stmt.getUpdateCount() == -1))
ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우execute(java.lang.String)
void setFetchDirection(int direction)
throws SQLException
Statement 객체를 사용해 작성된 ResultSet 객체의 행이 처리될 방향에 대한 힌트를 드라이버에 제공합니다. 기본값는 ResultSet.FETCH_FORWARD 입니다.
이 메서드는 이 Statement 객체에 의해 생성되는 결과 세트의 디폴트의 페치 방향을 설정합니다. 각 결과 세트는 그것 자신의 페치 방향을 취득 및 설정하기 위한 독자적인 메서드를 가집니다.
direction - 행을 처리하는 초기 방향
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 방향이 ResultSet.FETCH_FORWARD, ResultSet.FETCH_REVERSE, 또는 ResultSet.FETCH_UNKNOWN
어떤 것도 아닌 경우getFetchDirection()
int getFetchDirection()
throws SQLException
Statement 객체로부터 생성된 결과 세트의 디폴트인, 데이타베이스 테이블에서 행을 페치 할 방향을 취득합니다. 이 Statement 객체가 setFetchDirection 메서드를 호출해 페치 방향을 설정하고 있지 않는 경우, 반환값은 구현에
의존합니다.
Statement 객체로부터 생성된 결과 세트의 디폴트의 페치 방향
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setFetchDirection(int)
void setFetchSize(int rows)
throws SQLException
rows - 페치 하는 행수
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 조건 0 <= rows <= this.getMaxRows()가 채워지지 않은 경우getFetchSize()
int getFetchSize()
throws SQLException
Statement 객체로부터 생성된 ResultSet 객체의 디폴트의 페치 사이즈인, 결과 세트의 행수를 취득합니다. 이 Statement 객체가 setFetchSize 메서드를 호출해 페치 사이즈를 설정하고 있지 않는 경우, 반환값은 구현에
의존합니다.
Statement 객체로부터 생성된 결과 세트의 디폴트의 페치 사이즈
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setFetchSize(int)
int getResultSetConcurrency()
throws SQLException
Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 병행성을 취득합니다.
ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
int getResultSetType()
throws SQLException
Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 형태를 취득합니다.
ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
void addBatch(String sql)
throws SQLException
Statement 객체의 현재의 커멘드의 리스트로 지정된 SQL 커멘드를 추가합니다. 이 리스트의 커멘드는 executeBatch 메서드를 호출하는 것으로 배값으로
실행할 수 있습니다.
주: 이 메서드는 옵션입니다.
sql - 보통
정적 SQL INSERT 문, 또는 UPDATE 문
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 드라이버가 배치 갱신을 지원
하고 있지 않는 경우executeBatch()
void clearBatch()
throws SQLException
Statement 객체의 현재의 SQL 커멘드 리스트를 비웁니다.
주: 이 메서드는 옵션입니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 드라이버가 배치 갱신을 지원
하고 있지 않는 경우addBatch(java.lang.String)
int[] executeBatch()
throws SQLException
int 요소는 배치내의 커멘드에 대응해 돌려주고지고 순서 붙일 수 있습니다. 즉, 배치에 추가된 순서에 따라 순서 붙일 수 있습니다. 메서드 executeBatch에 의해 리턴된
배열내의 요소는 다음의 어떤 것이나 1개에 해당합니다. SUCCESS_NO_INFO값 -- 커멘드가 정상적으로 처리되었지만, 영향을 받은 행수가 불명한 일을 나타낸다
배치 갱신내의 커멘드의 1개를 정상적으로 실행할 수 없었던 경우, 이 메서드는 BatchUpdateException을
Throw 해, JDBC 드라이버는 배치내의 나머지의 커멘드의 처리를 계속하는 일도, 중지할 수도 있습니다. 다만, 드라이버의 동작은 특정의 DBMS와
일관성을 유지할 필요가 있어, 항상 커멘드의 처리를 계속하든가 혹은 계속하지 않는가의 어딘가에 됩니다. 실패 후, 드라이버가 처리를 계속하는 경우는 BatchUpdateException.getUpdateCounts 메서드로 리턴된
배열에는 배치내의 커멘드와 같은 수의 요소가 포함되어 그러한 요소의 1개
이상이 다음에 해당합니다.
EXECUTE_FAILED값 -- 실패한 커멘드가 정상적으로 실행된 것을 나타내, 커멘드가 실패한 뒤에
드라이버가 커멘드의 처리를 계속했을 경우에 한정해 발생한다
드라이버는 이 메서드를 구현할 필요는 없습니다. Java 2 SDK, Standard Edition, 버전
1.3 에서는 사용할 수 있는 구현 및 반환값이 수정되어, BatchUpdateException 객체가 Throw 된 뒤에 배치 갱신내의 커멘드의 처리를 계속할 수 있는 옵션이 준비되어 있습니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 드라이버가 배치문을 지원
하지 않는 경우. 데이타베이스에 송신된 커멘드의 1개가 정상적으로 실행되지 않았던 경우나, 결과 세트를 돌려주려고 하면 BatchUpdateException (SQLException
서브 클래스)가 발생되는
Connection getConnection()
throws SQLException
Statement 객체를 생성한 Connection 객체를 취득합니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
boolean getMoreResults(int current)
throws SQLException
Statement 객체의 다음의 결과로 이동합니다. 지정된 플래그에 의해 지정된 명령에 따라 모든 현재의 ResultSet 객체를 처리해, 다음의 결과가 ResultSet 객체의 경우는 true를 리턴합니다.
다음에 해당하는 경우, 결과는 없습니다.
// stmt is a Statement object ((stmt.getMoreResults() == 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.CLOSE_CURRENT_RESULT, Statement.KEEP_CURRENT_RESULT, Statement.CLOSE_ALL_RESULTS
언젠가가 아닌 경우execute(java.lang.String)
ResultSet getGeneratedKeys()
throws SQLException
Statement 객체를 실행한 결과적으로 작성된 자동 생성 키를 취득합니다. 이 Statement 객체가 키를 생성하지 않았던 경우는 비어있는 ResultSet 객체가 리턴됩니다
.
Statement 객체의 실행으로 생성된 자동 생성 키를 포함한 ResultSet 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
int executeUpdate(String sql,
int autoGeneratedKeys)
throws SQLException
Statement 객체에 의해 생성된 자동 생성 키를 검색 가능하게 할지 어떨지에 임해서 지정된 플래그로 드라이버에 통지합니다.
sql - SQL INSERT 문, UPDATE 문, 또는 DELETE 문, 혹은 아무것도 돌려주지 않는 SQL 문이 아니면 안되는autoGeneratedKeys - 자동 생성 키가 검색 가능하게 될지 어떨지를 나타내는 플래그. 정수 Statement.RETURN_GENERATED_KEYS 또는 Statement.NO_GENERATED_KEYS
INSERT 문, UPDATE 문, DELETE 문의 경우는 행수. 아무것도 돌려주지 않는 SQL 문의 경우는 0
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 지정된 SQL 문이 ResultSet 객체를 돌려주는 경우, 또는 지정된 정수가 허가되어 있지 않은 경우
int executeUpdate(String sql,
int[] columnIndexes)
throws SQLException
INSERT 문이 아닌 경우, 드라이버는 그 배열을 무시합니다.
sql - SQL INSERT 문, UPDATE 문, 또는 DELETE 문, 혹은 SQL DDL 문과 같은 아무것도 돌려주지 않는 SQL 문columnIndexes - 삽입된 행으로부터 리턴된
열을 나타내는 열인덱스의 배열
INSERT 문, UPDATE 문, DELETE 문의 경우는 행수. 아무것도 돌려주지 않는 SQL 문의 경우는 0
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, SQL 문이 ResultSet 객체를 돌려주는 경우, 혹은 이 메서드의 제 2 인수로 지정된 값이 유효한 열인덱스를 요소에 가지는 int 배열이 아닌 경우
int executeUpdate(String sql,
String [] columnNames)
throws SQLException
INSERT 문이 아닌 경우, 드라이버는 그 배열을 무시합니다.
sql - SQL INSERT 문, UPDATE 문, 또는 DELETE 문, 혹은 아무것도 돌려주지 않는 SQL 문columnNames - 삽입된 행으로부터 리턴된
열의 이름의 배열
INSERT 문, UPDATE 문, DELETE 문의 경우는 행수. 아무것도 돌려주지 않는 SQL 문의 경우는 0
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, SQL 문이 ResultSet 객체를 돌려주는 경우, 혹은 이 메서드의 제 2 인수로 지정된 값이 유효한 렬명을 요소에 가지는 String 배열이 아닌 경우
boolean execute(String sql,
int autoGeneratedKeys)
throws SQLException
INSERT 문이 아닌 경우, 드라이버는 이 통지를 무시합니다.
몇개의 (보통이 아니다) 상황에서는 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있는 스토어드 프로시저를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로 이것을 무시할 수 있습니다.
execute 메서드는 SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에
getResultSet 또는 getUpdateCount 메서드를 사용해 결과를 취득합니다. 그리고, getMoreResults에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.
sql - 임의의 SQL 문autoGeneratedKeys - getGeneratedKeys 메서드를 사용해, 자동 생성 키를 검색 가능하게 할지 어떨지를 나타내는 정수. 정수 Statement.RETURN_GENERATED_KEYS 또는 Statement.NO_GENERATED_KEYS
ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 혹은 이 메서드의 제 2 인수로 지정된 값이 Statement.RETURN_GENERATED_KEYS 또는 Statement.NO_GENERATED_KEYS가 아닌 경우getResultSet(),
getUpdateCount(),
getMoreResults(),
getGeneratedKeys()
boolean execute(String sql,
int[] columnIndexes)
throws SQLException
INSERT 문이 아닌 경우, 드라이버는 그 배열을 무시합니다.
몇개의 (보통이 아니다) 상황에서는 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있는 스토어드 프로시저를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로 이것을 무시할 수 있습니다.
execute 메서드는 SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에
getResultSet 또는 getUpdateCount 메서드를 사용해 결과를 취득합니다. 그리고, getMoreResults에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.
sql - 임의의 SQL 문columnIndexes - getGeneratedKeys 메서드의 호출에 의해 검색 가능하게 되는 삽입행의 열인덱스의 배열
ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 혹은 이 메서드에게 건네진 int 배열의 요소가 유효한 열인덱스가 아닌 경우getResultSet(),
getUpdateCount(),
getMoreResults()
boolean execute(String sql,
String [] columnNames)
throws SQLException
INSERT 문이 아닌 경우, 드라이버는 그 배열을 무시합니다.
몇개의 (보통이 아니다) 상황에서는 단일의 SQL 문이 복수의 결과 세트 혹은 갱신 카운트를 돌려주는 일이 있습니다. 복수의 결과를 돌려주는 일이 있는 것을 알 수 있는 스토어드 프로시저를 실행중, 또는 미지의 SQL 캐릭터 라인을 동적으로 실행중이 아닌 한, 일반적으로 이것을 무시할 수 있습니다.
execute 메서드는 SQL 문을 실행해 최초의 결과의 형식을 나타냅니다. 다음에
getResultSet 또는 getUpdateCount 메서드를 사용해 결과를 취득합니다. 그리고, getMoreResults에 의해 계속 임의의 결과의 취득 (복수가능)으로 이동합니다.
sql - 임의의 SQL 문columnNames - getGeneratedKeys 메서드의 호출에 의해 검색 가능하게 되는 삽입행의 렬명의 배열
ResultSet 객체의 경우는 true. 갱신 카운트인지, 또는 결과가 없는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 혹은 이 메서드에게 건네진 String 배열의 요소가 유효한 렬명이 아닌 경우getResultSet(),
getUpdateCount(),
getMoreResults(),
getGeneratedKeys()
int getResultSetHoldability()
throws SQLException
Statement 객체로부터 생성된 ResultSet 객체의 결과 세트의 보관 유지 기능을 취득합니다.
ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.