|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: NESTED | 필드 | constructor | 메서드 | 상세: 필드 | constructor | 메서드 | |||||||||
public interface Connection
특정의 데이타베이스와의 접속 (세션)을 표현합니다. 접속의 컨텍스트 내에서 SQL 문이 실행되고 결과가 리턴됩니다 .
Connection 객체중의 데이타베이스는 테이블, 지원
하고 있는 SQL 문법, 스토어드 프로시저
및 이 접속의 능력 등에 대한 정보를 제공합니다. 이 정보는 getMetaData 메서드로 취득할 수 있습니다.
주: 각 문을 실행 후, 디폴트에서는 Connection객체는 자동 위탁 모드가 되어, 자동적으로 변경을 위탁합니다. 자동 위탁 모드가 무효로 되고 있는 경우, 변경을 위탁하려면 메서드 commit를 명시적으로 호출할 필요가 있습니다. 그렇게 하지 않으면 데이타베이스의 변경은 보존되지 않습니다.
JDBC 2.1 코어 API를 사용해 생성된 새로운 Connection 객체에는 이 객체에 관련하는 초기 상태가 비어있는 형태 맵이 있습니다. 사용자는 이 형태 맵의 UDT에 커스텀 매핑을 입력할 수 있습니다. 메서드 ResultSet.getObject에 의해 데이터 소스로부터 UDT가 취득되면, getObject 메서드는 접속의 형태 맵을 체크해, 그 UDT에 엔트리가 있을지 어떨지를 조사합니다. 엔트리가 있는 경우, getObject 메서드는 지시받은 클래스에 UDT를 매핑 합니다. 엔트리가 없는 경우, UDT는 표준 매핑을 사용해 매핑 됩니다.
사용자는 java.util.Map 객체가 되는 새로운 형태 맵을 작성해, 거기에 엔트리를 작성해, 커스텀 매핑을 실행할 수 있는 java.sql 메서드에 그 엔트리를 건네줄 수가 있습니다. 이 경우
메서드는 접속에 관련한 형태 맵은 아니고 지정된 형태 맵을 사용합니다.
예를 들어
다음의 코드 fragment는 SQL 형 ATHLETES가 Java 프로그램 언어의 클래스 Athletes에 매핑 되는 것을 지정합니다. 코드 fragment는 Connection 객체 con
형태 맵을 취득해, 거기에 엔트리를 삽입해, 그 새로운 엔트리로 그 형태 맵을 접속의 형태 맵으로서 설정합니다.
java.util.Map map = con.getTypeMap();
map.put("mySchemaName.ATHLETES", Class.forName("Athletes"));
con.setTypeMap(map);
DriverManager.getConnection(java.lang.String, java.util.Properties),
Statement,
ResultSet,
DatabaseMetaData | 필드 개요 | |
|---|---|
static int |
TRANSACTION_NONE
트랜잭션(transaction)가 지원 되어 있지 않은 것을 나타내는 정수입니다. |
static int |
TRANSACTION_READ_COMMITTED
더티 read는 억제되어 반복 불가의 read 및 팬텀 read가 일어나는 것을 나타내는 정수입니다. |
static int |
TRANSACTION_READ_UNCOMMITTED
더티 읽기, 반복 불가의 읽기 및 팬텀 read가 일어나는 것을 나타내는 정수입니다. |
static int |
TRANSACTION_REPEATABLE_READ
더티 read 및 반복해 불가의 read는 억제되어 팬텀 read가 일어나는 것을 나타내는 정수입니다. |
static int |
TRANSACTION_SERIALIZABLE
더티 읽기, 반복 불가의 읽기 및 팬텀 read가 억제되는 것을 나타내는 정수입니다. |
| 메서드 개요 | |
|---|---|
void |
clearWarnings ()
이 Connection 객체에 관해서 통지된 모든 경고를 클리어 합니다. |
void |
close ()
자동적인 해제를 기다리지 않고, 즉시 이 Connection 객체의 데이타베이스와 JDBC 자원을 해제합니다. |
void |
commit ()
직전의 위탁/롤백(rollback) 이후에 행해진 변경을 모두 유효로 해, 이 Connection 객체가 현재 보관 유지하는 데이타베이스 락을 모두 해제합니다. |
Statement |
createStatement ()
SQL 문을 데이타베이스에 보내기 위한 Statement 객체를 생성합니다. |
Statement |
createStatement (int resultSetType,
int resultSetConcurrency)
지정된 형태와 concurrent processing로 ResultSet 객체를 생성하는 Statement 객체를 생성합니다. |
Statement |
createStatement (int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
지정된 형태, concurrent processing 및 holdability 로 ResultSet 객체를 생성하는 Statement 객체를 생성합니다. |
boolean |
getAutoCommit ()
이 Connection 객체의 현재의 자동 위탁 모드를 취득합니다. |
String |
getCatalog ()
이 Connection 객체의 현재의 카탈로그명을 취득합니다. |
int |
getHoldability ()
이 Connection 객체를 사용해 생성된 ResultSet 객체의 현재의 보관 유지 기능을 취득합니다. |
DatabaseMetaData |
getMetaData ()
이 Connection 객체가 접속을 나타내는 데이타베이스에 관한 메타데이타를 포함하는 DatabaseMetaData 객체를 취득합니다. |
int |
getTransactionIsolation ()
이 Connection 객체의 현재의 트랜잭션(transaction) 차단 레벨을 취득합니다. |
Map <String,
Class <? >> |
getTypeMap ()
이 Connection에 관련한 Map 객체를 취득합니다. |
SQLWarning |
getWarnings ()
이 Connection 객체에 관한 호출에 의해 보고되는 최초의 경고를 취득합니다. |
boolean |
isClosed ()
이 Connection 객체가 클로우즈 되고 있는지를 취득합니다. |
boolean |
isReadOnly ()
이 Connection 객체가 읽기 전용
모드인가 어떤가를 취득합니다. |
String |
nativeSQL (String sql)
지정된 SQL 문을 시스템의 본래의 SQL 문법으로 변환합니다. |
CallableStatement |
prepareCall (String sql)
데이타베이스의 스토어드 프로시저를 호출하기 위한 CallableStatement 객체를 생성합니다. |
CallableStatement |
prepareCall (String sql,
int resultSetType,
int resultSetConcurrency)
지정된 형태와 concurrent processing로 ResultSet 객체를 생성하는 CallableStatement 객체를 생성합니다. |
CallableStatement |
prepareCall (String sql,
int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
지정된 형태와 concurrent processing로 ResultSet 객체를 생성하는 CallableStatement 객체를 생성합니다. |
PreparedStatement |
prepareStatement (String sql)
파라미터 첨부 SQL 문을 데이타베이스에 보내기 위한 PreparedStatement 객체를 작성합니다. |
PreparedStatement |
prepareStatement (String sql,
int autoGeneratedKeys)
자동 생성 키를 얻는 기능을 가지는 디폴트의 PreparedStatement 객체를 생성합니다. |
PreparedStatement |
prepareStatement (String sql,
int[] columnIndexes)
지정된 배열에 의해 지정된 자동 생성 키를 돌려주는 기능을 가지는 디폴트의 PreparedStatement 객체를 생성합니다. |
PreparedStatement |
prepareStatement (String sql,
int resultSetType,
int resultSetConcurrency)
지정된 형태와 concurrent processing로 ResultSet 객체를 생성하는 PreparedStatement 객체를 생성합니다. |
PreparedStatement |
prepareStatement (String sql,
int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
지정된 형태, concurrent processing 및 보관 유지 기능으로 ResultSet 객체를 생성하는 PreparedStatement 객체를 생성합니다. |
PreparedStatement |
prepareStatement (String sql,
String [] columnNames)
지정된 배열에 의해 지정된 자동 생성 키를 돌려주는 기능을 가지는 디폴트의 PreparedStatement 객체를 생성합니다. |
void |
releaseSavepoint (Savepoint savepoint)
현재의 트랜잭션(transaction)로부터 지정된 Savepoint 객체를 삭제합니다. |
void |
rollback ()
현재의 트랜잭션(transaction)로 행해진 변경을 모두 바탕으로 되돌려, 이 Connection 객체가 현재 보관 유지하는 데이타베이스 락을 모두 해제합니다. |
void |
rollback (Savepoint savepoint)
지정된 Savepoint 객체가 설정된 뒤에 행해진 모든 변경을 바탕으로 되돌립니다. |
void |
setAutoCommit (boolean autoCommit)
이 접속의 자동 위탁 모드가 지정된 상태로 설정합니다. |
void |
setCatalog (String catalog)
이 Connection 객체의 데이타베이스에 작업을 위한 서브 스페이스를 선택하기 위해서
카탈로그명을 설정합니다. |
void |
setHoldability (int holdability)
이 Connection 객체를 사용해 생성된 ResultSet 객체의 보관 유지 기능이 지정된 보관 유지 기능에 변경합니다. |
void |
setReadOnly (boolean readOnly)
이 Connection를 읽기 전용 모드로 설정해, 데이타베이스 최적화를 실행하는 드라이버의 힌트로 합니다. |
Savepoint |
setSavepoint ()
현재의 트랜잭션(transaction)로 이름이 없는 세이브 포인트를 작성해, 그것을 나타내는 새로운 Savepoint 객체를 리턴합니다. |
Savepoint |
setSavepoint (String name)
현재의 트랜잭션(transaction)로 지정된 이름의 세이브 포인트를 작성해, 그것을 나타내는 새로운 Savepoint 객체를 리턴합니다. |
void |
setTransactionIsolation (int level)
이 Connection
트랜잭션(transaction) 차단 레벨이 지정된 것으로 변경하는 것을 시도합니다. |
void |
setTypeMap (Map <String,
Class <? >> map)
이 Connection 객체의 형태 맵으로서 지정된 TypeMap 객체를 인스톨 합니다. |
| 필드의 상세 |
|---|
static final int TRANSACTION_NONE
static final int TRANSACTION_READ_UNCOMMITTED
static final int TRANSACTION_READ_COMMITTED
static final int TRANSACTION_REPEATABLE_READ
static final int TRANSACTION_SERIALIZABLE
TRANSACTION_REPEATABLE_READ에
서의 금지에 더해1개의 트랜잭션(transaction)가 WHERE 조건을 채우는 모든 행을 읽어내, 2번째의 트랜잭션(transaction)가 WHERE 조건을 채우는 행을 삽입한 뒤에
최초의 트랜잭션(transaction)가 동일한 조건으로 읽기
다시 했을 경우에
2번째의 read에서는 추가된 「팬텀」행을 꺼낸다고 하는 상황이 금지됩니다.
| 메서드의 상세 |
|---|
Statement createStatement()
throws SQLException
Statement 객체를 생성합니다. 파라미터 없음의 SQL 문은 보통, Statement 객체를 사용해 실행됩니다. 같은 SQL 문이 여러번 실행되는 경우는 PreparedStatement 객체를 사용하는 (분)편이 효율적입니다.
리턴된
Statement 객체를 사용해 작성된 결과 세트는 디폴트에서는 TYPE_FORWARD_ONLY
형태로CONCUR_READ_ONLY
concurrent processing 레벨을 가집니다.
Statement 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
PreparedStatement prepareStatement(String sql)
throws SQLException
PreparedStatement 객체를 작성합니다.
IN 파라미터 붙어 또는 IN 파라미터 없음의 SQL 문은 프리컴파일 해, PreparedStatement 객체에 포함할 수 있습니다. 따라서, 이 객체는 이 문장을 여러 차례, 효율적으로 실행하는데 사용할 수 있습니다.
주: 이 메서드는 프리컴파일이 효과가 있는 파라미터 첨부 SQL 문을 처리하기 위해서 최적화되고 있습니다. 드라이버가 프리컴파일을 지원
하고 있는 경우, prepareStatement 메서드는 그 문장을 프리컴파일용으로서 데이타베이스에 보냅니다. 드라이버에 따라서는 프리컴파일을 지원
하고 있지 않는 것이 있습니다. 이 경우
PreparedStatement이 실행될 때까지, 문장은 데이타베이스에 보내지지 않습니다. 이것은 사용자에 게 직접적인 영향은 없습니다만, 어느 메서드가 어느 SQLException 객체를 Throw 했는지를 관계해 영향이 있습니다.
리턴된
PreparedStatement 객체를 사용해 작성된 결과 세트는 디폴트에서는 TYPE_FORWARD_ONLY
형태로CONCUR_READ_ONLY
concurrent processing 레벨을 가집니다.
sql - 1개
이상의 '? ' IN 파라미터 플레이스홀더-를 포함할 수 있는 SQL 문
PreparedStatement 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
CallableStatement prepareCall(String sql)
throws SQLException
CallableStatement 객체를 생성합니다. CallableStatement객체는
그 IN와
OUT 파라미터를 설정하는 메서드와 스토어드 프로시저
의 호출을 실행하는 메서드를 제공합니다.
주: 이 메서드는 스토어드 프로시저
호출문을 처리하기 위해서 최적화되고 있습니다. 드라이버에 따라서는 prepareCall 메서드가 실행될 때 데이타베이스에 호출해 문장을 보내는 것이 있습니다. 그 외의 드라이버는 CallableStatement 객체가 실행될 때까지 기다립니다. 이것은 사용자에 게 직접적인 영향은 없습니다만, 어느 메서드가 어느 SQLException을
Throw 했는지를 관계해 영향이 있습니다.
리턴된
CallableStatement 객체를 사용해 작성된 결과 세트는 디폴트에서는 TYPE_FORWARD_ONLY
형태로CONCUR_READ_ONLY
concurrent processing 레벨을 가집니다.
sql - 1개
이상의 '? '파라미터 플레이스홀더-를 포함할 수 있는 SQL 문. 보통
이 문장은 JBDC 함수 호출의 이스케이프 캐릭터 라인이다
CallableStatement 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
String nativeSQL(String sql)
throws SQLException
sql - 1개
이상의 '? '파라미터 플레이스홀더-를 포함할 수 있는 SQL 문
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
void setAutoCommit(boolean autoCommit)
throws SQLException
commit 메서드 또는 rollback 메서드에의 호출에 의해 종료되는 트랜잭션(transaction)에 그룹화 됩니다. 디폴트에서는 새로운 접속은 자동 위탁 모드입니다.
위탁은 문장의 완료 또는 다음의 실행의 발원시어느 쪽이 먼저 일어나도 발생합니다. 문장이, ResultSet 객체를 돌려주는 경우에는 ResultSet 객체의 마지막 행이 꺼내질까 클로우즈 되었을 때에 문장은 완료합니다. 진행된 용법에서는 단일의 문장이 출력 파라미터와 같게, 복수의 결과를 돌려주는 일도 있습니다. 이 경우는 모든 결과와 출력 파라미터값이 꺼내졌을 때에 위탁이 발생합니다.
주: 트랜잭션(transaction)의 도중에 이 메서드가 불려가 면, 그 트랜잭션(transaction)는 위탁됩니다.
autoCommit - 자동 위탁 모드를 유효하게 하는 경우는 true, 무효로 하는 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우getAutoCommit()
boolean getAutoCommit()
throws SQLException
Connection 객체의 현재의 자동 위탁 모드를 취득합니다.
Connection 객체의 현재의 자동 위탁 모드 상태
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setAutoCommit(boolean)
void commit()
throws SQLException
Connection 객체가 현재 보관 유지하는 데이타베이스 락을 모두 해제합니다. 이 메서드는 자동 위탁 모드가 무효로 되고 있을 때 마셔 사용합니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 Connection 객체가 자동 위탁 모드인 경우setAutoCommit(boolean)
void rollback()
throws SQLException
Connection 객체가 현재 보관 유지하는 데이타베이스 락을 모두 해제합니다. 이 메서드는 자동 위탁 모드가 무효로 되고 있을 때 마셔 사용합니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 Connection 객체가 자동 위탁 모드인 경우setAutoCommit(boolean)
void close()
throws SQLException
Connection 객체의 데이타베이스와 JDBC 자원을 해제합니다.
이미
클로우즈 된 Connection 객체로 close 메서드를 호출하면, 조작은 행해지지 않습니다.
주: Connection객체는
가비지 컬렉트될 때 자동적으로 클로우즈 됩니다. 특정의 치명적 에러의 경우도, Connection객체는 클로우즈 됩니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
boolean isClosed()
throws SQLException
Connection 객체가 클로우즈 되고 있는지를 취득합니다. 접속은, close 메서드가 호출되는지, 특정의 치명적 에러가 발생했을 경우에 클로우즈 됩니다. 이 메서드는 Connection.close 메서드가 불려 간 뒤에 불려 갔을 경우에만 true를 돌려주는 것이 보증되고 있습니다.
이 메서드는 보통, 데이타베이스에의 접속이 유효한가 무효인지를 판정하기 위해서 호출할 수 없습니다. 일반의 클라이언트에서는 조작을 실행했을 때에 발생되는 예외를 캐치 하는 것으로써, 접속이 무효이라고 판정합니다.
Connection 객체가 클로우즈 되고 있는 경우는 true, 아직 오픈 상태의 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
DatabaseMetaData getMetaData()
throws SQLException
Connection 객체가 접속을 나타내는 데이타베이스에 관한 메타데이타를 포함하는 DatabaseMetaData 객체를 취득합니다. 메타데이타는 데이타베이스의 테이블, 지원
하고 있는 SQL 문법, 스토어드 프로시저
및 이 접속의 능력 등에 대한 정보를 포함하고 있습니다.
Connection 객체에 대한 DatabaseMetaData 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
void setReadOnly(boolean readOnly)
throws SQLException
주: 트랜잭션(transaction)의 도중에는 이 메서드를 호출할 수 없습니다.
readOnly - true인 경우는 읽기 전용
모드를 사용 가능하게 해, false인 경우는 사용 불가로 한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메서드가 트랜잭션(transaction)의 도중에 불려 갔을 경우
boolean isReadOnly()
throws SQLException
Connection 객체가 읽기 전용
모드인가 어떤가를 취득합니다.
Connection 객체가 읽기 전용
모드의 경우는 true, 그렇지 않은 경우는 false
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
void setCatalog(String catalog)
throws SQLException
Connection 객체의 데이타베이스에 작업을 위한 서브 스페이스를 선택하기 위해서
카탈로그명을 설정합니다.
드라이버가 카탈로그를 지원 하고 있지 않는 경우는 이 요구를 무시합니다.
catalog - 작업을 위한 카탈로그명. 카탈로그는 이 Connection 객체의 데이타베이스의 서브 스페이스
SQLException - 데이타베이스 액세스 에러가 발생했을 경우getCatalog()
String getCatalog()
throws SQLException
Connection 객체의 현재의 카탈로그명을 취득합니다.
null
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setCatalog(java.lang.String)
void setTransactionIsolation(int level)
throws SQLException
Connection
트랜잭션(transaction) 차단 레벨이 지정된 것으로 변경하는 것을 시도합니다. 지정할 수 있는 트랜잭션(transaction) 차단 레벨의 정수는 Connection인터페이스로 정의되고 있습니다.
주: 트랜잭션(transaction)의 도중에 이 메서드가 불려가 면, 그 결과는 구현으로 정의된 것이 됩니다.
level - 다음의 Connection 정수중 1개. Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, 또는 Connection.TRANSACTION_SERIALIZABLE. (Connection.TRANSACTION_NONE는 트랜잭션(transaction)가 지원
되어 있지 않은 것을 지정하므로 사용할 수 없다)
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 Connection 정수의 어떤 것도 아닌 경우DatabaseMetaData.supportsTransactionIsolationLevel(int),
getTransactionIsolation()
int getTransactionIsolation()
throws SQLException
Connection 객체의 현재의 트랜잭션(transaction) 차단 레벨을 취득합니다.
Connection.TRANSACTION_READ_UNCOMMITTED, Connection.TRANSACTION_READ_COMMITTED, Connection.TRANSACTION_REPEATABLE_READ, Connection.TRANSACTION_SERIALIZABLE, 또는 Connection.TRANSACTION_NONE
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setTransactionIsolation(int)
SQLWarning getWarnings()
throws SQLException
Connection 객체에 관한 호출에 의해 보고되는 최초의 경고를 취득합니다. 2개
이상의 경고가 있는 경우, 후속의 경고는 최초의 경고에 체인 되어 직전에 취득된 경고의 SQLWarning.getNextWarning 메서드를 호출하는 것에 의해 취득됩니다.
이 메서드는 클로우즈 된 접속의 호출에는 사용하지 않습니다. 사용하면SQLException가 발생 됩니다.
주: 계속하는 경고는 이 SQLWarning에 체인 됩니다.
SQLWarning 객체. 없는 경우는 null
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 이 메서드가 클로우즈 된 접속에 대해 불려 갔을 경우SQLWarning
void clearWarnings()
throws SQLException
Connection 객체에 관해서 통지된 모든 경고를 클리어 합니다. 이 메서드를 호출한뒤 이 Connection 객체에 대한 새로운 경고가 통지될 때까지, getWarnings는 null을
리턴합니다.
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
Statement createStatement(int resultSetType,
int resultSetConcurrency)
throws SQLException
ResultSet 객체를 생성하는 Statement 객체를 생성합니다. 이 메서드는 상기의 createStatement 메서드와 같습니다만, 디폴트의 결과 세트의 형태 및 concurrent processing를 오버라이드(override) 할 수 있습니다.
resultSetType - 결과 세트의 형태. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
resultSetConcurrency - concurrent processing의 종류. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE
ResultSet 객체를 생성하는 새로운 Statement 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 형태 및 concurrent processing를 나타내는 ResultSet 정수가 아닌 경우
PreparedStatement prepareStatement(String sql,
int resultSetType,
int resultSetConcurrency)
throws SQLException
ResultSet 객체를 생성하는 PreparedStatement 객체를 생성합니다. 이 메서드는 상기의 prepareStatement 메서드와 같습니다만, 디폴트의 결과 세트의 형태 및 concurrent processing를 오버라이드(override) 할 수 있습니다.
sql - SQL 문이 데이타베이스에 보내지는 String 객체. 1개
이상의 ? IN 파라미터를 포함할 수 있는 resultSetType - 결과 세트의 형태. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
resultSetConcurrency - concurrent processing의 종류. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE
PreparedStatement 객체. 지정된 형태 및 concurrent processing로 ResultSet 객체를 생성한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 형태 및 concurrent processing를 나타내는 ResultSet 정수가 아닌 경우
CallableStatement prepareCall(String sql,
int resultSetType,
int resultSetConcurrency)
throws SQLException
ResultSet 객체를 생성하는 CallableStatement 객체를 생성합니다. 이 메서드는 상기의 prepareCall 메서드와 같습니다만, 디폴트의 결과 세트의 형태 및 concurrent processing를 오버라이드(override) 할 수 있습니다.
sql - SQL 문이 데이타베이스에 보내지는 String 객체. 1개
이상의 ? 파라미터를 포함할 수 있는 resultSetType - 결과 세트의 형태. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
resultSetConcurrency - concurrent processing의 종류. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLE
CallableStatement 객체. 지정된 형태 및 concurrent processing로 ResultSet 객체를 생성한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 형태 및 concurrent processing를 나타내는 ResultSet 정수가 아닌 경우
Map <String,
Class <? >> getTypeMap()
throws SQLException
Connection에 관련한 Map 객체를 취득합니다. 어플리케이션이 엔트리를 추가하고 있지 않는 한, 비어있는 맵이 리턴됩니다
.
Connection 객체에 관련한 java.util.Map 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setTypeMap(java.util.Map>)
void setTypeMap(Map <String,
Class <? >> map)
throws SQLException
Connection 객체의 형태 맵으로서 지정된 TypeMap 객체를 인스톨 합니다. 형태 맵은 SQL 구조화형 및 개별의 형태의 커스텀 매핑에 사용됩니다.
map - 이 Connection 객체의 디폴트의 형태 맵의 대신으로서 인스톨 하는 java.util.Map 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 java.util.Map가 아닌 경우getTypeMap()
void setHoldability(int holdability)
throws SQLException
Connection 객체를 사용해 생성된 ResultSet 객체의 보관 유지 기능이 지정된 보관 유지 기능에 변경합니다.
holdability - ResultSet
보관 유지 기능 정수. ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 지정된 파라미터가 보관 유지 기능을 나타내는 ResultSet 정수가 아닌 경우, 또는 지정된 보관 유지 기능이 지원
되어 있지 않은 경우getHoldability(),
ResultSet
int getHoldability()
throws SQLException
Connection 객체를 사용해 생성된 ResultSet 객체의 현재의 보관 유지 기능을 취득합니다.
ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT
SQLException - 데이타베이스 액세스 에러가 발생했을 경우setHoldability(int),
ResultSet
Savepoint setSavepoint()
throws SQLException
Savepoint 객체를 리턴합니다.
Savepoint 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 현재 이 Connection 객체가 자동 위탁 모드인 경우Savepoint
Savepoint setSavepoint(String name)
throws SQLException
Savepoint 객체를 리턴합니다.
name - 세이브 포인트의 이름을 포함하는 String
Savepoint 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 현재 이 Connection 객체가 자동 위탁 모드인 경우Savepoint
void rollback(Savepoint savepoint)
throws SQLException
Savepoint 객체가 설정된 뒤에 행해진 모든 변경을 바탕으로 되돌립니다.
이 메서드는 자동 위탁이 무효 때에만 사용합니다.
savepoint - 롤백(rollback) 하는 Savepoint 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, Savepoint 객체가 유효하지 않게 되었을 경우, 또는 현재 이 Connection 객체가 자동 위탁 모드인 경우Savepoint,
rollback()
void releaseSavepoint(Savepoint savepoint)
throws SQLException
Savepoint 객체를 삭제합니다. 삭제된 후에 세이브 포인트를 참조하면 SQLException가 발생 됩니다.
savepoint - 삭제되는 Savepoint 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 Savepoint 객체가 현재의 트랜잭션(transaction)로 유효한 세이브 포인트가 아닌 경우
Statement createStatement(int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
throws SQLException
ResultSet 객체를 생성하는 Statement 객체를 생성합니다. 이 메서드는 상기의 createStatement 메서드와 같습니다만, 디폴트의 결과 세트의 형태, concurrent processing 및 보관 유지 기능을 오버라이드(override) 할 수 있습니다.
resultSetType - ResultSet 정수. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
resultSetConcurrency - ResultSet 정수. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLEresultSetHoldability - ResultSet 정수. ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT
ResultSet 객체를 생성하는 새로운 Statement 객체
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 형태, concurrent processing 및 보관 유지 기능을 나타내는 ResultSet 정수가 아닌 경우ResultSet
PreparedStatement prepareStatement(String sql,
int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
throws SQLException
ResultSet 객체를 생성하는 PreparedStatement 객체를 생성합니다.
이 메서드는 상기의 prepareStatement 메서드와 같습니다만, 디폴트의 결과 세트의 형태, concurrent processing 및 보관 유지 기능을 오버라이드(override) 할 수 있습니다.
sql - SQL 문이 데이타베이스에 보내지는 String 객체. 1개
이상의 ? IN 파라미터를 포함할 수 있는 resultSetType - ResultSet 정수. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
resultSetConcurrency - ResultSet 정수. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLEresultSetHoldability - ResultSet 정수. ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT
PreparedStatement 객체. 지정된 형태, concurrent processing 및 보관 유지 기능으로 ResultSet 객체를 생성한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 형태, concurrent processing 및 보관 유지 기능을 나타내는 ResultSet 정수가 아닌 경우ResultSet
CallableStatement prepareCall(String sql,
int resultSetType,
int resultSetConcurrency,
int resultSetHoldability)
throws SQLException
ResultSet 객체를 생성하는 CallableStatement 객체를 생성합니다. 이 메서드는 상기의 prepareCall 메서드와 같습니다만, 디폴트의 결과 세트의 형태, 결과 세트의 concurrent processing의 종류 및 보관 유지 기능을 오버라이드(override) 할 수 있습니다.
sql - SQL 문이 데이타베이스에 보내지는 String 객체. 1개
이상의 ? 파라미터를 포함할 수 있는 resultSetType - ResultSet 정수. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, 또는 ResultSet.TYPE_SCROLL_SENSITIVE 가운데 1개
resultSetConcurrency - ResultSet 정수. ResultSet.CONCUR_READ_ONLY 또는 ResultSet.CONCUR_UPDATABLEresultSetHoldability - ResultSet 정수. ResultSet.HOLD_CURSORS_OVER_COMMIT 또는 ResultSet.CLOSE_CURSORS_AT_COMMIT
CallableStatement 객체. 지정된 형태, concurrent processing 및 보관 유지 기능으로 ResultSet 객체를 생성한다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 형태, concurrent processing 및 보관 유지 기능을 나타내는 ResultSet 정수가 아닌 경우ResultSet
PreparedStatement prepareStatement(String sql,
int autoGeneratedKeys)
throws SQLException
PreparedStatement 객체를 생성합니다. 지정된 정수에의해 드라이버가 자동 생성 키를 취득 가능하게 할지 어떨지가 지정됩니다. SQL 문이 INSERT 문이 아닌 경우, 이 파라미터는 무시됩니다.
주: 이 메서드는 프리컴파일이 효과가 있는 파라미터 첨부 SQL 문을 처리하기 위해서 최적화되고 있습니다. 드라이버가 프리컴파일을 지원
하고 있는 경우, prepareStatement 메서드는 그 문장을 프리컴파일용으로서 데이타베이스에 보냅니다. 드라이버에 따라서는 프리컴파일을 지원
하고 있지 않는 것이 있습니다. 이 경우
PreparedStatement이 실행될 때까지, 문장은 데이타베이스에 보내지지 않습니다. 이것은 사용자에 게 직접적인 영향은 없습니다만, 어느 메서드가 어느 SQLException을
Throw 했는지를 관계해 영향이 있습니다.
리턴된
PreparedStatement 객체를 사용해 작성된 결과 세트는 디폴트에서는 TYPE_FORWARD_ONLY
형태로CONCUR_READ_ONLY
concurrent processing 레벨을 가집니다.
sql - 1개
이상의 '? ' IN 파라미터 플레이스홀더-를 포함할 수 있는 SQL 문autoGeneratedKeys - 자동 생성 키를 돌려줄지 어떨지를 나타내는 플래그. Statement.RETURN_GENERATED_KEYS 또는 Statement.NO_GENERATED_KEYS
PreparedStatement 객체. 자동 생성 키를 돌려주는 기능을 가진다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우, 또는 지정된 파라미터가 자동 생성 키를 돌려줄지 어떨지를 나타내는 Statement 정수가 아닌 경우
PreparedStatement prepareStatement(String sql,
int[] columnIndexes)
throws SQLException
PreparedStatement 객체를 생성합니다. 이 배열은 사용 가능하게 되는 자동 생성 키를 포함한 타겟 테이블의 열의 인덱스를 포함합니다. SQL 문이 INSERT 문이 아닌 경우, 이 배열은 무시됩니다.
IN 파라미터 붙어 또는 IN 파라미터 없음의 SQL 문은 프리컴파일 해, PreparedStatement 객체에 포함할 수 있습니다. 따라서, 이 객체는 이 문장을 여러 차례, 효율적으로 실행하는데 사용할 수 있습니다.
주: 이 메서드는 프리컴파일이 효과가 있는 파라미터 첨부 SQL 문을 처리하기 위해서 최적화되고 있습니다. 드라이버가 프리컴파일을 지원
하고 있는 경우, prepareStatement 메서드는 그 문장을 프리컴파일용으로서 데이타베이스에 보냅니다. 드라이버에 따라서는 프리컴파일을 지원
하고 있지 않는 것이 있습니다. 이 경우
PreparedStatement이 실행될 때까지, 문장은 데이타베이스에 보내지지 않습니다. 이것은 사용자에 게 직접적인 영향은 없습니다만, 어느 메서드가 어느 SQLException을
Throw 했는지를 관계해 영향이 있습니다.
리턴된
PreparedStatement 객체를 사용해 작성된 결과 세트는 디폴트에서는 TYPE_FORWARD_ONLY
형태로CONCUR_READ_ONLY
concurrent processing 레벨을 가집니다.
sql - 1개
이상의 '? ' IN 파라미터 플레이스홀더-를 포함할 수 있는 SQL 문columnIndexes - 삽입된 행으로부터 리턴된
열을 나타내는 열인덱스의 배열
PreparedStatement 객체. 지정된 열인덱스의 배열에 의해 지정되는 자동 생성 키를 돌려주는 기능을 가진다
SQLException - 데이타베이스 액세스 에러가 발생했을 경우
PreparedStatement prepareStatement(String sql,
String [] columnNames)
throws SQLException
PreparedStatement 객체를 생성합니다. 이 배열은 리턴된
자동 생성 키를 포함한 타겟 테이블의 열의 이름을 포함합니다. SQL 문이 INSERT 문이 아닌 경우, 이 배열은 무시됩니다.
IN 파라미터 붙어 또는 IN 파라미터 없음의 SQL 문은 프리컴파일 해, PreparedStatement 객체에 포함할 수 있습니다. 따라서, 이 객체는 이 문장을 여러 차례, 효율적으로 실행하는데 사용할 수 있습니다.
주: 이 메서드는 프리컴파일이 효과가 있는 파라미터 첨부 SQL 문을 처리하기 위해서 최적화되고 있습니다. 드라이버가 프리컴파일을 지원
하고 있는 경우, prepareStatement 메서드는 그 문장을 프리컴파일용으로서 데이타베이스에 보냅니다. 드라이버에 따라서는 프리컴파일을 지원
하고 있지 않는 것이 있습니다. 이 경우
PreparedStatement이 실행될 때까지, 문장은 데이타베이스에 보내지지 않습니다. 이것은 사용자에 게 직접적인 영향은 없습니다만, 어느 메서드가 어느 SQLException을
Throw 했는지를 관계해 영향이 있습니다.
리턴된
PreparedStatement 객체를 사용해 작성된 결과 세트는 디폴트에서는 TYPE_FORWARD_ONLY
형태로CONCUR_READ_ONLY
concurrent processing 레벨을 가집니다.
sql - 1개
이상의 '? ' IN 파라미터 플레이스홀더-를 포함할 수 있는 SQL 문columnNames - 삽입된 행으로부터 리턴된
열을 나타내는 렬명의 배열
PreparedStatement 객체. 지정된 렬명의 배열에 의해 지정되는 자동 생성 키를 돌려주는 기능을 가진다
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 도 참조하십시오.