GOLDILOCKS JDBC 개요

GOLDILOCKS JDBC 소개

GOLDILOCKS는 TCP/ IP 연결을 기반으로 한 표준 JDBC 4.0을 준수 (일부 기능 제외)하는 GOLDILOCKS JDBC 드라이버를 제공한다. 사용자는 GOLDILOCKS JDBC 드라이버를 이용하여 Java 프로그램 내에서 GOLDILOCKS와 접속하여 각종 트랜잭션 기능 및 데이터 조회 기능을 사용할 수 있다. GOLDILOCKS JDBC 드라이버는 JDK 1.6 기반으로 작성되고 구축되었기 때문에 JDBC 4.0의 기능을 지원한다. $GOLDILOCKS_HOME/lib/goldilocks6.jar 파일을 class path에 추가하여 드라이버를 사용할 수 있다.

goldilocks 다음의 숫자는 JDK 버전을 의미한다. 자세한 내용은 버전 및 지원 여부를 참조한다.

GOLDILOCKS JDBC는 JDBC 표준 스펙을 대부분 준수하고 있으며 일부 고유한 기능을 제공하기 위해 표준 API가 아닌 method와 클래스도 지원한다. 비표준 method에 대해서는 JDBC API References 각 클래스 API나 추가 타입 사용을 참조한다.

특징

• Type-4 JDBC 드라이버

GOLDILOCKS JDBC는 순수 Java로만 구현된 JDBC Type-4 유형이다. 추가적인 라이브러리 없이 jar 파일만으로 JDBC 드라이버를 사용할 수 있다. 뿐만 아니라 JDBC-ODBC bridge 유형보다 빠르고 안정적이며 native API를 사용한 Type-2보다 이식성 (portability)이 좋다.

• JDBC 표준 준수

GOLDILOCKS JDBC는 JDBC 표준을 준수하므로 여타의 JDBC 프로그램을 거의 변경하지 않고 재활용할 수 있다. Connection을 얻는 방법부터 각종 statement, ResultSet 기능들을 수정없이 사용할 수 있다. 단, connection URL과 프로퍼티 이름, 로딩할 드라이버 클래스 이름은 GOLDILOCKS에 맞게 변경해야 한다. 그리고 표준에 없는 기능과 타입들은 별도의 클래스와 method API로 사용할 수 있다.

• 다양한 Java 버전 지원

GOLDILOCKS JDBC 드라이버는 세 개의 파일 (goldilocks8.jar, goldilocks7.jar, goldilocks6.jar)을 지원하므로 사용자는 Java 실행 환경에 맞는 파일을 선택하여 사용할 수 있다. 각각의 jar 파일은 JDK 1.8, JDK 1.7, JDK 1.6을 기반으로 제작, 구축되었기 때문에 JDBC 4.2, JDBC 4.1, JDBC 4.0 스펙을 따른다.

• 서버와의 유연한 버전 호환성

서버와 JDBC 드라이버와의 호환성은 프로토콜 버전을 참조한다. 서버가 JDBC 드라이버보다 프로토콜 버전이 높을 경우에 접속할 수 있다.

• Connection pooling을 위한 API 지원

JDBC connection 객체는 생성 비용이 비싼 자원이다. 따라서 JDBC 표준에는 이를 풀링할 수 있는 체계를 정의했으며 그것을 인터페이스로 만든 것이 ConnectionPoolDataSource와 PooledConnection이다. GOLDILOCKS JDBC는 이 인터페이스를 구현하여 제3자의 미들웨어 제품에서 풀링 기능을 사용할 수 있도록 하는 기반을 제공한다.

• XA API 지원

글로벌 트랜잭션 표준인 XA 인터페이스를 구현하여 사용자가 글로벌 트랜잭션 작업을 할 수 있도록 한다. JDBC 인터페이스인 XAResource를 사용하여 각종 XA 기능을 표준에 맞게 수행할 수 있다.

• GOLDILOCKS 고유 데이터 타입

GOLDILOCKS는 JDBC 표준에서 제공하지 않는 데이터 타입을 사용한다. 예를 들어 interval 관련 타입과 timestamp with time zone과 같이 time zone 정보를 가지는 타입들이 있다. 이들 타입들을 데이터베이스에 삽입하거나 가져올 수 있는 방법들을 드라이버가 제공한다.

• 서버 기반의 강력한 커서 스크롤 기능

타 JDBC 드라이버들은 ResultSet 스크롤을 위해 row set을 드라이버 내에서 caching하는 방법을 취하여, client 응용 프로그램이 과도하게 메모리를 많이 사용하는 경우가 있다. 예를 들어 scroll insensitive로 커서를 열어 마지막 row까지 fetch하게 되면 모든 row들을 드라이버 내에 caching하게 되는데 이 때 전체 테이블이 client 메모리에 상주하게 되므로 out of memory 에러가 발생할 수도 있고, 과도하게 client 메모리 리소스를 소모하게 된다.

하지만 GOLDILOCKS는 서버 내에 커서 스크롤 기능이 있기 때문에 client가 가볍고, 빠르고 안정적인 성능을 낼 수 있다.

• 효율적인 자원 사용

타 JDBC 드라이버들에 비해 row 정보를 유지하는 메모리를 최소화하고, 되도록 Java 객체를 사용하지 않기 때문에 많은 row들을 탐색할 경우에도 garbage collection 작업을 피할 수 있으며 적은 메모리를 사용하도록 하여 빠르고 안정적으로 테이블을 스캔할 수 있다.

• 정확하고 방대한 메타 데이터

JDBC 표준의 DatabaseMetaData 인터페이스를 충실하고 정확하게 구현했기 때문에 다양한 데이터베이스 툴과 쉽게 연계할 수 있다. 뿐만 아니라 각종 시스템 view를 통해 데이터베이스 메타 정보들을 조회할 수 있어 사용성이 높아졌다.

• 강력한 로깅 기능

문제가 발생했을 때 뿐만 아니라 평상시에도 JDBC API 콜이나 네트워크 사용 상황을 모니터링 할 수 있도록 각종 logging 기능을 제공한다. Connection URL에 로깅 관련 기능을 명세하면 콘솔이나 파일 등으로 해당 내용의 기록을 남길 수 있다. 로깅에는 JDBC method call 기록에 대한 로깅, 프로토콜 송수신에 대한 로깅, 사용한 SQL 문에 대한 로깅, global connection 사용에 대한 로깅, 이 네 가지가 있다.

• Connection failover

GOLDILOCKS 서버와의 연결에 실패하거나 execution 할 때 연결이 끊어지면 미리 등록된 대체 서버에 자동으로 다시 접속하여 기존 connection을 계속해서 사용할 수 있도록 JDBC driver 레벨의 connection failover를 지원한다. 사용자는 connection이 끊겼을 때를 대비한 별도의 예외 처리없이 기존의 JDBC 프로그램으로 connection failover 기능을 사용할 수 있다.

• 서버와 direct attach 연결 가능

TCP/ IP 기반의 연결 이외에 서버와 같은 프로세스로 연동할 수 있는 direct attach 방식의 연결도 할 수 있다. ODBC 연결이 direct attach, Client/ Server 방식을 모두 지원하듯이 GOLDILOCKS JDBC driver도 두 가지 연결 방법을 모두 제공한다. Direct attach로 연결된 JDBC 프로그램은 TCP/ IP 통신을 하지 않고 직접 서버 프로세스에 연동되어 jvm 안에서 서버 기능을 사용할 수 있다. TCP/ IP로 연결한 JDBC 프로그램보다 두 배 이상의 성능을 낼 수 있다.

버전 및 지원 여부

GOLDILOCKS JDBC 버전 체계

goldilocks6.jar 파일에 대해 다음처럼 실행하면 GOLDILOCKS JDBC 버전 정보를 볼 수 있다.

shell>java -jar goldilocks6.jar

 GOLDILOCKS JDBC Driver 1.1 Procotol-2.5.2, JDBC4.0 compiled with JDK1.6

위 예제는 현재 GOLDILOCKS JDBC 드라이버 버전이 1.1이고, 프로토콜 버전은 2.5.2, 그리고 이 드라이버가 준수하는 JDBC 표준 버전은 4.0이며 JDK 1.6에서 구축되었다는 정보를 담고 있다. 드라이버 버전은 GOLDILOCKS 제품 버전과는 별개인 드라이버의 버전을 나타내고 기능이 보강될 때마다 올라간다. JDBC 드라이버 버전에 대한 자세한 내용은 DatabaseMetaData의 getDriverMajorVersion, getDriverMinorVersion, getDriverVersion을 참조한다.

프로토콜 버전은 서버와의 호환성 여부를 결정하며 드라이버는 서버의 프로토콜 버전과 같거나 더 낮을 때 서버에 연동될 수 있다. 즉, 서버는 하위 프로토콜 버전의 모든 client API를 지원한다.

goldilocks6.jar는 JDBC 4.0 표준을 준수하며 JDK 1.6에서 구축되었다. goldilocks7.jar는 JDBC 4.1 표준을 준수하며 JDK 1.7에서 구축되었다. goldilocks8.jar는 JDBC 4.2 표준을 준수하며 JDK 1.8에서 구축되었다. 따라서 사용자 Java 환경이 JDK 1.8 이상일 경우에는 goldilocks8.jar를 사용하면 된다. 다만 JDK 1.9 이상의 Java를 사용할 경우, goldilocks8.jar는 사용할 수 있지만 JDBC 4.3의 API나 클래스들은 사용할 수 없다.

사용 예

Class Path 설정

GOLDILOCKS JDBC 드라이버를 사용하려면 CLASSPATH 설정해야 한다.

export CLASSPATH=.:$GOLDILOCKS_HOME/lib/goldilocks6.jar

또는 사용자의 Java 실행환경에 맞는 jar 파일을 path에 추가해도 된다.

드라이버 클래스 로딩

드라이버 클래스는 다음과 같이 로딩할 수 있다.

Class.forName("sunje.goldilocks.jdbc.GoldilocksDriver");

위 예는 전통적인 JDBC 사용 방법으로써 해당 드라이버 클래스를 동적으로 로딩하여 DriverManager에 등록하게 한 다음 연결을 얻는다. 요즘은 DataSource를 통해 연결을 얻는 방법을 더 많이 사용하는데 이에 대해서는 JDBC API References의 해당 클래스를 참조한다.

Connection 얻기

Connection을 얻으려면 다음과 같이 코드를 작성한다.

Connection con = DriverManager.getConnection(
    "jdbc:goldilocks://127.0.0.1:22581/test", "TEST", "test");

GOLDILOCKS JDBC를 사용하기 위한 접속 URL은 "jdbc:goldilocks:"로 시작해야 한다. 그 다음은 서버의 IP와 port 번호이며 URL의 마지막 부분 "/test"는 DB 이름이다. 현재 GOLDILOCKS는 다중 DB를 지원하지 않으므로 DB 이름을 특별히 체크하지는 않는다. 사용자가 접속한 URL은 DatabaseMetaData.getURL()을 통해서 다시 얻을 수 있다.

IP를 0.0.0.0으로, 포트를 0으로 설정하면 Direct Attach (D/A) 모드로 접속한다. 혹은 ip:port 대신 da라는 접속 프로토콜을 사용해도 된다. 즉 다음 두 URL 모두 D/A 모드로 접속하게 한다.

"jdbc:goldilocks://0.0.0.0:0/test"
"jdbc:goldilocks:da/test"

Username과 password는 각각 데이터베이스의 계정과 암호를 사용해야 한다.

Statement와 ResultSet 사용

Statement와 ResultSet은 다른 JDBC 프로그램과 동일하게 사용하면 된다.

Statement stmt = con.createStatement();
ResultSet rs = stmt.executeQuery("SELECT NAME, ADDRESS FROM EMP");
while (rs.next())
{
    System.out.println("name = " + rs.getString(1));
    System.out.println("address = " + rs.getString(2));
}
rs.close();
stmt.close();

기능 명세

연결

DriverManager를 이용한 연결

Connection을 얻는 전통적인 방법은 DriverManager를 사용하는 것이다.

Connection con = DriverManager.getConnection(url_string, user_name, password);

url_string에는 다음과 같은 세가지 유형이 있다.

jdbc:goldilocks://[ip address]:[port_no]/[db_name]

jdbc:goldilocks:da/[db_name]

jdbc:goldilocks:locator//[ip address]:[port_no][, [ip address]:[port_no] ]*/[db_name]

IP address에는 IPv4, IPv6 모두 사용 가능하며, port_no에는 설정된 포트 번호를 명시하면 된다. db_name은 현재 접속에 사용되지 않기 때문에 어떤 이름이든 설정할 수 있지만 생략할 수는 없다. 다음은 예제 URL이다.

String url_string = "jdbc:goldilocks://127.0.0.1:22581/test";

IP "0.0.0.0"과 포트 0은 D/A 접속을 위한 특별한 주소로 사용된다. D/A 모드에 대한 자세한 내용은 Direct Attach 모드 접속을 참조한다.

user_name과 password는 GOLDILOCKS 계정을 의미한다.

위의 getConnection() method 외에 각종 property를 설정하기 위해 다음 method를 사용한다.

Properties prop = new Properties();
prop.setProperty("user", user_name);
prop.setProperty("password", password);
Connection con = DriverManager.getConnection(url_string, prop);

glocator로부터 서버의 접속 정보를 얻기 위해 연결 프로퍼티를 대신하여 url_string에 locator 키워드를 추가하여 사용할 수 있다. 이 때 ip address와 port_no는 glocator의 접속 정보로 간주한다. 다음은 연결 구문에 locator 키워드를 사용하는 예이다.

String url_string = "jdbc:goldilocks:locator//127.0.0.1:42581,127.0.0.1:42582/test?locator_service=S1";

처음 접속 정보 127.0.0.1:42581은 glocator의 접속 정보이고 이후의 접속 정보는 127.0.0.1:42582처럼ALTERNATE_LOCATORS 프로퍼티로 처리된다.

다음은 위의 url_string과 같은 의미의 프로퍼티 설정이다.

String url_strng = "jdbc:goldilocks://0.0.0.0:0/test";
Properties prop = new Properties();
prop.setProperty("locator_host", "127.0.0.1");
prop.setProperty("locator_port", "42581");
prop.setProperty("alternate_locators", "127.0.0.1:42582");
prop.setProperty("locator_service", "S1");
Connection con = DriverManager.getConnection(url_string, prop);

접속에 사용할 수 있는 프로퍼티 목록은 GOLDILOCKSDriver의 getPropertyInfo() method를 통해 확인할 수 있다. 자세한 내용은 연결 프로퍼티를 참조한다.

DriverManager를 사용하면 생성되는 connection 객체의 login timeout과 logger는 DriverManager에 등록된 값을 사용한다. 즉, 이 connection 객체로부터 생성되는 모든 JDBC 인터페이스들이 사용하는 logger는 저 logger이다. 따라서 connection 객체마다 개별 logger를 가질 수 없다.

DataSource를 이용한 연결

JDBC 표준은 과거의 DriverManager보다는 DataSource를 사용할 것을 더 권장한다. DataSource는 어떤 data source에 접근할 수 있도록 하는 단일한 인터페이스이며, 각종 data source에 관계되는 설정 값들을 개별적으로 설정할 수 있으며, DataSource 객체 자체를 원격으로 전송할 수도 있기 때문이다.

다음과 같이 DataSource를 통해 connection 객체를 얻을 수 있다.

import sunje.goldilocks.jdbc.GoldilocksDataSource;

GoldilocksDataSource ds = new GoldilocksDataSource();
ds.setServerName("127.0.0.1");
ds.setPortNumber(22581);
ds.setDatabaseName("test");
ds.setUser("TEST");
ds.setPassword("test");
Connection con = ds.getConnection();

이처럼 DataSource 객체를 생성하기 위해서는 GoldilocksDataSource 클래스를 사용해야 한다.

그 다음 각종 연결 정보는 DataSource 표준 API가 아닌 setter method를 사용해야 하는데, 자세한 설명은 DataSource를 참조한다.

DriverManager를 이용할 때는 login timeout과 logger를 글로벌하게 설정했어야 했지만, DataSource는 login timeout과 logger를 개별적으로 설정할 수 있다.

ds.setLoginTimeout(10);
ds.setLogWriter(out);

미들웨어 연동

Weblogic, JBoss와 같은 미들웨어와 연동하려면 XADataSource, ConnectionPoolDataSource 인터페이스를 구현한 클래스 이름을 알아야 한다. GOLDILOCKS에서는 sunje.goldilocks.jdbc 패키지에 GoldilocksXADataSource, GoldilocksConnectionPoolDataSource를 제공한다. 이 두 클래스 모두 GoldilocksDataSource와 마찬가지로 각종 setter method를 제공한다.

import sunje.goldilocks.jdbc.GoldilocksXADataSource;

GoldilocksXADataSource ds = new GoldilocksXADataSource();
ds.setServerName("127.0.0.1");
ds.setPortNumber(22581);
ds.setDatabaseName("test");
ds.setUser("TEST");
ds.setPassword("test");
XAConnection con = ds.getXAConnection();

연결 프로퍼티

데이터 조작

Statement를 이용한 데이터 조작

Statement 객체를 사용하여 각종 SQL 문을 실행할 수 있다. 다음과 같이 connection 객체로부터 statement 객체를 얻을 수 있다.

Connection con = DriverManager.getConnection(...);
Statement stmt = con.createStatement();

이렇게 생성된 statement 객체의 execute method와 executeUpdate method를 사용하여 각종 DML 문이나 DDL 문을 수행할 수 있다.

stmt.executeUpdate("create table emp ( id varchar(20), name varchar(30), age integer )");
stmt.executeUpdate("insert into emp values ('1234560000', '김연아', 24)");
int updated = stmt.executeUpdate("delete from emp where age > " + age);

execute와 executeUpdate의 차이점은 오직 반환값 뿐이다. execute는 수행한 SQL 문이 ResultSet을 반환하는지 여부를, executeUpdate는 갱신이 반영된 row의 개수를 각각 반환한다. execute는 DML이나 SELECT 구문에 모두 사용할 수 있지만 executeUpdate를 SELECT 문에 사용하면 SQLException이 발생한다.

PreparedStatement를 이용한 데이터 조작

JDBC 표준은 데이터 조작을 위해 parameter를 사용할 수 있는 PreparedStatement 인터페이스를 제공하여 사용자가 보다 효율적으로 실행할 수 있도록 한다. 뿐만 아니라 PreparedStatement는 반복적인 실행에 대해 SQL 문 prepare 작업을 한 번만 하기 때문에 빠르게 수행할 수 있다.

Connection con = DriverManager.getConnection(...);
PreparedStatement pstmt = con.prepareStatement(
  "insert into emp values (?, ?, ?)");
pstmt.setString(1, "55544123000");
pstmt.setString(2, "김길동");
pstmt.setInt(3, 32);
pstmt.executeUpdate();
pstmt.setString(1, "1357924680");
pstmt.setString(2, "고둘리");
pstmt.setInt(3, 41);
pstmt.executeUpdate();

라인 2 ~ 3처럼 SQL 문을 prepare 해놓은 후에 데이터를 바인딩하고 실행한다. 한 번 prepare된 PreparedStatement는 계속해서 바인딩과 실행을 반복 수행할 수 있다.

만약 바인딩을 생략하고 execute()를 수행하면 이전에 바인딩 했던 값들이 사용된다.

pstmt.setString(1, "333555777000");
pstmt.setString(2, "강철규");
pstmt.setInt(3, 55);
pstmt.executeUpdate();
pstmt.setString(1, "245778884440");
pstmt.executeUpdate();

이처럼 라인 6에서 2, 3 번째 파라미터에 값을 바인딩하지 않고 바로 실행하면 이전에 바인딩 된 값인 "강철규"와 55가 사용된다. 만약 이전에 바인딩 된 값이 없을 경우, SQLException이 발생한다.

바인딩 된 값들을 모두 제거하려면 clearParameters()를 사용한다.

pstmt.setString(1, "333555777000");
pstmt.setString(2, "강철규");
pstmt.setInt(3, 55);
pstmt.executeUpdate();
pstmt.clearParameters();
pstmt.setString(1, "245778884440");
pstmt.executeUpdate();

이와 같이 라인 5에서 parameter들을 제거한 후, 첫 번째 parameter에만 값을 바인딩하고 실행하면 (라인 7) SQLException이 발생한다.

PreparedStatement를 사용하는 주된 이유는 다양한 타입의 데이터를 바인딩 할 수 있기 때문이다. Statement로는 값을 문자열로 표현할 수 밖에 없기 때문에 binary나 timestamp 같은 타입의 데이터를 입력하기에는 불편하다. 하지만 PreparedStatement로는 모든 타입으로 바인딩 할 수 있기 때문에 더 편리하다.

pstmt.setTimestamp(1,
  new Timestamp(Calendar.getInstance().getTimeInMillis()));
pstmt.setCharacterStream(2, new StringReader(BIG_STRING));
pstmt.setObject(3, someObj, Types.LONGVARCHAR);
pstmt.setObject(4, otherObj);

위의 예에서 1 ~ 2번 라인은 java.sql.Timestamp 객체를 바인딩한다. 바인딩 타입 (서버에 데이터가 전해질 때, 그 데이터의 GOLDILOCKS 타입)은 TIMESTAMP이다. 각종 setter method에 의해 결정되는 바인딩 타입에 대한 자세한 내용은 PreparedStatement의 해당 API를 참조한다.

라인 3은 reader 객체를 바인딩하는데, 내부적으로 LONG VARCHAR 타입으로 바인딩하게 된다.

라인 4는 Java object 타입의 객체를 바인딩하는데, 타입이 LONG VARCHAR라는 것을 명시적으로 알려준다. Types의 타입에 매핑되는 GOLDILOCKS 타입에 대한 자세한 내용은 SQL 타입 → GOLDILOCKS 타입을 참조한다.

라인 5는 Java object 타입을 그대로 바인딩하는데, 클래스 타입에 따라 해당되는 GOLDILOCKS 데이터 타입으로 바인딩된다. 클래스 타입과 GOLDILOCKS 데이터 타입 사이의 매핑에 대한 자세한 내용은 Java 객체 → GOLDILOCKS 타입을 참조한다.

Statement를 이용한 배치 실행

Statement의 addBatch()와 executeBatch()를 사용하여 서로 다른 SQL 문을 batch job 형태로 실행할 수 있다.

stmt.addBatch("insert into emp values ("12345", "Jake", 22)");
stmt.addBatch("insert into salary values ("12345", 5000)");
stmt.addBatch("update members set total_count=total_count+1 where age=22");
stmt.executeBatch();

이처럼 서로 다른 SQL 문을 하나의 executeBatch() method를 통해 수행할 수 있다. 하지만 이 method 호출을 통해 세 개의 구문 모두가 서버에서 수행된 결과를 모아 한 번의 프로토콜로 JDBC 드라이버에 전달하는 것은 아니다. 내부적으로 세 번의 프로토콜 전송과 서버에서의 실행, 결과 전송이라는 작업이 수행되는 것이다. 즉, 성능상 큰 이점을 가질 수 있는 것은 아니라는 점에 주의해야 한다.

executeBatch를 실행한 후 등록된 job들은 모두 지워진다.

실행 도중 에러가 발생해도 끝까지 등록된 job을 모두 수행한다. 에러 발생 유무는 반환된 int[] 형의 값을 참고하면 알 수 있다. 즉, int[]이 EXECUTE_FAILED 값을 가지면 그 job은 실패했다는 의미이다.

PreparedStatement를 이용한 배치 실행

PreparedStatement의 addBatch()와 executeBatch() method를 이용하여 좀 더 강력한 배치 실행을 수행할 수 있다.

PreparedStatement pstmt = con.prepareStatement("insert into emp values (?, ?, ?)");
pstmt.setString(1, "12345000");
pstmt.setString(2, "John");
pstmt.setInt(3, 33);
pstmt.addBatch();

pstmt.setString(1, "222333555");
pstmt.setString(2, "Henry");
pstmt.setInt(3, 24);
pstmt.addBatch();
int[] inserted = pstmt.executeBatch();

위의 예는 두 개의 row를 추가하는 과정이다. 두 개의 row를 구성할 값들을 addBatch()를 통해 바인드하고, 이후 executeBatch()를 호출하면 바인드 한 값과 execute에 대한 프로토콜이 서버로 전송되어 실행된다. 즉, executeBatch() 할 때만 통신하기 때문에 statement의 배치 실행보다 효율적이고 성능이 빠르다.

executeBatch()를 수행한 후엔 바인딩된 값들이 모두 삭제되기 때문에 executeBatch()을 다시 수행하려면 새로운 값을 다시 바인드 해야 한다. 실행한 후에 등록된 job들을 지우기 위해 clearBatch()를 명시적으로 호출하지 않아도 된다.

실행하는 도중에 에러가 발생해도 등록된 job 모두를 끝까지 수행한다. 에러 발생 유무는 반환된 int[] 형의 값을 참고하여 확인할 수 있다. 즉, int[]이 EXECUTE_FAILED 값을 가지면 그 job은 실패했다는 의미이다.

GOLDILOCKS JDBC는 executeBatch() 외에 executeBatchAtomic() 이라는 별도의 method를 제공한다. executeBatch()는 서버에서 등록된 job의 개수만큼 실행하지만, executeBatchAtomic()은 등록된 job (바인딩된 값들)을 한 번에 실행하기 때문에 응답시간이 더 빠르다. 다만 atomic이라는 이름에서 알 수 있듯이 하나라도 실패하게 되면 전부 실패하게 된다. 따라서 반환되는 유형은 int[]형이 아니라 int이다.

...
int inserted = ((GoldilocksPreparedStatement)pstmt).executeBatchAtomic();

데이터 조회

Column 값 조회

Statement나 PreparedStatement의 executeQuery()를 통해서 얻은 ResultSet 객체를 통해 데이터를 조회할 수 있다.

...
ResultSet rs = pstmt.executeQuery();
while(rs.next())
{
    String id = rs.getString(1);
    String name = rs.getString(2);
    int age = rs.getInt(3);
    ...
}

테이블의 데이터를 조회한 후 ResultSet의 각종 getter method를 통해 해당 column의 내용을 얻을 수 있다. 테이블의 데이터는 GOLDILOCKS 데이터 타입의 원래 형태로 JDBC 드라이버에 전달되며, 사용자가 호출한 getter method 종류에 따라 적절한 Java 데이터 타입으로 변환되어 사용자에게 전달된다. GOLDILOCKS 데이터 타입과 getter method와의 타입 변환 매핑은 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

GOLDILOCKS 데이터 타입을 해당 getter의 타입으로 변환할 수 없으면 SQLException이 발생한다.

Closing ResultSet

사용을 마친 ResultSet의 자원은 close()를 통해 해제할 수 있다. 사용자가 명시적으로 close()를 호출하지 않아도 다음과 같은 경우에는 ResultSet의 close()를 호출한 것과 동일한 결과를 가져온다.

• 상위 statement가 close되었을 때

• 상위 connection이 close되었을 때

• Statement의 executeQuery()가 다시 호출되었을 때

• Fetch하는 도중 에러가 발생했을 때

위의 세 번째 경우에 하나의 statement로부터 생성되는 ResultSet의 경우 동시에 두 개가 유지될 수 없다. 마지막 executeQuery()를 통해 생성된 ResultSet 객체만 유효하다.

Fetch Size

JDBC는 statement의 setFetchSize(int rows)를 통해 서버로부터 한 번에 fetch해오는 row 개수를 지정할 수 있다. GOLDILOCKS의 ResultSet은 이 속성의 기본값이 0이다. 0은 서버가 fetch 할 row의 개수를 자동으로 정하는데, forward only인 경우 한 통신 패킷에 담을 수 있는 최대 row 개수이고, scrollable인 경우 100개로 고정된다. 이 값이 크면 JDBC ResultSet이 차지하는 메모리 양이 많아지고, 너무 작으면 통신이 자주 발생한다.

이 값은 주로 scrollable ResultSet에 많이 사용하는데, 왜냐하면 scroll sensitive라 할지라도 ResultSet의 row 캐시 내에서 이동할 때는 sensitive하지 않기 때문에 이 값을 너무 크게 잡으면 row에 대한 최신 갱신 정보를 가질 수 없기 때문이다.

필드 크기 제한

JDBC는 statement의 setMaxFieldSize(int size)를 통해 한 column의 최대 길이를 제한할 수 있다. 이 설정에 의해 CHAR, VARCHAR, LONG VARCHAR, BINARY, VARBINARY, LONG VARBINARY 타입에 대해 최대 길이를 제한할 수 있다. 이 길이를 넘는 데이터는 잘라 버린다. 기본값은 0이며, 이 경우 최대 길이를 제한하지 않는다.

INTEGER, DATE와 같은 다른 타입에 대해서는 이 속성이 무시된다.

ResultSet 스크롤

Scrollable ResultSet 획득

Scrollable ResultSet은 scroll sensitive와 scroll insensitive 두 가지이다. Scroll sensitive는 ResultSet을 순회하는 동안 자기 트랜잭션에 의해서든, 타 트랜잭션에 의해서든 갱신된 값들을 볼 수 있는 커서 유형이고, scroll insensitive는 그렇지 못한 커서이다. GOLDILOCKS 서버는 두 가지 스크롤 유형을 모두 지원하며, JDBC를 통해서도 그 기능을 자유롭게 사용할 수 있다.

Statement stmt = con.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE,
                                     ResultSet.CONCUR_READ_ONLY);
ResultSet rs = stmt.executeQuery("select id, name, age from emp");

라인 1처럼 statement를 생성할 때 ResultSet 타입을 TYPE_SCROLL_SENSITIVE로 설정하면 이 statement 객체로부터 생성되는 ResultSet은 모두 scroll sensitive 커서가 된다. 단, 현재 GOLDILOCKS는 updatable ResultSet은 지원하지 않는다.

Scroll insensitive인 ResultSet을 얻으려면 타입을 TYPE_SCROLL_INSENSITIVE로 설정해야 한다. 기본값은 TYPE_FORWARD_ONLY이다.

단, scroll sensitive ResultSet이라 하더라도 ResultSet의 row 캐시 내에서 이동할 때는 최신값을 볼 수 없고 갱신 유무도 알 수 없다. Row를 서버로부터 다시 fetch 해와야만 알 수 있다.

스크롤 하기

JDBC API는 커서를 스크롤 하기 위해 다음과 같은 method를 제공한다.

public boolean next() throws SQLException;
public boolean previous() throws SQLException;
public boolean first() throws SQLException;
public boolean last() throws SQLException;
public boolean absolute(int rows) throws SQLException;
public boolean relative(int rows) throws SQLException;
public void beforeFirst() throws SQLException;
public void afterLast() throws SQLException;

next()는 forward only나 scrollable ResultSet에 모두 사용할 수 있는 method이며, 커서 위치를 다음 row로 이동시킨다. 이동한 위치에서 row를 읽을 수 있으면 true를, 그렇지 않을 경우에는 false를 반환한다. 그 외의 method들은 scrollable ResultSet에만 사용할 수 있다.

previous()는 이전 row로, first()는 첫 번째 row로, last()는 마지막 row로, absolute()는 절대 위치로, relative()는 현재 위치로부터 상대 위치로 이동시킨다. beforeFirst()는 첫 번째 row 이전으로 위치시키며, afterLast()는 마지막 row의 다음에 위치시킨다.

rs.afterLast();
while (rs.previous())
{
    String id = rs.getString(1);
    String name = rs.getString(2);
    int age = rs.getInt(3);
    ...
}

위 코드는 마지막 row부터 첫 번째 row까지 거꾸로 조회한다.

현재 커서의 위치는 다음 method를 통해 알 수 있다.

public int getRow() throws SQLException;

스크롤 원리

ResultSet 스크롤은 사용하기 간단한 편이지만, 내부 동작 원리를 알지 못하면 성능이 크게 저하될 수도 있어 주의해서 사용해야 한다. 스크롤은 JDBC 드라이버의 ResultSet 내의 result cache에서 수행되지만, cache를 벗어난 범위에 대해서는 서버에서 스크롤이 수행되며 이에 따라 통신이 발생하면 성능이 저하될 수 있다.

Scrollable ResultSet의 fetch size는 내부 (internal) 기본값이 100이다. (외부 기본값은 0이며, 이 값은 setFetchSize() method를 통해 변경할 수 있다.) 즉, 한 번에 JDBC 드라이버로 가져오는 row 개수가 100개라는 뜻이다. ResultSet의 row 캐시는 100개의 row로 구성되는데, 이동시키려는 row 위치가 캐시 내에 있을 경우, ResultSet의 커서 위치만 바꾸면 된다. 하지만 캐시 내에 없을 경우에는 이동시키려는 위치의 row를 다시 서버로부터 가져와야 한다. 이 때 이동시키려는 row를 포함한 row set을 가져오는 방식을 알아야 한다.

예를 들어, ResultSet이 1번부터 100번의 row를 가지고 있고 현재 커서 위치가 100번에 있을 경우에 next()를 호출하게 되면 다음 row가 캐시 내에 없기 때문에 101번부터 200번까지의 row를 서버로부터 fetch해 와야 한다. 반면에 101번부터 200번까지의 row가 ResultSet 캐시 내에 있고, 현재 위치가 101번 row에 있을 때 previous()를 호출한 경우, 서버로부터 100번부터 199번 row를 fetch 해온다면 이는 적절하지 못하다. 만약 이렇게 구현한다면 previous()를 호출할 때마다 서버에서 매번 fetch 해와야 하기 때문이다. GOLDILOCKS는 이런 비효율을 방지하기 위해 previous()를 호출하여 해당 row를 서버로부터 가져와야 하는 상황이 되면 해당 row를 마지막으로 하는 row set을 서버로부터 가져온다. 즉, previous()에 의해 100번 row를 fetch 해와야 하는 상황이라면 1번부터 100번까지의 row를 fetch 해온다. 그러면 previous()에 유리하도록 fetch하게 된다.

이 규칙을 일반화하면 다음과 같다.

• 이동시키려는 위치가 현재 위치 이후일 경우, 그 위치로부터 100개 (설정한 fetch size)의 row를 fetch한다.

• 이동시키려는 위치가 현재 위치 이전이면 그 위치 앞쪽의 100개 row를 fetch한다.

• first()로 이동할 때는 첫 100개를 가져온다.

• last()로 이동할 때는 마지막 100개를 가져온다.

즉, 뒤로 이동할 때는 next()에 유리하도록, 앞으로 이동할 때는 previous()에 유리하도록 fetch한다. 이는 absolute(), relative()로 이동할 때도 마찬가지이다.

추가 타입 사용

Interval 타입

GOLDILOCKS는 interval과 관련하여 다음과 같은 13가지 타입을 지원한다.

• interval year

• interval month

• interval year to month

• interval day

• interval hour

• interval minute

• interval second

• interval minute to second

• interval hour to minute

• interval hour to second

• interval day to hour

• interval day to minute

• interval day to second

JDBC를 이용하여 sunje.goldilocks.jdbc.GoldilocksInterval 객체를 생성하면 PreparedStatement의 setObject()를 통해 interval 데이터를 테이블에 추가할 수 있다.

GoldilocksInterval 객체는 GoldilocksInterval의 static method인 createIntervalXXX를 사용하여 생성할 수 있다.

import sunje.goldilocks.jdbc.GoldilocksInterval;

...
GoldilocksInterval interval = GoldilocksInterval.createIntervalDayToSecond(2, 6, "2 08:23:54.560843");
PreparedStatement pstmt = con.prepareStatement("insert into interval_table values (?,?)");
pstmt.setString(1, someId);
pstmt.setObject(2, interval);
pstmt.executeUpdate();

createIntervalXXX method에 대한 자세한 내용은 GoldilocksInterval을 참조한다. 이와 같이 GoldilocksInterval을 생성하여 setObject를 통해 바인딩 할 수 있다. 또는 타입을 명시하기 위해 다음과 같이 실행해도 된다.

import sunje.goldilocks.jdbc.GoldilocksTypes;
...
pstmt.setObject(2, interval, GoldilocksTypes.INTERVAL_DAY_TO_SECOND);

GoldilocksInterval 객체없이 string 문자열로 데이터를 추가할 수 있다.

pstmt.setObject(2, "2 08:23:54.560843", GoldilocksTypes.INTERVAL_DAY_TO_SECOND);

이 경우 JDBC 드라이버 내에서 GoldilocksInterval 객체를 생성하여 호스트 변수에 바인딩한다. 또는 setString() method를 통해 문자열로 바인딩 할 수도 있다.

pstmt.setString(2, "2 08:23:54.560843");

이렇게 하면 서버에 문자열 그대로 전송되며 서버에서 문자열을 interval day to second 타입으로 변환하여 추가한다.

데이터베이스로부터 interval 타입을 조회하려면 ResultSet의 getObject()나 getString()을 이용한다.

import sunje.goldilocks.jdbc.GoldilocksInterval;

ResultSet rs = stmt.executeQuery("select interval_value from some_table");
while (rs.next())
{
    GoldilocksInterval interval = (GoldilocksInterval)rs.getObject(1);
    System.out.println("type = " + interval.getTypeName() + 
                       ", value = " + interval.toString());
}

ResultSet의 getObject()를 통해 GoldilocksInterval 타입의 데이터를 얻을 수 있다. GoldilocksInterval 클래스는 각종 시간 데이터를 얻을 수 있는 getYear(), getHour() 등의 getter를 제공한다. getter API에 대한 자세한 내용은 GoldilocksInterval을 참조한다.

Time with time zone과 Timestamp with time zone 타입

GOLDILOCKS는 시간과 관련하여 date, time, timestamp와 같은 SQL 표준 타입 뿐만 아니라 time with time zone과 timestamp with time zone 타입도 제공한다.

CREATE TABLE SAMPLE_TABLE ( C1 TIME WITH TIME ZONE,
                            C2 TIMESTAMP WITH TIME ZONE );

GOLDILOCKS JDBC는 time with time zone과 timestamp with time zone 타입의 데이터를 추가하기 위해 GoldilocksPreparedStatement 클래스에 setTimeTimeZone (int colIndex, time time, calendar timezone) method와 setTimestampTimeZone (int colIndex, timestamp time, calendar timezone) method를 제공한다. 자세한 내용은 setTimeTimeZone과 setTimestampTimeZone을 참조한다.

물론 기존의 setTime()과 setTimestamp() method로도 추가할 수 있지만, 이 column의 time zone 값은 무조건 Java 실행 환경의 local time zone으로 설정된다. 따라서 다양한 time zone 정보를 추가하기 위해서는 setTimeTimeZone()이나 setTimestampTimeZone을 사용해야 한다.

setTimeTimeZone과 setTimestampTimeZone으로 주어진 time, timestamp 데이터를 주어진 time zone 값과 함께 추가할 수 있다.

import sunje.goldilocks.jdbc.GoldilocksPreparedStatement;

PreparedStatement pstmt = con.prepareStatement(
    "INSERT INTO SAMPLE_TABLE VALUES (?,?,?,?)");
Calendar now = Calendar.getInstance();
Calendar usNow = Calendar.getInstance(TimeZone.getTimeZone("GMT-8"));

Time t = new Time(now.getTimeInMillis());
Timestamp ts = new Timestamp(now.getTimeInMillis());

pstmt.setTime(1, t);
pstmt.setTimestamp(2, ts);
pstmt.executeUpdate();

((GoldilocksPreparedStatement)pstmt).setTimeTimeZone(1, t, now);
((GoldilocksPreparedStatement)pstmt).setTimestampTimeZone(2, ts, now);
pstmt.executeUpdate();

((GoldilocksPreparedStatement)pstmt).setTimeTimeZone(1, t, usNow);
((GoldilocksPreparedStatement)pstmt).setTimestampTimeZone(2, ts, usNow);
pstmt.executeUpdate();

11, 12 라인은 해당 column에 time 타입과 timestamp 타입으로 바인딩한다. t와 ts 값이 각각 서버로 전달되어 서버에서 기본 time zone 값이 DB column에 추가된다.

이에 반해 15, 16 라인은 해당 column에 time with time zone 타입과 timestamp with time zone 타입으로 바인딩하여, time zone 정보도 함께 서버로 전달한다. 결과적으로 서버와 client의 time zone 설정이 동일할 경우, 11 ~ 13 라인에 의해 추가되는 row와 15 ~ 17 라인에 의해 추가되는 row는 동일하다.

19, 20 라인은 GMT-8 시간대의 time zone 정보를 추가한다.

Time with time zone과 timestamp with time zone의 데이터를 조회하는 방법은 크게 두 가지이다. 서버로부터 char로 얻는 방법과 JDBC로 해당 타입의 데이터를 가져와서 time이나 timestamp 객체로 얻는 방법이 있다.

ResultSet rs = stmt.executeQuery("select c1, cast(c1 as char(33)), c2, cast(c2 as char(33)) from sample_table");
while (rs.next())
{
    System.out.println("c1 = " + rs.getTime(1).toString());
    System.out.println("c1 as char = " + rs.getString(2));

    System.out.println("c2 = " + rs.getTimestamp(3).toString());
    System.out.println("c2 as char = " + rs.getString(4));
}

위 코드를 실행하면 다음과 같은 결과를 확인할 수 있다.

c1 = 12:35:26
c1 as char = 12:35:26.052000 +09:00           
c2 = 2014-03-27 12:35:26.052
c2 as char = 2014-03-27 12:35:26.052000 +09:00
c1 = 12:35:26
c1 as char = 12:35:26.052000 +09:00           
c2 = 2014-03-27 12:35:26.052
c2 as char = 2014-03-27 12:35:26.052000 +09:00
c1 = 12:35:26
c1 as char = 19:35:26.052000 -08:00           
c2 = 2014-03-27 12:35:26.052
c2 as char = 2014-03-26 19:35:26.052000 -08:00

로깅

로깅 종류

JDBC를 이용하는 프로젝트를 개발할 때, JDBC 드라이버가 각종 로그를 남길 수 있으면 여러가지로 도움이 된다. GOLDILOCKS는 프로젝트를 개발할 때만이 아니라 운용할 때도 유용한 정보를 로깅할 수 있는 기능을 제공한다.
로깅의 종류는 세 가지인데 trace log, protocol log, query log 이다.

Trace log는 JDBC API가 호출될 때마다 정보를 남긴다. 어떤 JDBC API가 호출되는 지를 알 수 있다. Protocol log는 JDBC 드라이버와 GOLDILOCKS 서버 사이에 통신 패킷을 주고 받는 상황을 보여준다. Query log는 PreparedStatement나 statement가 실행될 때, 실행할 SQL 문을 기록한다.

DriverManager를 이용한 로깅

먼저 DriverManager를 이용하여 로깅을 남길 수 있다. DriverManager에 setLogWriter() method를 이용하여 로깅할 매체를 결정할 수 있고, connection url에 남길 로깅의 종류를 명시한다.

DriverManager.setLogWriter(new PrintWriter(System.out));
String url = "jdbc:goldilocks://localhost:22581/test?trace_log=on&query_log=on";
Connection con = DriverManager.getConnection(url, "TEST", "test");

1번 라인은 로깅 매체를 정의하는 것이다. 모든 로깅을 콘솔로 출력하게 한다. 2번 라인은 connection URL을 정의하는 것인데, ? 문자 뒤에 프로퍼티를 정의할 수 있다. trace_log, query_log를 사용하겠다는 의미이다.

이와 같이 이 프로퍼티들은 URL에 명시할 수도 있고, properties 객체로 정의할 수도 있다.

Properties prop = new Properties();
prop.put("trace_log", "on");
prop.put("query_log", "on");
prop.put("protocol_log", "on");
prop.put("user", "TEST");
prop.put("password", test");
Connection con = DriverManager.getConnection(url, prop);

GOLDILOCKS에서 사용할 수 있는 connection property들은 연결 프로퍼티에 정의되어 있다.

간혹 DriverManager의 setLogWriter()를 호출하기 어려운 경우가 있다. 예를 들어, 미들웨어를 사용하는 경우 저런 코드를 추가할 수 없다. 그런 경우에 대비해 GOLDILOCKS JDBC는 global_logger라는 전역 프로퍼티를 제공한다. 다른 일반적인 프로퍼티들은 하나의 connection에만 적용되지만, 이 속성은 전역적으로 적용된다. 즉, 이 프로퍼티를 설정하면 DriverManager.setLogWriter()를 호출하지 않아도 된다.

String url = "jdbc:goldilocks://localhost:22581/test?" +            
             "global_logger=console&trace_log=on&query_log=on";
Connection con = DriverManager.getConnection(url, "TEST", "test");

global_logger 속성은 처음 한 번만 적용되는데 만약 DriverManager에 이미 log writer가 설정되어 있으면 이 속성은 무시된다. 이 속성의 값으로는 현재 console만 지원된다. 다른 값인 경우에는 아무런 동작을 하지 않는다.

DataSource를 이용한 로깅

DriverManager와는 다르게 DataSource는 객체별로 log writer를 설정할 수 있다. 하나의 DataSource 객체에 log writer를 세팅하면 그 DataSource로부터 생성되는 모든 connection은 그 log writer로 로깅된다. DataSource에 로깅을 설정하는 방법은 다음과 같다.

import sunje.goldilocks.jdbc.GoldilocksDataSource;
...
GoldilocksDataSource ds = new sunje.goldilocks.jdbc.GoldilocksDataSource();
ds.setServerName("localhost");
ds.setDatabaseName("test");
ds.setUser("TEST");
ds.setPassword("test");
ds.setPortNumber(22581);
ds.setLogTarget("console");
ds.setTraceLog("on");
ds.setQueryLog("on");
ds.setProtocolLog("on");
Connection con = ds.getConnection();

이와 같이 setLogTarget(), setTraceLog(), setQueryLog(), setProtocolLog() method를 사용하여 로깅 기능을 설정할 수 있다. setLogTarget() 대신 DataSource의 setLogWriter()를 호출해도 된다. 다만 미들웨어를 사용하는 경우에는 setLogWriter()와 같은 method를 직접 호출할 수 없기 때문에 property로 제어해야 하는데, 이 때 logTarget, traceLog, queryLog, protocolLog 속성을 정의하면 미들웨어가 자동으로 이 method들을 호출한다.

Plan Text 조회

사용법

GOLDILOCKS ODBC를 사용하면 실행된 statement의 plan text를 얻어올 수 있는 것처럼 GOLDILOCKS JDBC를 사용해서도 plan text를 얻어올 수 있다. GoldilocksStatement 클래스에 비 표준 API method를 사용하여 plan text를 생성하도록 설정할 수 있고, 만들어진 plan text를 얻어올 수도 있다.

Connection con = ...
GoldilocksStatement stmt = (GoldilocksStatement)con.createStatement();
stmt.setExplainPlanOption(GoldilocksStatement.EXPLAIN_PLAN_OPTION_ON);
ResultSet rs = stmt.executeQuery("select * from t1");
System.out.println(stmt.getExplainPlan());

예를 들어 간단한 테이블을 조회했을 때의 plan text는 다음과 같이 출력된다.

< Execution Plan >
==========================================================================
|  IDX  |  NODE DESCRIPTION                                |       ROWS |
--------------------------------------------------------------------------
|    0  |  SELECT STATEMENT                                |            |
|    1  |    TABLE ACCESS ("T1")                           |          0 |
==========================================================================
     1  -  READ COLUMNS : A

옵션 종류

GOLDILOCKS는 다음과 같이 plan text 생성과 관련된 네가지 속성을 제공한다.

• EXPLAIN_PLAN_OPTION_OFF: Statement의 plan text 관련 속성의 기본값으로써 plan text를 생성하지 않는다.

• EXPLAIN_PLAN_OPTION_ON: 실행할 때나 fetch 할 때 plan text를 생성한다.

• EXPLAIN_PLAN_OPTION_ON_VERBOSE: 실행할 때나 fetch 할 때 실행 시간과 같이 보다 자세한 plan text를 생성한다.

• EXPLAIN_PLAN_OPTION_ONLY: 실행할 때나 fetch 할 때 EXPLAIN_PLAN_OPTION_ON처럼 plan text를 생성하지만 실제로 실행은 하지 않는다.

이 속성들은 GoldilocksStatement.setExplainPlanOption(int) method를 사용하여 설정할 수 있으며 한 번 설정하면 계속해서 이 속성이 유지된다. 속성의 상수값은 GoldilocksStatement에 정의되어 있다.

Connection Failover

GOLDILOCKS는 client 레벨 (JDBC, ODBC)의 connection failover를 지원한다. GOLDILOCKS에 JDBC 또는 ODBC를 이용하여 client/ server 모드로 접속한 응용 프로그램은 연결에 실패하거나 연결이 끊길 경우, 자동으로 대체 서버로 연결할 수 있다. 이를 통해 여러 대의 서버를 활용한 고가용성 응용 프로그램을 작성할 수 있도록 해준다. 특히 웹 서버와 연동된 환경에서 연결 속성 (connection property)을 통해 주 서버 URL과 대체 서버 URL을 등록하면 connection pool로부터 가져온 connection 객체를 끊길 걱정없이 안정적으로 사용할 수 있다. Failover는 전적으로 드라이버 내부에서 자동 진행되며 사용자는 재접속에 대한 로직을 고민할 필요없다.

Failover 기능을 사용하려면 alternate_servers 속성을 부여해야 한다. 이 속성 값으로 대체 서버의 IP와 port를 부여할 수 있다. 콤마 (,)를 사용하여 여러 개의 대체 서버를 명시할 수도 있다.

Class.forName("sunje.goldilocks.jdbc.GoldilocksDriver");

String url = "jdbc:goldilocks://192.168.0.101:22581/test";
Property prop = new Properties();
prop.setProperty("user", "TEST");
prop.setProperty("password", "test");
prop.setProperty("alternate_servers", "192.168.0.201:22581");
Connection con = DriverManager.getConnection(url, prop); 1
Statement stmt = con.createStatement();
stmt.executeUpdate("insert into time_tab values (sysdate)"); 2
...

예를 들어, 1에서 주 서버 (192.168.0.101)의 연결이 실패하면 자동으로 대체 서버 (192.168.0.201)로 접속한 후 connection 객체를 반환한다. 사용자에게는 별다른 에러가 반환되지 않는다. 만약 2에서 executeUpdate() 하는 도중에 연결이 끊기거나 그 전에 끊어져서 서버와 통신을 할 수 없을 경우 드라이버 내부에서 자동으로 대체 서버로 접속하여 기존 connection 객체를 계속해서 사용할 수 있도록 조치한 후 SQLException이 발생한다. 사용자는 SQLException을 처리한 후에 기존 connection 객체를 계속해서 사용할 수 있다.

Connection 객체의 getWarnings()를 통해 failover 여부를 알 수 있다.

GOLDILOCKS JDBC의 failover 특징 중에 하나는 connection 객체로부터 생성된 statement 객체나 PreparedStatement 객체를 계속해서 사용할 수 있다는 점이다. (ResultSet은 계속해서 사용할 수 없다)

특히 PreparedStatement 들은 failover가 발생하면 내부적으로 대체 서버에서 다시 prepare 작업을 수행하므로 사용자가 계속해서 이 객체를 사용할 수 있다.

Connection con = DriverManager.getConnection(url, prop);
PreparedStatement pstmt = 
    con.prepareStatement("insert into t1 values (?,?)");
...
try
{
    pstmt.setInt(1, 100);
    pstmt.setString(2, "John");
    pstmt.executeUpdate();
}
catch (SQLException sException)
{
    if (sException.getErrorCode() == 21012)
    {

• Communication link failure 에러가 발생하여 failover가 발생했다.

• 계속해서 pstmt 객체를 사용할 수 있다.

pstmt.executeUpdate(); 
    }
    else
    {
        ...
    }
}

GOLDILOCKS JDBC 드라이버는 failover와 관련해 몇 가지 속성을 제공한다. 이를 통해 failover 유형, 접속 순서 및 failover시 사용되는 간단한 정책 등을 결정할 수 있다.

failover_type

이 속성으로 failover 유형을 선택할 수 있다. 위 예제 코드 1에서 발생하는 failover를 connection failover라 하고 2에서 발생하는 failover를 session failover라 부른다. 이 속성 값으로 connection을 부여하면 connection failover만 수행하게 하며, session을 부여하면 connection failover와 session failover를 모두 수행하게 한다. 기본값은 connection이다.

failover_granularity

Failover가 발생하면 현재의 connection 객체로부터 생성된 PreparedStatement 객체들에 대체 서버로 접속한 후 prepare 작업을 다시 수행하는데 이 때 대체 서버에서 prepare가 실패했을 경우 (서버 환경이 달라서 에러가 발생할 수 있음) failover 자체를 실패로 처리할지 또는 prepare 에러를 무시할지 여부를 이 속성이 결정한다. 현재 이 속성값으로 0과 1을 부여할 수 있는데, 0을 부여하면 prepare 에러를 무시한 채 failover를 계속해서 수행할 수 있게하고, 1을 주면 failover가 실패하도록 한다. 기본값은 0이다. 만약 0을 부여하고 prepare에 실패하면 PreparedStatement 객체를 계속해서 사용할 수 없고 사용자가 다시 직접 PreparedStatement 객체를 생성해야 한다.

Direct Attach 모드 접속

GOLDILOCKS JDBC 1.1부터 기존 TCP/ IP 기반의 Client/ Server 모드 (C/S 모드) 외에 Direct Attach 모드 (D/A 모드) 연결을 제공한다. 이 연결 방식은 ODBC D/A 모드 접속과 마찬가지로 서버 프로세스와 직접 연동하여 하나의 프로세스 안에 (jvm과 같은 프로세스 안에) 서버 모듈이 연동되어 작동한다. 그렇기 때문에 원격 호스트에서는 D/A 모드로 접속할 수 없다.

D/A 모드는 in-memory 데이터베이스인 GOLDILOCKS의 빠른 처리라는 장점을 살리기 위해 고안된 특별한 연결 방식이다. TCP/ IP 기반의 접속으로는 GOLDILOCKS의 빠른 트랜잭션 처리 효과가 값비싼 네트워크 비용으로 상쇄되기 때문에 빠른 처리를 요구하는 상황에서는 다른 대안이 필요하다. 비록 GOLDILOCKS 서버와 같은 호스트 내에서 실행해야 한다는 제약이 있지만 빠른 처리를 필요로 하는 경우 D/A 모드 접속은 좋은 대안이 될 수 있다.

D/A 모드로 접속한 JDBC 프로그램은 jvm 내에서 DB connection이 처음 생성되면 GOLDILOCKS jni 라이브러리가 로딩되어 서버의 기능을 직접 호출할 수 있다. 네트워크 비용없이 jvm에서 native interface를 통해 서버 모듈을 직접 호출할 수 있기 때문에 기존의 CS 모드보다 빠른 처리가 가능하다.

접속 방법

D/A 모드로 접속하기 위해 connection URL에 기존 ip:port 대신 0.0.0.0:0을 사용한다. 기존의 URL 방식을 그대로 사용할 수 있으며 0.0.0.0:0이라는 특별한 ip:port 주소를 사용하여 기존 응용 프로그램의 수정을 최소화할 수 있다. 또는 da라는 특수 프로토콜을 URL에 사용하면 D/A 모드로 접속할 수 있다.

Connection con =
 DriverManager.getConnection("jdbc:goldilocks://0.0.0.0:0/test","TEST","test");

또는

Connection con =
 DriverManager.getConnection("jdbc:goldilocks:da/test", "TEST", "test");

D/A 접속의 특징

D/A 모드로 접속하면 jvm 안에서 GOLDILOCKS server 모듈을 직접 호출할 수 있다. JDBC 프로그램과 GOLDILOCKS server 모듈 사이에는 Java Native Interface (JNI)를 통해 호출한다. JNI 호출 비용이 비싼 것을 고려하여 최소 호출 비용으로 서버 모듈을 사용하기 때문에 기존 TCP/ IP 기반의 JDBC보다 두 배 이상성능이 빨라진다.

기존 TCP/ IP 기반의 접속을 사용할 때는 goldilocks6.jar 파일만 사용하지만 D/A 모드로 접속할 때는 $GOLDILOCKS_HOME/lib에 있는 libgoldilocksjni.so와 libgoldilocksas.so 파일을 동적으로 로딩해서 사용한다. 따라서 두 라이브러리 파일이 없으면 연결할 때 에러가 발생한다. 하지만 Java 프로그램을 구동할 때 라이브러리 파일의 위치를 별도로 명시할 필요는 없다. goldilocks6.jar 파일과 같은 디렉토리에 있는 한 현재 디렉토리부터 이 두 개의 라이브러리 파일을 찾아서 로딩하기 때문이다.

Global Connection

클러스터 환경에서 응용 프로그램이 질의 처리에 적합한 노드를 선택해서 수행할 수 있는 global connection 기능을 지원한다.

설정

Global connection을 사용하려면 locality_aware_transaction 속성값과 함께 locator_file이나 locator_host, locator_port를 설정해야 한다. Global session 기능을 사용하려면 use_global_session 속성값을 1로 설정해야 한다.

Properties prop = new Properties();
prop.put("locality_aware_transaction", "1");
prop.put("locator_file", "/home/goldilocks/.location.ini");
prop.put("user", "TEST");
prop.put("password", test");
Connection con = DriverManager.getConnection(url, prop);

String url = "jdbc:goldilocks://192.168.0.1:22581/test?" +            
             "locality_aware_transaction=1&locator_host=192.168.0.2&locator_port=42581";
Connection con = DriverManager.getConnection(url, "TEST", "test");

처리 과정

• 데이터베이스 접속

사용자로부터 입력 받은 서버로 연결하여 클러스터 시스템의 정보를 획득한 후에 locator file이나 glocator를 통해 클러스터 시스템 정보를 구축하며, 클러스터 시스템의 모든 노드에 접속한다.

• Statement 실행

클러스터 시스템 정보가 구축되어 있지 않으면 locator file이나 glocator를 통해 클러스터 시스템 정보를 구축하며, 클러스터 시스템의 모든 노드에 접속한다.

클러스터에 노드를 추가하여 새로운 노드에 접속한 경우, 다른 노드의 모든 statement들을 해당 노드에 동일하게 생성한 후에 SQL을 실행할 준비까지 한다.

Statement class의 경우, sharding key 정보가 없으므로 locality_group_policy나 locality_member_policy 속성에 따라 노드를 선택하여 statement를 실행한다.

PreparedStatement나 CallableStatement class의 경우, sharding key 정보가 구축되어 있지 않으면 임의의 서버로부터 해당 SQL의 sharding key 정보를 구축한다. Sharding key 정보가 구축되어 있으면 sharding key 정보나 locality_group_policy, locality_member_policy를 이용하여 적합한 노드를 선택해 질의를 수행한다.

선택된 노드에 장애가 발생하면 해당 노드를 제외하고 적합한 노드를 다시 선택하여 질의를 수행한다.

Statement를 실행한 후에 sharding 정보가 변경되면 구축된 sharding key 정보를 삭제한다.

Statement를 실행한 후에 클러스터 노드가 추가/ 삭제되는 등 클러스터 시스템 정보가 변경되면 구축된 클러스터 시스템 정보를 삭제한다.

• ResultSet 데이터 수신

SQL이 수행된 노드로부터 데이터를 가지고 온다.

• ResultSet 닫기

SQL이 수행된 노드에서 커서를 닫는다.

• Statement 닫기

연결된 모든 노드에서 statement를 해제한다.

• 데이터베이스 닫기

모든 노드와의 접속을 해제한다.

고가용성을 위한 예외 처리

Global connection을 사용할 때 운영 중 선택된 노드에 장애가 발생하면 트랜잭션 발생 및 SELECT 진행 여부에 따라 다음과 같이 동작한다.

• 트랜잭션이 없는 경우

트랜잭션이 아직 없는 경우 선택된 노드에 장애가 발생하면 JDBC 내부에서 다른 노드를 선택하여 해당 질의를 수행한다. 선택된 노드에 장애가 발생했지만 다른 노드에서 정상적으로 수행했으므로 사용자에게 에러를 전달하지 않는다.

• 트랜잭션이 있거나 SELECT 진행중일 경우

트랜잭션이 발생하였거나 ResultSet.next() 진행 중 선택된 노드에 장애가 발생하였을 경우, JDBC는 현재 작업을 더 이상 진행할 수 없어 21047(Retry the transactional operations again) 에러를 전달한다. 21047 에러가 발생하면 사용자는 해당 트랜잭션을 다시 수행하거나 SELECT를 다시 수행해야 한다.

PreparedStatement pstmt = con.prepareStatement("INSERT INTO T1 VALUES (?)");

boolean retry;

do
{
    retry = false;

    try
    {
        pstmt.setInt(1, 1);
        pstmt.executeUpdate();
    }
    catch (SQLException e)
    {
        if (e.getErrorCode() == 21047)
        {
            retry = true;
        }
        else
        {
            throw e;
        }       
    }
} while (retry == true);

PreparedStatement pstmt = con.prepareStatement("SELECT * FROM T1 WHERE C1 = ?");

boolean retry;

do
{
    retry = false;

    try
    {
        pstmt.setInt(1, 1);
        ResultSet rs = pstmt.executeQuery();
        while (rs.next())
        {
            ...
        }
        rs.close();
    }
    catch (SQLException e)
    {
        if (e.getErrorCode() == 21047)
        {
            retry = true;
        }
        else
        {
            throw e;
        }       
    }
} while (retry == true);

• 트랜잭션을 COMMIT 하거나 ROLLBACK 할 때

트랜잭션을 COMMIT 할 때 선택된 노드에 장애가 발생하면 JDBC는 선택된 노드에 장애가 발생 전에 트랜잭션이 COMMIT 되었는지 여부를 다른 노드를 통해 확인한다. 만약 선택된 노드에 장애가 발생하였지만 트랜잭션이 정상적으로 COMMIT 되었을 경우에는 에러를 전달하지 않는다. 또한 트랜잭션이 COMMIT 되지 않은 상태에서 선택된 노드에 장애가 발생하면 21047(Retry the transactional operations again) 에러를 전달한다. 21047 에러가 발생하면 사용자는 해당 트랜잭션을 다시 수행해야 한다.

트랜잭션을 ROLLBACK 할 때 선택된 노드에 장애가 발생하면 JDBC가 에러를 전달하지 않는다. 노드 장애로 인해 해당 트랜잭션이 이미 ROLLBACK 되었기 때문이다.

con.setAutoCommit(false);

PreparedStatement pstmt = con.prepareStatement("INSERT INTO T1 VALUES (?)");

boolean retry;

do
{
    retry = false;

    try
    {
        pstmt.setInt(1, 1);
        pstmt.executeUpdate();
        con.commit();
    }
    catch (SQLException e)
    {
        if (e.getErrorCode() == 21047)
        {
            retry = true;
        }
        else
        {
            throw e;
        }       
    }
} while (retry == true);

제약 사항

• PreparedStatement와 CallableStatement class만 SQL에 적합한 노드를 찾을 수 있다.

Statement class에는 질의에 적합한 노드를 찾기 위한 정보가 없기 때문에 locality_group_policy와 locality_member_policy 속성에 따라 노드를 선택한다.

• 트랜잭션을 COMMIT 하거나 ROLLBACK 하려면 Connection.commit(). Connection.rollback()를 사용해야 한다.

GLOBAL CONNECTION을 사용할 때 SQL 구문으로 COMMIT이나 ROLLBACK을 수행하면 트랜잭션 상태 변화를 감지할 수 없다. 트랜잭션을 COMMIT 하거나 ROLLBACK 하려면 반드시 Connection.commit(). Connection.rollback()을 사용해야 한다.

• Global Session 기능은 SQL 구문중 DDL(Data Definition Language)을 지원하지 않는다.

Statement Pooling

GOLDILOCKS는 statement pooling 기능을 지원한다. Statement pooling은 반복문이나 반복적으로 호출되는 메소드와 같이 반복적으로 사용되는 statement를 pooling 하여 성능을 향상시키는 기능이다. JDBC 3.0에서 statement pooling 인터페이스를 정의한다.

응용 프로그램은 statement pool을 사용하여 특정 connection과 관련된 statement를 pooling 한다. 각 connection 객체는 자신의 pool을 갖는다. GoldilocksConnection에는 statement pool을 활성화하는 메소드가 포함되어 있다. Statement pool을 사용하면 statement 객체는 close 메소드가 호출될 때 pooling 된다.

설명

Statement pool을 활성화하고 statement 객체의 close 메소드를 호출하면 GOLDILOCKS JDBC 드라이버는 자동으로 statement, PreparedStatement, CallableStatement를 pooling 한다. PreparedStatement, CallableStatement 객체는 SQL 문자열을 키 값으로 사용하여 pooling 한다. JDBC 드라이버는 PreparedStatement나 CallableStatement를 생성할 때 pool에서 이들을 자동으로 비교/ 검색한다.

비교 기준은 다음과 같다.

• SQL 문자열이 동일해야 한다.

• Statement 타입이 동일해야 한다.

• Result set의 속성이 동일해야 한다.

Statement 객체의 SQL 문자열이 변경될 수 있기 때문에 pooling을 위해 SQL 문자열이 사용되지 않고 JDBC 드라이버에서 자동으로 처리한다.

Pool에서 검색하는 도중에 일치하는 statement를 발견하면 이를 반환하고 발견하지 못하면 새 statement가 생성된다. 두 경우 모두 객체의 close 메소드를 호출하면 statement와 커서 및 상태가 pooling 된다. 다만 statement는 closed 상태가 된다. Closed 상태의 statement를 다시 사용하려면 SQL 문자열과 statement 타입, result set 속성이 모두 동일한 statement를 생성해야 한다.

Pooling 된 PreparedStatement와 CallableStatement 객체가 검색되면 상태와 데이터 정보는 자동으로 다시 초기화된 후 기본값으로 재설정된다. Statement pool이 가득차면 LRU 알고리즘으로 pool에서 제거된다. Statement pool에 저장된 statement들은 connection 객체의 close 메소드를 호출해야 정리할 수 있다.

사용

Statement Pool 활성화

Connection 객체의 statement pool을 사용하려면 STATEMENT_POOL_ON과 STATEMENT_POOL_SIZE 프로퍼티를 설정해야 한다. STATEMENT_POOL_ON 프로퍼티를 활성화하더라도 STATEMENT_POOL_SIZE의 기본값이 0이기 때문에 반드시 0 보다 큰 숫자를 사용해야 한다.

Properties 객체에 STATEMENT_POOL_ON과 STATEMENT_POOL_SIZE 프로퍼티를 추가하여 statement pool 기능을 활성화 할 수 있다. 그리고 이외에 GoldilocksDataSource API와 GoldilocksConnection API를 통해서도 statement pool을 활성화 할 수 있다.

GoldilocksDataSource를 통한 활성화

GoldilocksDataSource 클래스를 이용하면 모든 connection 객체는 동일한 STATEMENT_POOL_SIZE를 갖는 statement pool을 갖게 된다.

• setStatementPoolOn(true) 메소드를 호출한다.

• setStatementPoolsize 메소드를 호출한다.

GoldilocksDataSource sDataSource = new GoldilocksDataSource();

sDataSource.setStatementPoolOn( true );
sDataSource.setStatementPoolSize( 10 );

다음과 같이 프로퍼티 설정값을 확인할 수 있다.

System.out.println("Statement Pool on:" + sDataSource.getStatementPoolOn());
System.out.println("Statement Pool size:" + sDataSource.getStatementPoolSize());

GoldilocksConnection을 통한 활성화

GoldilocksConnection 클래스를 이용하면 다른 객체와는 별개로 statement pool을 활성화할 수 있다.

• setStatementPoolOn(true) 메소드를 호출한다.

• setStatementpoolSize 메소드를 호출한다.

GoldilocksConnection sCon = sDataSource.getConnection();

sCon.setStatementPoolOn( true );
sCon.setStatementPoolSize( 10 );

다음과 같이 프로퍼티 설정값을 확인할 수 있다.

System.out.println("Statement Pool on:" + sCon.getStatementPoolOn());
System.out.println("Statement Pool size:" + sCon.getStatementPoolSize());

Statement Pool 비활성화

활성화된 statement pool를 비활성화할 수 있다. 활성화 된 상태에서 비활성화 상태로 변경하면 statement pool에 저장된 statement들이 제거되면서 close 된다.

setStatementPoolOn 메소드를 이용한 비활성화

sCon.setStatementPoolOn(false);

setStatementPoolSize 메소드를 이용한 비활성화

sCon.setStatementPoolSize(0);

Statement 생성

Statement pool이 활성화된 상태에서 statement, PreparedStatement, CallableStatement를 생성하는 방식은 일반적인 생성 방식과 동일하다.

다음은 새 statement 객체를 생성하는 코드이다.

PreparedStatement sPstmt = sCon.prepareStatement( "INSERT INTO EMP VALUES ( ?, ? )" );

특정 Statement 비활성화

Statement pool을 활성화하면 GOLDILOCKS JDBC 드라이버가 자동으로 모든 statement를 pooling 한다. setPoolable 메소드를 사용하면 특정 statement를 pooling에서 제외할 수 있다.

다음은 isPoolable 메소드와 setPoolable 메소드로 pooling 여부를 확인하는 예이다.

PreparedStatement sPstmt = sCon.prepareStatement( "SELECT 1 FROM DUAL" );
System.out.println( "Is poolable: " + sPstmt.isPoolable() );
sPstmt.setPoolable( false );
System.out.println( "Is poolable: " + sPstmt.isPoolable() );

JDBC API References

Array

클래스가 구현되지 않았다.

free

void free() throws SQLException

getArray

Object getArray() throws SQLException

Object getArray(Map<String,Class<?>> map) throws SQLException

Object getArray(long index, int count) throws SQLException

Object getArray(long index, int count, Map<String,Class<?>> map) throws SQLException

getBaseType

int getBaseType() throws SQLException

getBaseTypeName

String getBaseTypeName() throws SQLException

getResultSet

ResultSet getResultSet() throws SQLException

ResultSet getResultSet(Map<String,Class<?>> map) throws SQLException

ResultSet getResultSet(long index, int count) throws SQLException

ResultSet getResultSet(long index, int count, Map<String,Class<?>> map) throws SQLException

Blob

클래스가 구현되지 않았다.

free

void free() throws SQLException

getBinaryStream

InputStream getBinaryStream() throws SQLException

InputStream getBinaryStream(long pos, long length) throws SQLException

getBytes

byte[] getBytes(long pos, int length) throws SQLException

length

long length() throws SQLException

position

long position(byte[] pattern, long start) throws SQLException

long position(Blob pattern, long start) throws SQLException

setBinaryStream

OutputStream setBinaryStream(long pos) throws SQLException

setBytes

int setBytes(long pos, byte[] bytes) throws SQLException

int setBytes(long pos, byte[] bytes, int offset, int len) throws SQLException

truncate

void truncate(long len) throws SQLException

CallableStatement

getArray

Array getArray(int parameterIndex) throws SQLException

• 동작: Array 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Array getArray(String parameterName) throws SQLException

• 동작: Array 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getBigDecimal

BigDecimal getBigDecimal(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 BigDecimal 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

BigDecimal getBigDecimal(int parameterIndex, int scale) throws SQLException

• 동작: 구현되어 있지 않다. (Deprecated 된 method이다.)

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

BigDecimal getBigDecimal(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getBlob

Blob getBlob(int parameterIndex) throws SQLException

• 동작: Blob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Blob getBlob(String parameterName) throws SQLException

• 동작: Blob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getBoolean

boolean getBoolean(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 boolean 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

boolean getBoolean(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getByte

byte getByte(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 byte 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있다면 SQLException이 발생한다.

byte getByte(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getBytes

byte[] getBytes(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 byte[] 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

byte[] getBytes(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getCharacterStream

Reader getCharacterStream(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 reader 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Reader getCharacterStream(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getClob

Clob getClob(int parameterIndex) throws SQLException

• 동작: Clob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Clob getClob(String parameterName) throws SQLException

• 동작: Clob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getDate

Date getDate(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 date 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Date 객체를 만들 때 local timezone과 locale을 사용한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Date getDate(int parameterIndex, Calendar cal) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 date 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Date 객체를 만들 때 cal의 timezone과 locale을 사용한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Date getDate(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Date getDate(String parameterName, Calendar cal) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getDouble

double getDouble(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 double 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

double getDouble(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getFloat

float getFloat(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 float 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

float getFloat(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getInt

int getInt(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 int 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

int getInt(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getLong

long getLong(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 long 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

long getLong(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getNCharacterStream

Reader getNCharacterStream(int parameterIndex) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Reader getNCharacterStream(String parameterName) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getNClob

NClob getNClob(int parameterIndex) throws SQLException

• 동작: NClob 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

NClob getNClob(String parameterName) throws SQLException

• 동작: NClob 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getNString

String getNString(int parameterIndex) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

String getNString(String parameterName) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getObject

Object getObject(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 Java 객체 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Object getObject(int parameterIndex, Map<String,Class<?>> map) throws SQLException

• 동작: 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Object getObject(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Object getObject(String parameterName, Map<String,Class<?>> map) throws SQLException

• 동작: 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getRef

Ref getRef(int parameterIndex) throws SQLException

• 동작: Ref 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Ref getRef(String parameterName) throws SQLException

• 동작: Ref 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getRowId

RowId getRowId(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 rowId 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

RowId getRowId(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getShort

short getShort(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 short 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

short getShort(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getSQLXML

SQLXML getSQLXML(int parameterIndex) throws SQLException

• 동작: SQLXML 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

SQLXML getSQLXML(String parameterName) throws SQLException

• 동작: SQLXML 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getString

String getString(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 string 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

String getString(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getTime

Time getTime(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 time 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Time 객체를 만들 때, local timezone을 사용한다.

• parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Time getTime(int parameterIndex, Calendar cal) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 time 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Time 객체를 만들 때, cal의 timezone을 사용한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Time getTime(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Time getTime(String parameterName, Calendar cal) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getTimestamp

Timestamp getTimestamp(int parameterIndex) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 timestamp 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Timestamp 객체를 만들 때, local timezone을 사용한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Timestamp getTimestamp(int parameterIndex, Calendar cal) throws SQLException

• 동작: parameterIndex 번째 column의 데이터를 timestamp 타입으로 얻는다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Timestamp 객체를 만들 때, cal의 timezone을 사용한다.

• 예외: parameterIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우, SQLException이 발생한다.

Timestamp getTimestamp(String parameterName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Timestamp getTimestamp(String parameterName, Calendar cal) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getURL

URL getURL(int parameterIndex) throws SQLException

• 동작: URL 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

URL getURL(String parameterName) throws SQLException

• 동작: URL 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

registerOutParameter

void registerOutParameter(int parameterIndex, int sqlType) throws SQLException

• 동작: parameterIndex 위치에 있는 OUT 매개 변수를 sqlType으로 등록한다. 모든 out 매개 변수는 stored procedure가 실행되기 전에 등록되어야 한다. sqlType으로 지정된 out 매개 변수의 JDBC 타입은 매개 변수 값을 읽기 위해 get method에 사용되는 Java 타입을 결정한다. GOLDILOCKS 타입별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: parametrIndex가 유효하지 않거나, database에 접근할 수 없거나 CallableStatement가 이미 닫혀 있을 경우 SQLException이 발생한다. GOLDILOCKS가 지원하지 않는 타입에 대해서는 SQLFeatureNotSupprtedException이 발생한다.

void registerOutParameter(int parameterIndex, int sqlType, int scale) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void registerOutParameter(int parameterIndex, int sqlType, String typeName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void registerOutParameter(String parameterName, int sqlType) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void registerOutParameter(String parameterName, int sqlType, int scale) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void registerOutParameter(String parameterName, int sqlType, String typeName) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setAsciiStream

void setAsciiStream(String parameterName, InputStream x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setAsciiStream(String parameterName, InputStream x, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setBigDecimal

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setBinaryStream

void setBinaryStream(String parameterName, InputStream x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setBinaryStream(String parameterName, InputStream x, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setBlob

void setBlob(String parameterName, Blob x) throws SQLException

• 동작: Blob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

void setBlob(String parameterName, InputStream inputStream) throws SQLException

• 동작: Blob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException

• 동작: Blob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

setBoolean

void setBoolean(String parameterName, boolean x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setByte

void setByte(String parameterName, byte x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setBytes

void setBytes(String parameterName, byte[] x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setCharacterStream

void setCharacterStream(String parameterName, Reader reader) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setCharacterStream(String parameterName, Reader reader, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setClob

void setClob(String parameterName, Clob x) throws SQLException

• 동작: Clob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

void setClob(String parameterName, Reader reader) throws SQLException

• 동작: Clob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

void setClob(String parameterName, Reader reader, long length) throws SQLException

• 동작: Clob 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

setDate

void setDate(String parameterName, Date x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setDate(String parameterName, Date x, Calendar cal) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setDouble

void setDouble(String parameterName, double x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setFloat

void setFloat(String parameterName, float x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setInt

void setInt(String parameterName, int x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setLong

void setLong(String parameterName, long x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNCharacterStream

void setNCharacterStream(String parameterName, Reader value) throws SQLException

• 동작: NChar는 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException

• 동작: NChar는 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNClob

void setNClob(String parameterName, NClob value) throws SQLException

• 동작: NClob은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setNClob(String parameterName, Reader reader) throws SQLException

• 동작: NClob은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setNClob(String parameterName, Reader reader, long length) throws SQLException

• 동작: NClob은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNString

void setNString(String parameterName, String value) throws SQLException

• 동작: NChar는 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNull

void setNull(String parameterName, int sqlType) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

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

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setObject

void setObject(String parameterName, Object x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

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

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setRowId

void setRowId(String parameterName, RowId x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setShort

void setShort(String parameterName, short x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setSQLXML

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

• 동작: SQLXML 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setString

void setString(String parameterName, String x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setTime

void setTime(String parameterName, Time x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setTime(String parameterName, Time x, Calendar cal) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setTimestamp

void setTimestamp(String parameterName, Timestamp x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setURL

void setURL(String parameterName, URL val) throws SQLException

• 동작: URL 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

wasNull

boolean wasNull()

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface)

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

unwrap

boolean isWrapperFor(Class<?> iface)

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

Clob

클래스가 구현되지 않았다.

free

void free() throws SQLException

getAsciiStream

InputStream getAsciiStream() throws SQLException

getCharacterStream

Reader getCharacterStream() throws SQLException

Reader getCharacterStream(long pos, long length) throws SQLException

getSubString

String getSubString(long pos, int length) throws SQLException

length

long length() throws SQLException

position

long position(Clob searchstr, long start) throws SQLException

long position(String searchstr, long start) throws SQLException

setAsciiStream

OutputStream setAsciiStream(long pos) throws SQLException

setCharacterStream

Writer setCharacterStream(long pos) throws SQLException

setString

int setString(long pos, String str) throws SQLException

int setString(long pos, String str, int offset, int len) throws SQLException

truncate

void truncate(long len) throws SQLException

CommonDataSource

getLoginTimeout

int getLoginTimeout() throws SQLException

• 동작: 설정된 login timeout 값을 반환한다. Login timeout은 서버와 소켓을 연결할 때 timeout 값으로 사용된다. 설정되지 않은 경우, 0을 반환한다. 0은 무한 대기를 의미한다.

• 예외: 발생하지 않는다.

getLogWriter

PrintWriter getLogWriter() throws SQLException

• 동작: 이 DataSource에 설정된 log writer를 반환한다. 설정되지 않은 경우 null을 반환한다. Log writer는 각종 trace log를 기록할 PrintWriter를 의미한다. 자세한 내용은 로깅을 참조한다.

• 예외: 발생하지 않는다.

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

• 동작: Login timeout 값을 설정한다. Login timeout은 서버와 소켓을 연결할 때 timeout 값으로 사용된다. 0은 무한 대기를 의미한다.

• 예외: 발생하지 않는다.

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

• 이 DataSource에 log writer를 설정한다. 설정하지 않으면 기본적으로 null이다. Log writer는 각종 trace log를 기록할 PrintWriter를 의미한다. 이 값을 설정하면 옵션에 따라 trace log, query log, protocol log를 기록하는데, 이 DataSource로부터 생성된 connection 객체와 그로부터 생성되는 모든 statement, ResultSet 등의 객체들이 로깅을 수행한다. Trace log, query log, protocol log 옵션은 connection URL이나 property에 명시할 수 있다. 자세한 내용은 로깅을 참조한다.

• 예외: 발생하지 않는다.

setDataSourceName

void setDataSourceName(String aDataSourceName)

• 동작: Data source 이름을 설정한다. 연결에 필요한 정보는 아니다. 단지 객체를 구별하기 위해 별도로 부여할 수 있는 정보이다.

• 예외: 발생하지 않는다.

setServerName

void setServerName(String aServerName)

• 동작: 서버 이름, 즉 연결 URL을 설정한다. 연결에 필요한 필수 정보이다.

• 예외: 발생하지 않는다.

setDatabaseName

void setDatabaseName(String aDBName)

• 동작: 데이터베이스 이름을 설정한다. 연결에 필요한 필수 정보이다.

• 예외: 발생하지 않는다.

setNetworkProtocol

void setNetworkProtocol(String aProtocol)

• 동작: 네트워크 프로토콜 정보이다. 연결에 필요한 정보는 아니다.

• 예외: 발생하지 않는다.

setUser

void setUser(String aUser)

• 동작: 연결 계정 이름을 설정한다. 연결에 필요한 필수 정보이다.

• 예외: 발생하지 않는다.

setPassword

void setPassword(String aPassword)

• 동작: 연결 계정 password를 설정한다. 연결에 필요한 필수 정보이다.

• 예외: 발생하지 않는다.

setPortNumber

void setPortNumber(int aPort)

• 동작: 서버에 접속할 때 사용할 포트 번호를 설정한다. 연결에 필요한 필수 정보이다.

• 예외: 발생하지 않는다.

void setPortNumber(String aPort)

• 동작: 서버에 접속할 때 사용할 포트 번호를 설정한다. 연결에 필요한 필수 정보이다.

• 예외: 발생하지 않는다.

setRoleName

void setRoleName(String aRoleName)

• 동작: 서버에 접속할 때의 role을 명시한다. 연결에 필요한 필수 정보는 아니지만 연결 관련 정보이다. ""나 "ADMIN", "SYSDBA" 중의 하나를 명시한다.

• 예외: 발생하지 않는다.

setDescription

void setDescription(String aDescription)

• 동작: 이 data source에 대한 설명을 설정한다. 연결에 사용되지 않는다.

• 예외: 발생하지 않는다.

setConnectionProperties

void setConnectionProperties(Properties aProps)

• 동작: 각종 연결에 사용될 수 있는 속성을 정의한다.

• 예외: 발생하지 않는다.

setURL

void setURL(String aURL) throws SQLException

• 동작: URL 형태로 serverName, portNumber, databaseName을 지정해준다. DriverManager를 통해서 연결할 때와 똑같은 URL을 취한다.

• 예외: 잘못된 형식이면 SQLException이 발생한다.

void setUrl(String aUrl) throws SQLException

setURL(String aURL)과 동일하다.

setLogTarget

void setLogTarget(String aTarget)

• 동작: setLogWriter를 호출할 수 없을 경우 이 method를 통해 log writer를 설정할 수 있다. 현재는 aTarget이 "console"인 경우에만 지원된다. 다른 값은 무시된다. "console"로 설정하면 이 DataSource로부터 생성되는 모든 connection 객체 이하의 로깅들이 콘솔로 출력된다.

• 예외: 발생하지 않는다.

setTraceLog

void setTraceLog(String aMode)

• 동작: Trace log를 설정한다. aMode가 on 이면 trace logging이 켜진다.

• 예외: 발생하지 않는다.

setQueryLog

void setQueryLog(String aMode)

• 동작: Query log를 설정한다. aMode가 on 이면 query logging이 켜진다.

• 예외: 발생하지 않는다.

setProtocolLog

void setProtocolLog(String aMode)

• 동작: Protocol log를 설정한다. aMode가 on 이면 protocol logging이 켜진다.

• 예외: 발생하지 않는다.

Connection

clearWarnings

void clearWarnings() throws SQLException

• 동작: 현재 connection 객체가 가지고 있는 warning 객체(들)을 제거한다.

• 예외: 발생하지 않는다.

close

void close() throws SQLException

• 동작: 현재 connection을 더 이상 사용하지 않기 위해 GOLDILOCKS와의 연결을 끊고 이 객체로부터 만든 모든 statement 객체를 close한다. 이미 close되어 있으면 아무런 동작도 하지 않는다.

• 예외: 서버에서 에러가 발생하거나 응답이 없는 경우, 예외가 발생할 수 있다.

commit

void commit() throws SQLException

• 동작: Non-auto commit 모드일 경우 현재 connection에 대해 commit을 수행한다.

• 예외: 이미 close되어 있거나 auto commit 모드일 경우 SQLException이 발생한다.

createArrayOf

Array createArrayOf(String typeName, Object[] elements) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

createBlob

Blob createBlob() throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

createClob

Clob createClob() throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

createNClob

NClob createNClob() throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

createSQLXML

SQLXML createSQLXML() throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

createStatement

Statement createStatement() throws SQLException

• 동작: Statement 객체를 생성한다. 이 statement로부터 생성되는 ResultSet의 타입은 ResultSet.TYPE_FORWARD_ONLY이며, concurrency는 ResultSet.CONCUR_READ_ONLY, holdability는 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 이미 close된 경우에는 SQLException이 발생한다.

Statement createStatement(int resultSetType, int resultSetConcurrency) throws SQLException

• 동작: 사용자가 지정한 resultset type과 resultset concurrency를 가지는 ResultSet을 생성하는 statement 객체를 생성한다. 이 statement 객체로부터 생성되는 ResultSet의 holdability는 connection의 holdability 타입과 동일하다. Connection의 기본 holdability 값은 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 이미 close된 경우에는 SQLException이 발생한다.

Statement createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException

• 동작: 사용자가 지정한 resultset type, resultset concurrency, holdability를 가지는 ResultSet을 생성하는 statement 객체를 생성한다.

• 예외: 이미 close된 경우에는 SQLException이 발생한다.

createStruct

Struct createStruct(String typeName, Object[] attributes) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getAutoCommit

boolean getAutoCommit() throws SQLException

• 동작: 현재 auto commit 모드를 반환한다. setAutoCommit()을 호출한 적이 없다면 true를 반환한다.

• 예외: 발생하지 않는다.

getCatalog

String getCatalog() throws SQLException

• 동작: 데이터베이스의 현재 카탈로그 이름을 얻어온다.

• 예외: 서버로부터 에러가 발생하거나 응답이 없는 경우 SQLException이 발생한다.

getClientInfo

Properties getClientInfo() throws SQLException

• 동작: 사용자가 설정한 client 정보를 반환한다. 설정한 정보가 없으면 null을 반환한다.

• 예외: 발생하지 않는다.

String getClientInfo(String name) throws SQLException

• 동작: 사용자가 설정한 특정 client 정보를 반환한다. 설정한 정보가 없으면 null을 반환한다.

• 예외: 발생하지 않는다.

getHoldability

int getHoldability() throws SQLException

• 동작: 이 객체로부터 만들어지는 statement들의 기본 holdability 값을 반환한다. 기본값은 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 발생하지 않는다.

getMetaData

DatabaseMetaData getMetaData() throws SQLException

• 동작: 이 객체로부터 메타 정보를 조회할 수 있는 DatabaseMetaData 객체를 얻는다. 항상 동일한 객체가 반환된다.

• 예외: 이미 close되어 있을 경우 SQLException이 발생한다.

getNetworkTimeout

int getNetworkTimeout() throws SQLException

• 동작: 현재 network timeout (밀리초)을 반환한다. 0은 타임아웃 제한이 없음을 의미한다.

• 예외: Connection이 이미 close 된 경우, SQLException이 발생한다.

• Since: 1.7

getTransactionIsolation

int getTransactionIsolation() throws SQLException

• 동작: 현재 세션 (connection)에 설정되어 있는 transaction isolation level을 얻는다. 서버에 설정된 기본값은 Connection.TRANSACTION_READ_COMMITTED이다.

• 예외: 서버로부터 에러를 응답받는 경우 SQLException이 발생한다.

getTypeMap

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

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getWarnings

SQLWarning getWarnings() throws SQLException

• 동작: 현재까지 connection 객체가 서버로부터 응답받은 warning을 반환한다. 존재하지 않거나 clearWarnings()를 한 후라면 null을 반환한다.

• 예외: 발생하지 않는다.

isClosed

boolean isClosed() throws SQLException

• 동작: close()를 성공적으로 호출한 적이 있는지 여부를 묻는다. close()를 성공적으로 수행했을 경우 true를 반환하고 그렇지 않다면 false를 반환한다.

• 예외: 발생하지 않는다.

isReadOnly

boolean isReadOnly() throws SQLException

• 동작: 이 세션 (connection)이 read-only 모드일 경우 true를, 그렇지 않을 경우 false를 반환한다. 기본값은 false이다. 서버와의 통신이 발생한다.

• 예외: 서버로부터 에러를 응답받거나 응답이 없는 경우 SQLException이 발생한다.

isValid

boolean isValid(int timeout) throws SQLException

• 동작: isClosed()가 true를 반환할 상태이거나 heart beat query를 서버로 보내 성공적으로 수행에 대한 응답을 받지 못할 경우 false를, 아닌 경우엔 true를 반환한다.

• 예외: 발생하지 않는다.

nativeSQL

String nativeSQL(String sql) throws SQLException

• 동작: 주어진 사용자 SQL 문에 대해 서버에서 인식하는 native SQL을 반환한다. GOLDILOCKS에서는 사용자의 SQL 문을 서버가 있는 그대로 인식하기 때문에 항상 사용자가 부여한 값 그대로를 반환한다.

• 예외: 발생하지 않는다.

prepareCall

CallableStatement prepareCall(String sql) throws SQLException

• 동작: Stored procedures 호출을 위한 CallableStatement 객체를 사용자에게 반환한다. 이 CallableStatement로부터 생성되는 ResultSet의 type은 ResultSet.TYPE_FORWARD_ONLY이고 concurrency는 ResultSet.CONCUR_READ_ONLY, holdability는 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 이미 close 되었거나 SQL 문이 잘못된 경우, SQLException이 발생한다.

CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency) throws SQLException

• 동작: 사용자가 지정한 resultset type과 resultset concurrency를 가지는 ResultSet을 생성하는 CallableStatement 객체를 생성한다. 이 CallableStatement 로부터 생성되는 ResultSet의 holdability는 connection의 holdability 타입과 동일하다. Connection의 기본 holdability 값은 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 이미 close되었거나 SQL 문이 잘못된 경우, SQLException이 발생한다.

CallableStatement prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException

• 동작: 사용자가 지정한 resultset type과 resultset concurrency, holdability를 가지는 ResultSet을 생성하는 CallableStatement 객체를 생성한다.

• 예외: 이미 close되었거나 SQL 문이 잘못된 경우, SQLException이 발생한다.

prepareStatement

PreparedStatement prepareStatement(String sql) throws SQLException

• 동작: 서버에 SQL 문을 보내어 prepare (parsing, validation, optimization)하고, 그 prepared statement를 제어할 수 있는 PreparedStatement 객체를 사용자에게 반환한다. 이 PreparedStatement로부터 생성되는 ResultSet의 type은 ResultSet.TYPE_FORWARD_ONLY이며, concurrency는 ResultSet.CONCUR_READ_ONLY, holdability는 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 이미 close되었거나 SQL 문이 잘못되었을 경우, SQLException이 발생한다.

PreparedStatement prepareStatement(String sql, int autoGeneratedKeys) throws SQLException

• 동작: autoGeneratedKeys가 Statement.NO_GENERATED_KEYS일 경우 prepareStatement(String sql) method와 동일하게 동작한다. 그 외의 값에 대해서는 예외가 발생한다.

• 예외: 이미 close되었거나 SQL 문이 잘못되었을 경우, 그리고 autoGeneratedKeys 값이 Statement.NO_GENERATED_KEYS도 아니고 Statement.RETURN_GENERATED_KEYS도 아닌 경우에는 SQLException이 발생한다. autoGeneratedKeys가 Statement.RETURN_GENERATED_KEYS인 경우에는 SQLFeatureNotSupportedException이 발생한다.

PreparedStatement prepareStatement(String sql, int[] columnIndexes) throws SQLException

• 동작: columnIndexes가 null일 경우 prepareStatement(String sql) method와 동일하게 동작한다. 그 외의 값에 대해서는 예외가 발생한다.

• 예외: 이미 close되었거나 SQL 문이 잘못되었을 경우, SQLException이 발생한다. columnIndexes가 null이 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency) throws SQLException

• 동작: 서버에 SQL 문을 보내어 prepare (parsing, validation, optimization)하고, 그 prepared statement를 제어할 수 있는 PreparedStatement 객체를 사용자에게 반환한다. 사용자가 지정한 resultset type과 resultset concurrency를 가지는 ResultSet을 생성하는 PreparedStatement 객체를 생성한다. 이 PreparedStatement로부터 생성되는 ResultSet의 holdability는 connection의 holdability 타입과 동일하다. Connection의 기본 holdability 값은 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 이미 close되었거나 SQL 문이 잘못되었을 경우, SQLException이 발생한다.

PreparedStatement prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability) throws SQLException

• 동작: 서버에 SQL 문을 보내어 prepare (parsing, validation, optimization)하고, 그 prepared statement를 제어할 수 있는 PreparedStatement 객체를 사용자에게 반환한다. 사용자가 지정한 resultset type과 resultset concurrency, holdability를 가지는 ResultSet을 생성하는 PreparedStatement 객체를 생성한다.

• 예외: 이미 close되었거나 SQL 문이 잘못되었을 경우, SQLException이 발생한다.

PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException

• 동작: columnNames가 null일 경우 prepareStatement(String sql) method와 동일하게 동작한다. 그 외의 값에 대해서는 예외가 발생한다.

• 예외: 이미 close되었거나 SQL 문이 잘못되었을 경우에는 SQLException이 발생한다. columnNames가 null이 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

releaseSavepoint

void releaseSavepoint(Savepoint savepoint) throws SQLException

• 동작: 해당 savepoint를 서버에서 제거한다. 이 savepoint 이후의 savepoint들도 모두 제거된다.

• 예외: 이미 close되었거나 해당 savepoint 객체가 이미 해제되었거나 GOLDILOCKS savepoint 객체가 아닌 경우 SQLException이 발생한다.

rollback

void rollback() throws SQLException

• 동작: Non auto commit 모드일 경우 현재 트랜잭션을 rollback 한다.

• 예외: 이미 close되었거나 auto commit 모드일 경우, 또는 서버로부터 에러를 응답받은 경우 SQLException이 발생한다.

void rollback(Savepoint savepoint) throws SQLException

• 동작: Non auto commit 모드일 경우 현재 트랜잭션에 대해 해당 savepoint까지 partial rollback 한다.

• 예외: 이미 close되었거나 auto commit mode일 경우, 또는 서버로부터 에러를 응답받은 경우, 그리고 해당 savepoint가 유효하지 않을 경우 SQLException이 발생한다.

setAutoCommit

void setAutoCommit(boolean autoCommit) throws SQLException

• 동작: 현재 connection에 대한 auto commit 모드를 변경한다. 수행된 트랜잭션이 있고 non auto commit 모드에서 auto commit 모드로 변경될 경우 commit이 수행된다.

• 예외: Commit 과정에서 발생할 수 있는 예외와 동일하다.

setCatalog

void setCatalog(String catalog) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setClientInfo

void setClientInfo(Properties properties) throws SQLException

• 동작: 사용자가 지정한 client 정보를 설정한다. 기존에 있던 client 정보는 없어진다. 서버에 아무런 영향을 주지 않는다.

• 예외: 발생하지 않는다.

void setClientInfo(String name, String value) throws SQLException

• 동작: 사용자가 지정한 client 정보를 추가한다. 기존에 있던 client 정보는 그대로 유지된다.

• 예외: 발생하지 않는다.

setHoldability

void setHoldability(int holdability) throws SQLException

• 동작: 이 객체로부터 생성되는 statement들이 생성하는 ResultSet의 holdability를 설정한다. 이 method를 호출하지 않았을 때의 기본값은 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 발생하지 않는다.

setNetworkTimeout

void setNetworkTimeout(Executor executor, int milliseconds) throws SQLException

• 동작: Connection 또는 connection에서 생성된 객체가 데이터베이스 요청에 대해 응답을 받을 때까지 대기하는 최대 시간을 설정한다. 지정된 시간 내에 응답이 없는 경우 SQLException이 발생하며, 해당 connection 객체는 close 상태가 된다.

• 예외: Connection이 이미 close된 경우, executor가 null인 경우, 또는 밀리초 값이 0보다 작은 경우 SQLException이 발생한다. 또한 security manager가 존재하고 checkPermission 메서드가 setNetworkTimeout 호출을 거부하는 경우 SecurityException이 발생한다.

• Since: 1.7

setReadOnly

void setReadOnly(boolean readOnly) throws SQLException

• 동작: 현재 세션 (connection)의 read-only 속성을 설정한다. 기본값은 false이다.

• 예외: 이미 close되었거나 서버로부터 에러를 응답받으면 SQLException이 발생한다.

setSavepoint

Savepoint setSavepoint() throws SQLException

• 동작: non auto commit 모드일 경우 현재 트랜잭션에 대해 savepoint를 설정한다. savepoint 이름은 내부적으로 결정된다.

• 예외: 이미 close되었거나 auto commit 모드일 경우, 또는 서버로부터 에러를 응답받은 경우에는 SQLException이 발생한다.

Savepoint setSavepoint(String name) throws SQLException

• 동작: Non auto commit 모드일 경우 현재 트랜잭션에 대해 사용자가 지정한 이름의 savepoint를 설정한다.

• 예외: 이미 close되었거나 auto commit 모드일 경우, 또는 서버로부터 에러를 응답받은 경우에는 SQLException이 발생한다.

setTransactionIsolation

void setTransactionIsolation(int level) throws SQLException

• 동작: 현재 세션 (connection)에 대해 트랜잭션 isolation level을 변경한다. 지원되는 값은 Connection.TRANSACTION_READ_COMMITED, Connection.TRANSACTION_SERIALIZABLE이다. Connection.READ_UNCOMMITTED는 Connection.TRANSACTION_READ_COMMITED으로, Connection.TRANSACTION_REPEATABLE_READ는 Connection.TRANSACTION_SERIALIZABLE으로 변경되어 설정된다.

• 예외: 이미 close되었거나 level이 올바르지 않을 경우, SQLException이 발생한다.

setTypeMap

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

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface) throws SQLException

• 동작: 이 객체가 iface 인터페이스를 구현한 클래스인지 묻는다. 맞으면 true를, 아니면 false를 반환한다. GOLDILOCKS connection 객체는 다른 클래스의 wrapper가 아니므로 wrapper 유무는 판단하지 않고 오직 주어진 인자 클래스 타입을 구현했는지 여부만 묻는다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface) throws SQLException

• 동작: GOLDILOCKS connection은 다른 클래스의 wrapper가 아니므로 unwrap하더라도 결국 자기 자신을 반환한다. 해당 타입으로 캐스팅한 후 반환한다. iface가 isWrapperFor() method의 인자로 주었을 때 false를 반환하는 값일 경우, 이 method는 예외를 발생시킨다.

• 예외: iface가 이 객체 타입이 아닌 경우 (이 객체가 implement 하지 않은 타입을 부여한 경우) SQLException이 발생한다.

ConnectionPoolDataSource

getPooledConnection

PooledConnection getPooledConnection() throws SQLException

• 동작: PooledConnection 객체를 생성한다. User name, password, connection URL 등 각종 connection 정보는 사전에 setter method로 설정되어 있어야 한다.

• 예외: 연결에 실패하면 SQLException이 발생한다.

PooledConnection getPooledConnection(String user, String password) throws SQLException

• 동작: PooledConnection 객체를 생성한다. User name과 password는 argument를 따른다. 그 외 connection 정보들은 사전에 setter method로 설정되어 있어야 한다.

• 예외: 연결에 실패하면 SQLException이 발생한다.

DatabaseMetaData

allProceduresAreCallable

boolean allProceduresAreCallable() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

allTablesAreSelectable

boolean allTablesAreSelectable() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

autoCommitFailureClosesAllResultSets

boolean autoCommitFailureClosesAllResultSets() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

dataDefinitionCausesTransactionCommit

boolean dataDefinitionCausesTransactionCommit() throws SQLException

• 동작: DDL 구문을 수행할 때 자동으로 commit되지 않기 때문에 항상 false를 반환한다.

• 예외: 발생하지 않는다.

dataDefinitionIgnoredInTransactions

boolean dataDefinitionIgnoredInTransactions() throws SQLException

• 동작: DDL 구문도 트랜잭션에 포함되기 때문에 항상 false를 반환한다.

• 예외: 발생하지 않는다.

deletesAreDetected

boolean deletesAreDetected(int type) throws SQLException

• 동작: type이 ResultSet.TYPE_SCROLL_SENSITIVE이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

doesMaxRowSizeIncludeBlobs

boolean doesMaxRowSizeIncludeBlobs() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

getAttributes

ResultSet getAttributes(String catalog, String schemaPattern, String typeNamePattern, String attributeNamePattern) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getBestRowIdentifier

ResultSet getBestRowIdentifier(String catalog, String schema, String table, int scope, boolean nullable) throws SQLException

• 동작: 모든 테이블에 대해서 rowid 타입을 지원하기 때문에 rowid에 대한 정보로 구성된 row 한 개를 가진 ResultSet을 반환한다. 해당 테이블이 없을 경우, empty ResultSet을 반환한다.

• 예외: 테이블이 null이거나 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getCatalogs

ResultSet getCatalogs() throws SQLException

• 동작: 카탈로그 이름을 하나의 column으로 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getCatalogSeparator

String getCatalogSeparator() throws SQLException

• 동작: Catalog separator 문자를 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getCatalogTerm

String getCatalogTerm() throws SQLException

• 동작: Catalog term 문자를 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getClientInfoProperties

ResultSet getClientInfoProperties() throws SQLException

• 동작: Client 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getColumnPrivileges

ResultSet getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern) throws SQLException

• 동작: 해당 테이블 column의 column privilege 정보를 가지는 ResultSet을 반환한다. 해당 테이블이 없거나 column 이름 패턴에 해당하는 column이 없으면 empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getColumns

ResultSet getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern) throws SQLException

• 동작: 해당 테이블의 모든 column 정보를 가지는 ResultSet을 반환한다. 해당 테이블이 없거나 column 이름 패턴에 해당하는 column이 없으면 empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getConnection

Connection getConnection() throws SQLException

• 동작: 이 DatabaseMetaData 객체를 생성한 연결 객체를 반환한다.

• 예외: 발생하지 않는다.

getCrossReference

ResultSet getCrossReference(String parentCatalog, String parentSchema, String parentTable, String foreignCatalog, String foreignSchema, String foreignTable) throws SQLException

• 동작: 주어진 foreign key 테이블에서 주어진 parent table을 참조하는 foreign key들의 정보를 가지는 ResultSet을 반환한다. 참조 관계가 없을 경우, empty ResultSet을 반환한다.

• 예외: Foreign table이나 parent table이 null이거나 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getDatabaseMajorVersion

int getDatabaseMajorVersion() throws SQLException

• 동작: 제품의 major 버전을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getDatabaseMinorVersion

int getDatabaseMinorVersion() throws SQLException

• 동작: 제품의 minor 버전을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getDatabaseProductName

String getDatabaseProductName() throws SQLException

• 동작: 제품의 이름을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getDatabaseProductVersion

String getDatabaseProductVersion() throws SQLException

• 동작: 제품의 프로덕트 버전을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getDefaultTransactionIsolation

int getDefaultTransactionIsolation() throws SQLException

• 동작: Default transaction isolation을 반환한다. 서버에 설정된 기본값은 Connection.TRANSACTION_READ_COMMITTED이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getDriverMajorVersion

int getDriverMajorVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver의 major 버전을 반환한다.

• 예외: 발생하지 않는다.

getDriverMinorVersion

int getDriverMinorVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver의 minor 버전을 반환한다.

• 예외: 발생하지 않는다.

getDriverName

String getDriverName() throws SQLException

• 동작: "GOLDILOCKS JDBC Driver"를 반환한다.

• 예외: 발생하지 않는다.

getDriverVersion

String getDriverVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver 버전 문자열을 반환한다. 프로토콜 버전도 포함한다.

• 예외: 발생하지 않는다.

getExportedKeys

ResultSet getExportedKeys(String catalog, String schema, String table) throws SQLException

• 동작: 주어진 테이블의 column을 참조하는 foreign key들을 정보로 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getExtraNameCharacters

String getExtraNameCharacters() throws SQLException

• 동작: "-$"를 반환한다.

• 예외: 발생하지 않는다.

getFunctionColumns

ResultSet getFunctionColumns(String catalog, String schemaPattern, String functionNamePattern, String columnNamePattern) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getFunctions

ResultSet getFunctions(String catalog, String schemaPattern, String functionNamePattern) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getIdentifierQuoteString

String getIdentifierQuoteString() throws SQLException

• 동작: Identifier quote 문자를 반환한다. 서버에 설정된 값은 " 이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getImportedKeys

ResultSet getImportedKeys(String catalog, String schema, String table) throws SQLException

• 동작: 주어진 테이블의 foreign key column이 참조하는 parent key 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getIndexInfo

ResultSet getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate) throws SQLException

• 동작: 주어진 테이블에 존재하는 인덱스 정보를 가지는 ResultSet을 반환한다. Unique가 true면 unique index 정보만 보여준다. Approximate 인자는 무시된다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getJDBCMajorVersion

int getJDBCMajorVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver의 JDBC major 버전을 반환한다. 사용하는 jar 파일에 따라 다를 수 있다.

• 예외: 발생하지 않는다.

getJDBCMinorVersion

int getJDBCMinorVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver의 JDBC minor 버전을 반환한다. 사용하는 jar 파일에 따라 다를 수 있다.

• 예외: 발생하지 않는다.

getMaxBinaryLiteralLength

int getMaxBinaryLiteralLength() throws SQLException

• 동작: 바이너리의 최대 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxCatalogNameLength

int getMaxCatalogNameLength() throws SQLException

• 동작: 카탈로그 이름의 최대 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxCharLiteralLength

int getMaxCharLiteralLength() throws SQLException

• 동작: 최대 literal 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxColumnNameLength

int getMaxColumnNameLength() throws SQLException

• 동작: Column 이름의 최대 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxColumnsInGroupBy

int getMaxColumnsInGroupBy() throws SQLException

• 동작: Group by 절에 사용할 수 있는 column의 최대 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxColumnsInIndex

int getMaxColumnsInIndex() throws SQLException

• 동작: 인덱스에 사용할 수 있는 column의 최대 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxColumnsInOrderBy

int getMaxColumnsInOrderBy() throws SQLException

• 동작: Order by 절에 사용할 수 있는 column의 최대 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxColumnsInSelect

int getMaxColumnsInSelect() throws SQLException

• 동작: Select target 절에 올 수 있는 column의 최대 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxColumnsInTable

int getMaxColumnsInTable() throws SQLException

• 동작: 테이블에 올 수 있는 column의 최대 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxConnections

int getMaxConnections() throws SQLException

• 동작: 서버와의 최대 connection 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxCursorNameLength

int getMaxCursorNameLength() throws SQLException

• 동작: 커서 이름의 최대 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxIndexLength

int getMaxIndexLength() throws SQLException

• 동작: 인덱스 키 한 개가 가질 수 있는 최대 크기를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxProcedureNameLength

int getMaxProcedureNameLength() throws SQLException

• 동작: Procedure 이름의 최대 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxRowSize

int getMaxRowSize() throws SQLException

• 동작: 한 테이블이 가질 수 있는 최대 row 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxSchemaNameLength

int getMaxSchemaNameLength() throws SQLException

• 동작: 스키마 이름의 최대 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxStatementLength

int getMaxStatementLength() throws SQLException

• 동작: 하나의 SQL 문이 가질 수 있는 최대 문자열 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxStatements

int getMaxStatements() throws SQLException

• 동작: 한 번에 open할 수 있는 최대 statement 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxTableNameLength

int getMaxTableNameLength() throws SQLException

• 동작: 테이블 이름이 가질 수 있는 최대 문자열의 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxTablesInSelect

int getMaxTablesInSelect() throws SQLException

• 동작: Select 구문에 사용할 수 있는 테이블의 최대 개수를 서버로부터 얻어온다. 0은 최대 개수가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getMaxUserNameLength

int getMaxUserNameLength() throws SQLException

• 동작: User name의 최대 문자열 길이를 서버로부터 얻어온다. 0은 최대 길이가 무한대라는 의미이다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getNumericFunctions

String getNumericFunctions() throws SQLException

• 동작: SQL 표준에 해당하는 숫자 관련 함수들의 목록을 불러온다. 각 함수 이름은 콤마 (,)로 구분된다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getPrimaryKeys

ResultSet getPrimaryKeys(String catalog, String schema, String table) throws SQLException

• 동작: 주어진 테이블의 모든 primary key를 포함하는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getProcedureColumns

ResultSet getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern) throws SQLException

• 동작: 주어진 procedure들에 대해 주어진 이름 패턴을 가진 column들의 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getProcedures

ResultSet getProcedures(String catalog, String schemaPattern, String procedureNamePattern) throws SQLException

• 동작: 주어진 이름 패턴을 가지는 procedure들을 정보로 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getProcedureTerm

String getProcedureTerm() throws SQLException

• 동작: Procedure를 지칭하는 키워드를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getResultSetHoldability

int getResultSetHoldability() throws SQLException

• 동작: ResultSet의 기본 holdability 속성을 반환한다. ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: 발생하지 않는다.

getRowIdLifetime

RowIdLifetime getRowIdLifetime() throws SQLException

• 동작: 항상 RowIdLifetime.ROWID_VALID_FOREVER를 반환한다.

• 예외: 발생하지 않는다.

getSchemas

ResultSet getSchemas() throws SQLException

• 동작: 서버에 있는 모든 스키마에 대한 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

ResultSet getSchemas(String catalog, String schemaPattern) throws SQLException

• 동작: 주어진 스키마 이름의 패턴을 만족하는 모든 스키마에 대한 정보를 가지는 ResultSet을 반환한다. Catalog는 무시한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSchemaTerm

String getSchemaTerm() throws SQLException

• 동작: 스키마를 지칭하는 키워드를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSearchStringEscape

String getSearchStringEscape() throws SQLException

• 동작: Like 구문에 사용되는 escape 문자들을 문자열로 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSQLKeywords

String getSQLKeywords() throws SQLException

• 동작: SQL 문에 사용할 수 없는 키워드들을 콤마 (,)로 구분하여 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSQLStateType

int getSQLStateType() throws SQLException

• 동작: 항상 DatabaseMetaData.sqlStateSQL99를 반환한다.

• 예외: 발생하지 않는다.

getStringFunctions

String getStringFunctions() throws SQLException

• 동작: SQL 표준에 해당하는 문자열을 다루는 함수들의 목록을 불러온다. 각 함수 이름들은 콤마 (,)로 구분된다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSuperTables

ResultSet getSuperTables(String catalog, String schemaPattern, String tableNamePattern) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSuperTypes

ResultSet getSuperTypes(String catalog, String schemaPattern, String typeNamePattern) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getSystemFunctions

String getSystemFunctions() throws SQLException

• 동작: SQL 표준에 해당하는 시스템 함수들의 목록을 불러온다. 각 함수 이름들은 콤마 (,)로 구분된다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getTablePrivileges

ResultSet getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern) throws SQLException

• 동작: 해당 조건을 만족하는 모든 테이블의 privilege 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getTables

ResultSet getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types) throws SQLException

• 동작: 해당 조건을 만족하는 모든 테이블들의 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getTableTypes

ResultSet getTableTypes() throws SQLException

• 동작: 모든 테이블 타입을 정보로 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getTimeDateFunctions

String getTimeDateFunctions() throws SQLException

• 동작: SQL 표준에 해당하는 time, date 관련 함수들의 목록을 불러온다. 각 함수 이름들은 콤마 (,)로 구분된다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getTypeInfo

ResultSet getTypeInfo() throws SQLException

• 동작: 데이터 타입 정보를 가지는 ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getUDTs

ResultSet getUDTs(String catalog, String schemaPattern, String typeNamePattern, int[] types) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getURL

String getURL() throws SQLException

• 동작: 서버에 접속할 때 사용한 URL을 반환한다.

• 예외: 발생하지 않는다.

getUserName

String getUserName() throws SQLException

• 동작: 세션을 유지하고 있는 현재 user name을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

getVersionColumns

ResultSet getVersionColumns(String catalog, String schema, String table) throws SQLException

• 동작: Empty ResultSet을 반환한다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

insertsAreDetected

boolean insertsAreDetected(int type) throws SQLException

• 동작: Type과 상관없이 항상 false를 반환한다.

• 예외: 발생하지 않는다.

isCatalogAtStart

boolean isCatalogAtStart() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

isReadOnly

boolean isReadOnly() throws SQLException

• 동작: 현재 연결이 read-only 모드인지 여부에 대한 정보를 서버로부터 얻어온다.

• 서버로부터 에러를 응답받으면 SQLException이 발생한다.

locatorsUpdateCopy

boolean locatorsUpdateCopy() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

nullPlusNonNullIsNull

boolean nullPlusNonNullIsNull() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

nullsAreSortedAtEnd

boolean nullsAreSortedAtEnd() throws SQLException

• 동작: 항상 false를 반환한다. null만 따로 정렬하지 않는다.

• 예외: 발생하지 않는다.

nullsAreSortedAtStart

boolean nullsAreSortedAtStart() throws SQLException

• 동작: 항상 false를 반환한다. null만 따로 정렬하지 않는다.

• 예외: 발생하지 않는다.

nullsAreSortedHigh

boolean nullsAreSortedHigh() throws SQLException

• 동작: 항상 true를 반환한다. Null은 default로 last에 위치한다.

• 예외: 발생하지 않는다.

nullsAreSortedLow

boolean nullsAreSortedLow() throws SQLException

• 동작: 항상 false를 반환한다. Null은 default로 last에 위치한다.

• 예외: 발생하지 않는다.

othersDeletesAreVisible

boolean othersDeletesAreVisible(int type) throws SQLException

• 동작: Type이 ResultSet.TYPE_SCROLL_SENSITIVE일 경우 true를, 그렇지 않은 경우에는 false를 반환한다.

• 예외: 발생하지 않는다.

othersInsertsAreVisible

boolean othersInsertsAreVisible(int type) throws SQLException

• 동작: Type과 상관없이 항상 false를 반환한다.

• 예외: 발생하지 않는다.

othersUpdatesAreVisible

boolean othersUpdatesAreVisible(int type) throws SQLException

• 동작: Type이 ResultSet.TYPE_SCROLL_SENSITIVE일 경우 true를, 그렇지 않은 경우에는 false를 반환한다.

• 예외: 발생하지 않는다.

ownDeletesAreVisible

boolean ownDeletesAreVisible(int type) throws SQLException

• 동작: Type이 ResultSet.TYPE_SCROLL_SENSITIVE일 경우 true를, 그렇지 않은 경우에는 false를 반환한다.

• 예외: 발생하지 않는다.

ownInsertsAreVisible

boolean ownInsertsAreVisible(int type) throws SQLException

• 동작: Type과 상관없이 항상 false를 반환한다.

• 예외: 발생하지 않는다.

ownUpdatesAreVisible

boolean ownUpdatesAreVisible(int type) throws SQLException

• 동작: Type이 ResultSet.TYPE_SCROLL_SENSITIVE일 경우 true를, 그렇지 않은 경우에는 false를 반환한다.

• 예외: 발생하지 않는다.

storesLowerCaseIdentifiers

boolean storesLowerCaseIdentifiers() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

storesLowerCaseQuotedIdentifiers

boolean storesLowerCaseQuotedIdentifiers() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

storesMixedCaseIdentifiers

boolean storesMixedCaseIdentifiers() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

storesMixedCaseQuotedIdentifiers

boolean storesMixedCaseQuotedIdentifiers() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

storesUpperCaseIdentifiers

boolean storesUpperCaseIdentifiers() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

storesUpperCaseQuotedIdentifiers

boolean storesUpperCaseQuotedIdentifiers() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsAlterTableWithAddColumn

boolean supportsAlterTableWithAddColumn() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsAlterTableWithDropColumn

boolean supportsAlterTableWithDropColumn() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsANSI92EntryLevelSQL

boolean supportsANSI92EntryLevelSQL() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsANSI92FullSQL

boolean supportsANSI92FullSQL() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsANSI92IntermediateSQL

boolean supportsANSI92IntermediateSQL() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsBatchUpdates

boolean supportsBatchUpdates() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsCatalogsInDataManipulation

boolean supportsCatalogsInDataManipulation() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsCatalogsInIndexDefinitions

boolean supportsCatalogsInIndexDefinitions() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsCatalogsInPrivilegeDefinitions

boolean supportsCatalogsInPrivilegeDefinitions() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsCatalogsInProcedureCalls

boolean supportsCatalogsInProcedureCalls() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsCatalogsInTableDefinitions

boolean supportsCatalogsInTableDefinitions() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsColumnAliasing

boolean supportsColumnAliasing() throws SQLException

• 동작: Column aliasing 지원 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsConvert

boolean supportsConvert() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsConvert

boolean supportsConvert(int fromType, int toType) throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsCoreSQLGrammar

boolean supportsCoreSQLGrammar() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsCorrelatedSubqueries

boolean supportsCorrelatedSubqueries() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsDataDefinitionAndDataManipulationTransactions

boolean supportsDataDefinitionAndDataManipulationTransactions() throws SQLException

• 동작: 항상 true를 반환한다. 한 트랜잭션으로 DML과 DDL을 수행할 수 있다.

• 예외: 발생하지 않는다.

supportsDataManipulationTransactionsOnly

boolean supportsDataManipulationTransactionsOnly() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsDifferentTableCorrelationNames

boolean supportsDifferentTableCorrelationNames() throws SQLException

• 동작: Table correlation 이름이 테이블 이름과 달라야 하는지 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsExpressionsInOrderBy

boolean supportsExpressionsInOrderBy() throws SQLException

• 동작: Order by 절에 수식이 사용될 수 있는지의 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsExtendedSQLGrammar

boolean supportsExtendedSQLGrammar() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsFullOuterJoins

boolean supportsFullOuterJoins() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsGetGeneratedKeys

boolean supportsGetGeneratedKeys() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsGroupBy

boolean supportsGroupBy() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsGroupByBeyondSelect

boolean supportsGroupByBeyondSelect() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsGroupByUnrelated

boolean supportsGroupByUnrelated() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsIntegrityEnhancementFacility

boolean supportsIntegrityEnhancementFacility() throws SQLException

• 동작: SQL 무결성 보강 기능을 지원하는지 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsLikeEscapeClause

boolean supportsLikeEscapeClause() throws SQLException

• 동작: Like 구문에 escape 절을 지원하는지 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsLimitedOuterJoins

boolean supportsLimitedOuterJoins() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsMinimumSQLGrammar

boolean supportsMinimumSQLGrammar() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsMixedCaseIdentifiers

boolean supportsMixedCaseIdentifiers() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsMixedCaseQuotedIdentifiers

boolean supportsMixedCaseQuotedIdentifiers() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsMultipleOpenResults

boolean supportsMultipleOpenResults() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsMultipleResultSets

boolean supportsMultipleResultSets() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsMultipleTransactions

boolean supportsMultipleTransactions() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsNamedParameters

boolean supportsNamedParameters() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsNonNullableColumns

boolean supportsNonNullableColumns() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsOpenCursorsAcrossCommit

boolean supportsOpenCursorsAcrossCommit() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsOpenCursorsAcrossRollback

boolean supportsOpenCursorsAcrossRollback() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsOpenStatementsAcrossCommit

boolean supportsOpenStatementsAcrossCommit() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsOpenStatementsAcrossRollback

boolean supportsOpenStatementsAcrossRollback() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsOrderByUnrelated

boolean supportsOrderByUnrelated() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsOuterJoins

boolean supportsOuterJoins() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsPositionedDelete

boolean supportsPositionedDelete() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsPositionedUpdate

boolean supportsPositionedUpdate() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsResultSetConcurrency

boolean supportsResultSetConcurrency(int type, int concurrency) throws SQLException

• 동작: 모든 ResultSet 타입과 모든 concurrency에 대해 true를, 잘못된 인자에 대해서는 false를 반환한다.

• 예외: 발생하지 않는다.

supportsResultSetHoldability

boolean supportsResultSetHoldability(int holdability) throws SQLException

• 동작: Holdability가 ResultSet.CLOSE_CURSORS_AT_COMMIT이거나 ResultSet.HOLD_CURSORS_OVER_COMMIT이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

supportsResultSetType

boolean supportsResultSetType(int type) throws SQLException

• 동작: Type이 ResultSet.TYPE_FORWARD_ONLY이거나 ResultSet.TYPE_SCROLL_INSENSITIVE 또는ResultSet.TYPE_SCROLL_SENSITIVE이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

supportsSavepoints

boolean supportsSavepoints() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSchemasInDataManipulation

boolean supportsSchemasInDataManipulation() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSchemasInIndexDefinitions

boolean supportsSchemasInIndexDefinitions() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSchemasInPrivilegeDefinitions

boolean supportsSchemasInPrivilegeDefinitions() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSchemasInProcedureCalls

boolean supportsSchemasInProcedureCalls() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSchemasInTableDefinitions

boolean supportsSchemasInTableDefinitions() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSelectForUpdate

boolean supportsSelectForUpdate() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsStatementPooling

boolean supportsStatementPooling() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsStoredFunctionsUsingCallSyntax

boolean supportsStoredFunctionsUsingCallSyntax() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

supportsStoredProcedures

boolean supportsStoredProcedures() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSubqueriesInComparisons

boolean supportsSubqueriesInComparisons() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSubqueriesInExists

boolean supportsSubqueriesInExists() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSubqueriesInIns

boolean supportsSubqueriesInIns() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsSubqueriesInQuantifieds

boolean supportsSubqueriesInQuantifieds() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsTableCorrelationNames

boolean supportsTableCorrelationNames() throws SQLException

• 동작: Table correlation 이름을 지원하는지 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsTransactionIsolationLevel

boolean supportsTransactionIsolationLevel(int level) throws SQLException

• 동작: 해당 트랜잭션의 isolation 레벨을 지원하는지 여부를 서버로부터 알아온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsTransactions

boolean supportsTransactions() throws SQLException

• 동작: 항상 true를 반환한다.

• 예외: 발생하지 않는다.

supportsUnion

boolean supportsUnion() throws SQLException

• 동작: Union 연산을 지원하는지 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

supportsUnionAll

boolean supportsUnionAll() throws SQLException

• 동작: Union all 연산을 지원하는지 여부를 서버로부터 얻어온다.

• 예외: 서버로부터 에러를 응답받으면 SQLException이 발생한다.

updatesAreDetected

boolean updatesAreDetected(int type) throws SQLException

• 동작: Type이 ResultSet.TYPE_SCROLL_SENSITIVE이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

usesLocalFilePerTable

boolean usesLocalFilePerTable() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

usesLocalFiles

boolean usesLocalFiles() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

DataSource

getConnection

Connection getConnection() throws SQLException

• 동작: 새로운 연결 객체를 열어 반환한다. 연결에 필요한 정보들은 별도의 비표준 method들로 사전에 설정되어 있어야 한다.

• 예외: 서버와의 연결에 실패하면 SQLException이 발생한다.

Connection getConnection(String username, String password) throws SQLException

• 동작: Username과 password로 새로운 연결 객체를 열어 반환한다. 연결에 필요한 그 외의 정보들은 별도의 비표준 method들로 사전에 설정되어 있어야 한다.

• 예외: 서버와의 연결에 실패하면 SQLException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface) throws SQLException

• 동작: 이 클래스는 다른 클래스의 wrapper로 구현하지 않았다. 이 객체가 iface의 instance이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface) throws SQLException

• 동작: 이 클래스는 다른 클래스의 wrapper로 구현되지 않았기 때문에 this를 반환한다.

• 예외: 이 객체가 iface의 instance가 아니면 SQLException이 발생한다.

Driver

acceptsURL

boolean acceptsURL(String url) throws SQLException

• 동작: url이 null이 아니고 "jdbc:goldilocks:"로 시작하면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

connect

Connection connect(String url, Properties info) throws SQLException

• 동작: 새로운 연결 객체를 생성하고 반환한다. url은 서버 주소, DB 이름, 포트를 포함하고 있어야 한다.

• 예외: 잘못된 url이거나 서버로부터의 연결에 성공하지 못하면 SQLException이 발생한다.

getMajorVersion

int getMajorVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver의 major 버전을 반환한다.

• 예외: 발생하지 않는다.

getMinorVersion

int getMinorVersion() throws SQLException

• 동작: GOLDILOCKS JDBC driver의 minor 버전을 반환한다.

• 예외: 발생하지 않는다.

getPropertyInfo

DriverPropertyInfo[] getPropertyInfo(String url, Properties info) throws SQLException

• 동작: GOLDILOCKS JDBC의 driver가 연결될 때 사용할 수 있는 속성의 목록을 얻어온다.

• 예외: 발생하지 않는다.

jdbcCompliant

boolean jdbcCompliant() throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: 발생하지 않는다.

NClob

클래스가 구현되지 않았다.

free

void free() throws SQLException

getAsciiStream

InputStream getAsciiStream() throws SQLException

getCharacterStream

Reader getCharacterStream() throws SQLException

Reader getCharacterStream(long pos, long length) throws SQLException

getSubString

String getSubString(long pos, int length) throws SQLException

length

long length() throws SQLException

position

long position(Clob searchstr, long start) throws SQLException

long position(String searchstr, long start) throws SQLException

setAsciiStream

OutputStream setAsciiStream(long pos) throws SQLException

setCharacterStream

Writer setCharacterStream(long pos) throws SQLException

setString

int setString(long pos, String str) throws SQLException

int setString(long pos, String str, int offset, int len) throws SQLException

truncate

void truncate(long len) throws SQLException

ParameterMetaData

ParameterMetaData 객체는 PreparedStatement.getParameterMetaData()를 통해서 얻을 수 있는데, GOLDILOCKS JDBC의 ParameterMetaData는 in/ out 여부에 대한 정보 외에 타입 등에 관한 정보는 실제 데이터베이스의 정보를 이용하지 않고 기본 타입인 varchar를 기준으로 한다. Prepare된 후에 parameter에 대해 서버로부터 얻을 수 있는 정보는 in/ out 뿐이기 때문이다. 예를 들어, "select * from t1 where a=?"라는 질의문으로 prepare를 할 경우, 조건절에 사용된 parameter의 타입은 정해지지 않은 상태이다. 서버는 기본적으로 varchar 타입이라고 가정할 뿐이다.

getParameterClassName

String getParameterClassName(int param) throws SQLException

• 동작: java.lang.String을 반환한다. 해당 parameter 타입은 varchar로 간주한다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

getParameterCount

int getParameterCount() throws SQLException

• 동작: Parameter 개수를 반환한다. 질의문에 사용된 ?의 개수이기도 하다.

• 예외: 발생하지 않는다.

getParameterMode

int getParameterMode(int param) throws SQLException

• 동작: 해당 param 번째 parameter의 in/ out 모드를 반환한다. ParameterMetaData.parameterModeIn, ParameterMetaData.parameterModeInOut, ParameterMetaData.parameterModeOut, ParameterMetaData.parameterModeUnknown 중의 하나를 반환한다. 아직까지는 실제로 parameterModeUnknown 값이 반환되는 경우는 없다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

getParameterType

int getParameterType(int param) throws SQLException

• 동작: 모든 parameter에 대해 Types.VARCHAR를 반환한다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

getParameterTypeName

String getParameterTypeName(int param) throws SQLException

• 동작: 모든 parameter에 대해 "VARCHAR"를 반환한다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

getPrecision

int getPrecision(int param) throws SQLException

• 동작: 모든 parameter에 대해 4000을 반환한다. 기본적으로 parameter는 varchar(4000)으로 간주된다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

getScale

int getScale(int param) throws SQLException

• 동작: 모든 parameter에 대해 0을 반환한다. 기본적으로 parameter는 varchar(4000)으로 간주된다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

isNullable

int isNullable(int param) throws SQLException

• 동작: 항상 ParameterMetaData.parameterNullableUnknown을 반환한다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

isSigned

boolean isSigned(int param) throws SQLException

• 동작: 항상 false를 반환한다.

• 예외: param 값이 parameter 개수 범위를 벗어나면 SQLException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface) throws SQLException

• 동작: 이 객체가 iface의 인스턴스인지 묻고 인스턴스일 경우 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface) throws SQLException

• 동작: 이 객체가 iface의 인스턴스일 경우, 이 객체를 iface 타입으로 캐스팅해 반환한다.

• 예외: 이 객체가 iface의 인스턴스가 아닐 경우, SQLException이 발생한다.

PooledConnection

addConnectionEventListener

void addConnectionEventListener(ConnectionEventListener listener) throws SQLException

• 동작: ConnectionEventListener 객체를 등록한다. 이후 이 PooledConnection으로부터 얻은 connection 객체 (logical connection)의 close()가 호출되거나 실제 connection이 끊기면 등록된 listener들에게로 ConnectionEvent를 발생시킨다.

• 예외: 발생하지 않는다.

addStatementEventListener

void addStatementEventListener(StatementEventListener listener) throws SQLException

• 동작: 아무런 동작을 하지 않는다. GOLDILOCKS JDBC driver는 이 method를 구현하지 않았다. Statement pooling 기능은 외부 미들웨어에 맡겨둔다.

• 예외: 발생하지 않는다.

close

void close() throws SQLException

• 동작: 이 객체가 가지고 있는 physical connection의 close를 호출한다.

• 예외: Physical connection의 close에서 발생할 수 있다.

getConnection

Connection getConnection() throws SQLException

• 동작: 이 객체가 가지고 있는 logical connection을 반환한다.

• 예외: 발생하지 않는다.

removeConnectionEventListener

void removeConnectionEventListener(ConnectionEventListener listener) throws SQLException

• 동작: 등록된 ConnectionEventListener를 제거한다. 이후 이 listener에게는 ConnectionEvent가 전달되지 않는다.

• 예외: 발생하지 않는다.

removeStatementEventListener

void removeStatementEventListener(StatementEventListener listener) throws SQLException

• 동작: 아무런 동작을 하지 않는다.

• 예외: 발생하지 않는다.

PreparedStatement

addBatch

void addBatch() throws SQLException

• 동작: 현재 바인딩한 데이터들을 batch job으로 등록한다. Batch job이 하나라도 등록되어 있으면 execute(), executeUpdate(), executeQuery()를 실행할 때 에러가 발생한다. Parameter가 하나라도 바인딩되어 있지 않으면 에러가 발생한다. addBatch한 후 setXXX() 계열의 method로 바인딩하지 않은 상태에서 다시 addBatch하면 이전에 바인딩한 값으로 batch job을 등록한다.

• 예외: 한 번도 바인딩되지 않은 parameter가 있으면 예외가 발생한다.

clearParameters

void clearParameters() throws SQLException

• 동작: 현재 바인딩한 데이터와 정보를 모두 제거한다. 단 batch job이 하나라도 등록되어 있으면 아무런 작업도 하지 않는다.

• 예외: 발생하지 않는다.

execute

boolean execute() throws SQLException

• 동작: 현재 parameter에 바인딩 된 데이터를 기반으로 prepare된 statement를 실행한다. 실행한 statement가 select 구문이면 true를, 그렇지 않으면 false를 반환한다. 즉 true가 반환되면 이 객체로부터 ResultSet을 얻을 수 있다.

• 예외: Batch job이 등록되었거나 바인딩 된 parameter가 부족하거나 execution 할 때 서버에서 에러가 발생하면 예외가 발생할 수 있다.

executeQuery

ResultSet executeQuery() throws SQLException

• 동작: 현재 parameter에 바인딩 된 데이터를 기반으로 prepare된 statement를 실행하고 fetch를 수행하여 ResultSet 객체를 생성하고 반환한다.

• 예외: Batch job이 등록되었거나, 바인딩 된 parameter가 부족하거나 execution 할 때 서버에서 에러가 발생하면 예외가 발생할 수 있다.

executeUpdate

int executeUpdate() throws SQLException

• 동작: 현재 parameter에 바인딩 된 데이터를 기반으로 prepare된 statement를 실행한다. 갱신된 레코드 수를 반환하는데, DDL 구문 등으로 갱신된 레코드가 없을 경우 0을 반환한다.

• 예외: Batch job이 등록되었거나, statement가 select 구문이거나, 바인딩 된 parameter가 부족하거나 서버에서 에러가 발생하면 예외가 발생될 수 있다.

getMetaData

ResultSetMetaData getMetaData() throws SQLException

• 동작: ResultSetMetaData 객체를 얻는다. Prepare된 구문이 select가 아닌 경우, 즉 ResultSet을 반환하는 구문이 아닌 경우 빈 ResultSetMetaData를 반환한다. 이 method는 execute 되기 전에 호출될 수 있다.

• 예외: 서버에서 에러가 발생하면 예외가 발생할 수 있다.

getParameterMetaData

ParameterMetaData getParameterMetaData() throws SQLException

• 동작: ParameterMetaData 객체를 얻는다. Execute 하기 전에 호출될 수 있다. 하지만 parameter들의 정확한 타입 관련 정보는 서버에서 알 수 없기 때문에 모든 parameter는 varchar(4000)으로 가정한다.

• 예외: 서버에서 에러가 발생하면 예외가 발생할 수 있다.

setArray

void setArray(int parameterIndex, Array x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

• 동작: 해당 parameter 인덱스에 InputStream 객체를 LONG VARCHAR 타입으로 바인딩한다. 바이너리 형태로 데이터를 입력하기 때문에 encoding 작업을 하지 않는다. 따라서 character set을 고려하지 않고 ascii 데이터라고 가정한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 InputStream 객체를 LONG VARCHAR 타입으로 바인딩한다. 바이너리 형태로 데이터를 입력하기 때문에 encoding 작업을 하지 않는다. 따라서 character set을 고려하지 않고 ascii 데이터라고 가정한다. 영문 데이터를 입력하거나 서버, client character set 환경이 동일할 경우 varchar에 문자열을 입력하기 위해 이 method를 사용하는 것이 setCharacterStream이나 setString보다 빠르다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 InputStream 객체를 LONG VARCHAR 타입으로 바인딩한다. 바이너리 형태로 데이터를 입력하기 때문에 encoding 작업을 하지 않는다. 따라서 character set을 고려하지 않고 ascii 데이터라고 가정한다. 영문 데이터를 입력하거나 서버, client character set 환경이 동일할 경우 varchar에 문자열을 입력하기 위해 이 method를 사용하는 것이 setCharacterStream이나 setString보다 빠르다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

• 동작: 해당 parameter 인덱스에 BigDecimal 객체를 NUMBER 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

• 동작: 해당 parameter 인덱스에 InputStream 객체를 LONG VARBINARY 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 InputStream 객체를 LONG VARBINARY 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 InputStream 객체를 LONG VARBINARY 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setBlob

void setBlob(int parameterIndex, Blob x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 BOOLEAN 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setByte

void setByte(int parameterIndex, byte x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 NATIVE_SMALLINT 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setBytes

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

• 동작: 해당 parameter 인덱스에 데이터 x를 VARBINARY 또는 LONG VARBINARY 타입으로 바인딩한다. x의 길이가 4000 이하이면 VARBINARY로, 4000보다 크면 LONG VARBINARY 로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

• 동작: 해당 parameter 인덱스에 reader 객체를 LONG VARCHAR 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 reader 객체를 LONG VARCHAR 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 reader 객체를 LONG VARCHAR 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setClob

void setClob(int parameterIndex, Clob x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setClob(int parameterIndex, Reader reader) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setClob(int parameterIndex, Reader reader, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setDate

void setDate(int parameterIndex, Date x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 DATE 타입으로 바인딩한다. setDate(parameterIndex, x, Calendar.getInstance())로 호출하는 것과 동일하다. 즉, local timezone을 적용한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 데이터 x를 DATE 타입으로 바인딩한다. Date x는 cal의 timezone의 시간대로 간주한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 NATIVE_DOUBLE 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 NATIVE_REAL 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setInt

void setInt(int parameterIndex, int x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 NATIVE_INTEGER 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setLong

void setLong(int parameterIndex, long x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 NATIVE_BIGINT 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setNClob(int parameterIndex, Reader reader) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

void setNClob(int parameterIndex, Reader reader, long length) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNString

void setNString(int parameterIndex, String value) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

• 동작: 해당 parameter 인덱스에 null을 sqlType에 해당하는 GOLDILOCKS 타입으로 바인딩한다. sqlType에 매핑되는 GOLDILOCKS 타입은 SQL 타입 → GOLDILOCKS 타입을 참조한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 null을 sqlType에 해당하는 GOLDILOCKS 타입으로 바인딩한다. sqlType에 매핑되는 GOLDILOCKS 타입은 SQL 타입 → GOLDILOCKS 타입을 참조한다. REF나 사용자 타입은 지원하지 않기 때문에 세 번째 인자인 typeName은 무시된다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setObject

void setObject(int parameterIndex, Object x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 매핑되는 해당 GOLDILOCKS 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 데이터 x를 targetSqlType에 해당하는 GOLDILOCKS 타입으로 바인딩한다. targetSqlType에 매핑되는 GOLDILOCKS 타입은 SQL 타입 → GOLDILOCKS 타입을 참조한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 데이터 x를 targetSqlType에 해당하는 GOLDILOCKS 타입으로 바인딩한다. targetSqlType에 매핑되는 GOLDILOCKS 타입은 SQL 타입 → GOLDILOCKS 타입을 참조한다. x가 InputStream이나 reader인 경우 scaleOrLength는 데이터 길이를 나타낸다. 다른 타입에 대해서는 이 값이 무시된다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setRef

void setRef(int parameterIndex, Ref x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 ROWID 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setShort

void setShort(int parameterIndex, short x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 NATIVE_SMALLINT 타입으로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setSQLXML

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setString

void setString(int parameterIndex, String x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 VARCHAR 또는 LONG VARCHAR 타입으로 바인딩한다. x의 길이가 4000 이하이면 VARCHAR로, 그보다 크면 LONG VARCHAR로 바인딩한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setTime

void setTime(int parameterIndex, Time x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 TIME 타입으로 바인딩한다. setTime(parameterIndex, x, Calendar.getInstance())로 호출하는 것과 동일하다. 즉, local timezone을 적용한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 데이터 x를 TIME 타입으로 바인딩한다. Time x는 cal의 timezone의 시간대로 간주한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

• 동작: 해당 parameter 인덱스에 데이터 x를 TIME 타입으로 바인딩한다. setTimestamp(parameterIndex, x, Calendar.getInstance())로 호출하는 것과 동일하다. 즉, local timezone을 적용한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

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

• 동작: 해당 parameter 인덱스에 데이터 x를 TIMESTAMP 타입으로 바인딩한다. Timestamp x는 cal의 timezone의 시간대로 간주한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setUnicodeStream

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

• 동작: 구현되어 있지 않다. (Deprecated된 method이다)

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

setURL

void setURL(int parameterIndex, URL x) throws SQLException

• 동작: 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface) throws SQLException

• 동작: 이 객체가 iface 인터페이스를 구현한 클래스인지 여부를 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다. GOLDILOCKS PreparedStatement 객체는 다른 클래스의 wrapper가 아니므로 wrapper의 유무는 판단하지 않고 오직 주어진 인자 클래스 타입을 구현했는지 여부만 묻는다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface) throws SQLException

• 동작: GOLDILOCKS PreparedStatement는 다른 클래스의 wrapper가 아니므로 unwrap 하더라도 결국 자기 자신을 반환한다. 해당 타입으로 캐스팅한 후에 반환한다. iface가 isWrapperFor() method의 인자로 주어졌을 때 false를 반환하는 값이라면 이 method는 예외를 발생시킨다.

• 예외: iface가 이 객체의 타입이 아닌 경우 (이 객체가 implements 하지 않은 타입을 준 경우) SQLException이 발생한다.

executeBatchAtomic

boolean executeBatchAtomic() throws SQLException

• 동작: executeBatch()와 같지만 atomic하게 수행된다. 즉 batch job이 모두 성공하거나 모두 실패하거나 둘 중 하나이다. executeBatch()보다 빠르게 수행된다. 수행한 구문이 select 구문이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: Batch job이 등록되지 않았거나 서버에서 에러가 발생하면 SQLException이 발생한다.

setTimeTimeZone

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

• 동작: 해당 parameter 인덱스에 데이터 x를 TIME WITH TIME ZONE 타입으로 바인딩한다. Time x는 cal의 timezone의 시간대로 간주한다. 데이터베이스 column의 timezone 정보는 cal의 timezone을 참조한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

setTimestampTimeZone

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

• 동작: 해당 parameter 인덱스에 데이터 x를 TIMESTAMP WITH TIME ZONE 타입으로 바인딩한다. Timestamp x는 cal의 timezone의 시간대로 간주한다. 데이터베이스 column의 timezone 정보는 cal의 timezone을 참조한다.

• 예외: parameterIndex가 0보다 작거나 parameter 개수보다 클 경우에 예외가 발생한다.

Ref

클래스가 구현되지 않았다.

getBaseTypeName

String getBaseTypeName() throws SQLException

getObject

Object getObject() throws SQLException

Object getObject(Map<String,Class<?>> map) throws SQLException

setObject

void setObject(Object value) throws SQLException

ResultSet

absolute

boolean absolute(int row) throws SQLException

• 동작: Fetch한 row 커서 위치를 row 번째에 둔다. 첫 번째 row는 1이다. 0은 before first를 가리킨다. 음수이면 마지막 row부터 가리킨다. 즉 -1은 마지막 row, -2는 마지막에서 두 번째 row를 가리킨다. Fetch한 row 캐시 내에 커서를 위치시킬 수 있으면 캐시 내의 위치 정보만 바꾸고, 캐시 내에 위치시킬 수 없으면 서버로부터 다시 fetch 해온다. Row가 범위를 벗어나면 before first 또는 after last에 커서를 위치시키고 false를 반환한다. 그 외의 경우에는 해당 row에 위치시키고 true를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

afterLast

void afterLast() throws SQLException

• 동작: Row 커서를 after last에 위치시킨다. Row 캐시가 마지막 row set (전체 result set의 부분을 가리키는 용어)이면 커서 위치만 변경하고 그렇지 않으면 마지막 row set (전체 row 개수-n+1 부터 n개의 row, n은 fetch 할 때 서버로부터 가져오는 row 개수)을 fetch해 온 후에 커서를 after last에 위치시킨다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

beforeFirst

void beforeFirst() throws SQLException

• 동작: Row 커서를 before first에 위치시킨다. Row 캐시가 첫 번째 row set (전체 result set의 부분을 가리키는 용어)이면 커서 위치만 변경하고 그렇지 않으면 첫 번째 row set (1부터 n개의 row, n은 fetch 할 때 서버로부터 가져오는 row 개수)을 fetch해 온 후에 커서를 before first에 위치시킨다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

cancelRowUpdates

void cancelRowUpdates() throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우에는 동작을 참조한다.

clearWarnings

void clearWarnings() throws SQLException

• 동작: ResultSet 객체가 가지고 있는 SQLWarning 객체들을 모두 제거한다.

• 예외: 발생하지 않는다.

close

void close() throws SQLException

• 동작: 서버에 해당 커서가 열려 있으면 이를 닫게 하고 (이미 서버에 커서가 닫혀 있으면 이 작업을 수행하지 않는다. 즉, 프로토콜 전송이 일어나지 않는다.), 현재 ResultSet 객체의 상태를 closed로 변경한다. 이미 닫혀 있는 상태일 경우, 아무런 동작을 하지 않는다.

• 예외: 서버에서 에러가 발생하면 SQLException이 발생한다.

deleteRow

void deleteRow() throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있을 경우, SQLException이 발생한다. 그 외의 경우에는 동작을 참조한다.

findColumn

int findColumn(String columnLabel) throws SQLException

• 동작: 해당 column 이름의 인덱스를 반환한다. 첫 번째 column의 인덱스는 1이다.

• 예외: 이미 close되었거나 해당 이름의 column을 찾지 못하면 SQLException이 발생한다.

first

boolean first() throws SQLException

• 동작: Row 커서를 first (첫 번째 row)에 위치시킨다. Row 캐시가 첫 번째 row set (전체 result set의 부분을 가리키는 용어)이면 커서 위치만 변경하고 그렇지 않으면 첫 번째 row set (1부터 n개의 row, n은 fetch 할 때 서버로부터 가져오는 row 개수)을 fetch해 온 후 커서를 first에 위치시킨다. 해당 row가 있으면 true를, 없으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

getArray

Array getArray(int columnIndex) throws SQLException

• 동작: Array 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Array getArray(String columnLabel) throws SQLException

• 동작: Array 타입은 지원하지 않는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getAsciiStream

InputStream getAsciiStream(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 InputStream 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 InputStream으로 변환할 수 없을 경우, SQLException이 발생한다.

InputStream getAsciiStream(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 InputStream 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 InputStream으로 변환할 수 없을 경우, SQLException이 발생한다.

getBigDecimal

BigDecimal getBigDecimal(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 BigDecimal 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 BigDecimal로 변환할 수 없을 경우, SQLException이 발생한다.

BigDecimal getBigDecimal(int columnIndex, int scale) throws SQLException

• 동작: Deprecated된 method이다. getBigDecimal(int columnIndex)과 동일하게 동작한다. Scale은 무시된다.

• 예외: getBigDecimal(int columnIndex)을 참조한다.

BigDecimal getBigDecimal(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 BigDecimal 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 BigDecimal로 변환할 수 없을 경우, SQLException이 발생한다.

BigDecimal getBigDecimal(String columnLabel, int scale) throws SQLException

• 동작: Deprecated된 method이다. getBigDecimal(String columnLabel)과 동일하게 동작한다. Scale은 무시된다.

• 예외: getBigDecimal(String columnLabel)을 참조한다.

getBinaryStream

InputStream getBinaryStream(int columnIndex) throws SQLException

• 동작: getAsciiStream(int columnIndex)과 같다.

• 예외: getAsciiStream(int columnIndex)을 참조한다.

InputStream getBinaryStream(String columnLabel) throws SQLException

• 동작: getAsciiStream(String columnLabel)과 같다.

• 예외: getAsciiStream(String columnLabel)을 참조한다.

getBlob

Blob getBlob(int columnIndex) throws SQLException

• 동작: Blob 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Blob getBlob(String columnLabel) throws SQLException

• 동작: Blob 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getBoolean

boolean getBoolean(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 boolean 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 boolean으로 변환할 수 없을 경우, SQLException이 발생한다.

boolean getBoolean(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 boolean 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 boolean으로 변환할 수 없을 경우, SQLException이 발생한다.

getByte

byte getByte(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 byte 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 byte로 변환할 수 없을 경우, SQLException이 발생한다.

byte getByte(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 byte 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 byte로 변환할 수 없을 경우, SQLException이 발생한다.

getBytes

byte[] getBytes(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 byte[] 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났을 경우 SQLException이 발생한다.

byte[] getBytes(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 byte[] 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없을 경우 SQLException이 발생한다.

getCharacterStream

Reader getCharacterStream(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 reader 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 reader로 변환할 수 없을 경우, SQLException이 발생한다.

Reader getCharacterStream(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 reader 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 reader로 변환할 수 없을 경우, SQLException이 발생한다.

getClob

Clob getClob(int columnIndex) throws SQLException

• 동작: Clob 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Clob getClob(String columnLabel) throws SQLException

• 동작: Clob 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getConcurrency

int getConcurrency() throws SQLException

• 동작: 현재 ResultSet 객체의 concurrency를 반환한다. 현재는 ResultSet.CONCUR_READ_ONLY만 지원한다.

• 예외: 발생하지 않는다.

getCursorName

String getCursorName() throws SQLException

• 동작: 이 ResultSet이 가리키는 서버의 커서 이름을 얻어온다. 서버와 통신이 발생한다.

• 예외: ResultSet이 이미 close되었거나 서버에서 에러가 발생할 경우, SQLException이 발생한다.

getDate

Date getDate(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 date 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Date 객체를 만들 때 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 date로 변환할 수 없을 경우, SQLException이 발생한다.

Date getDate(int columnIndex, Calendar cal) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 date 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Date 객체를 만들 때 cal의 timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 date로 변환할 수 없을 경우, SQLException이 발생한다.

Date getDate(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 date 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Date 객체를 만들 때 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 date로 변환할 수 없을 경우, SQLException이 발생한다.

Date getDate(String columnLabel, Calendar cal) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 date 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Date 객체를 만들 때 cal의 timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 date로 변환할 수 없을 경우, SQLException이 발생한다.

getDouble

double getDouble(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 double 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 double로 변환할 수 없을 경우, SQLException이 발생한다.

double getDouble(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 double 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 double로 변환할 수 없을 경우, SQLException이 발생한다.

getFetchDirection

int getFetchDirection() throws SQLException

• 동작: 항상 ResultSet.FETCH_FORWARD만 반환한다. Backward fetch는 지원하지 않는다.

• 예외: ResultSet이 이미 close되었으면 SQLException이 발생한다.

getFetchSize

int getFetchSize() throws SQLException

• 동작: 한 번 fetch 할 때 서버로부터 가져오는 row 개수를 얻어온다. 0일 경우 한 번 전송할 때 통신 패킷에 담을 수 있는 최대 row 개수를 자동으로 계산한다. 기본값은 0이다.

• 예외: ResultSet이 이미 close되었으면 SQLException이 발생한다.

getFloat

float getFloat(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 float 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 float으로 변환할 수 없을 경우 SQLException이 발생한다.

float getFloat(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 float 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 float으로 변환할 수 없을 경우 SQLException이 발생한다.

getHoldability

int getHoldability() throws SQLException

• 동작: 현재 ResultSet의 holdability를 반환한다. 이 값은 ResultSet 객체가 생성될 때 정해지며 도중에 변경할 수는 없다. 기본값은 ResultSet.HOLD_CURSOR_OVER_COMMIT이다.

• 예외: ResultSet이 이미 close되었으면 SQLException이 발생한다.

getInt

int getInt(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 int 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 int로 변환할 수 없을 경우 SQLException이 발생한다.

int getInt(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 int 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 int로 변환할 수 없을 경우 SQLException이 발생한다.

getLong

long getLong(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 long 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close 되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 long으로 변환할 수 없을 경우 SQLException이 발생한다.

long getLong(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 long 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 long으로 변환할 수 없을 경우 SQLException이 발생한다.

getMetaData

ResultSetMetaData getMetaData() throws SQLException

• 동작: Column의 상세 정보를 얻을 수 있는 ResultSetMetaData 객체를 생성하고 반환한다.

• 예외: ResultSet이 이미 close되었거나 서버로부터 column 상세 정보를 가져오는 동안 에러가 발생하면 SQLException이 발생한다.

getNCharacterStream

Reader getNCharacterStream(int columnIndex) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Reader getNCharacterStream(String columnLabel) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getNClob

NClob getNClob(int columnIndex) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

NClob getNClob(String columnLabel) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getNString

String getNString(int columnIndex) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

String getNString(String columnLabel) throws SQLException

• 동작: NCHAR 계열 타입은 현재 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getObject

Object getObject(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 가장 적합한 Java 객체 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났을 경우, SQLException이 발생한다.

Object getObject(int columnIndex, Map<String,Class<?>> map) throws SQLException

• 동작: 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Object getObject(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 가장 적합한 Java 객체 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없을 경우, SQLException이 발생한다.

Object getObject(String columnLabel, Map<String,Class<?>> map) throws SQLException

• 동작: 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getRef

Ref getRef(int columnIndex) throws SQLException

• 동작: REF 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

Ref getRef(String columnLabel) throws SQLException

• 동작: REF 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getRow

int getRow() throws SQLException

• 동작: 현재 ResultSet 객체의 커서 위치를 반환한다. 첫 번째 row는 1이다. Before first인 경우 0을 반환한다.

• 예외: ResultSet이 이미 close되었으면 SQLException이 발생한다.

getRowId

RowId getRowId(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 RowId 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 RowId로 변환할 수 없을 경우, SQLException이 발생한다.

RowId getRowId(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 RowId 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 RowId로 변환할 수 없을 경우, SQLException이 발생한다.

getShort

short getShort(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 short 타입으로 얻는다 GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 short로 변환할 수 없을 경우, SQLException이 발생한다.

short getShort(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 short 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 short로 변환할 수 없을 경우, SQLException이 발생한다.

getSQLXML

SQLXML getSQLXML(int columnIndex) throws SQLException

• 동작: SQLXML 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

SQLXML getSQLXML(String columnLabel) throws SQLException

• 동작: SQLXML 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getStatement

Statement getStatement() throws SQLException

• 동작: 이 ResultSet 객체를 생성한 statement 객체를 반환한다.

• 예외: ResultSet이 이미 close되었으면 SQLException이 발생한다.

getString

String getString(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 string 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. BINARY, VARBINARY, LONG VARBINARY 에 대해 getString()을 하면 hex code의 문자열을 반환받는다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났을 경우, SQLException이 발생한다.

String getString(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 string 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. BINARY, VARBINARY, LONG VARBINARY 에 대해 getString()을 하면 hex code의 문자열을 반환받는다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없을 경우, SQLException이 발생한다.

getTime

Time getTime(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 time 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Time 객체를 만들 때는 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 time으로 변환할 수 없을 경우, SQLException이 발생한다.

Time getTime(int columnIndex, Calendar cal) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 time 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Time 객체를 만들 때 cal의 timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 time으로 변환할 수 없을 경우, SQLException이 발생한다.

Time getTime(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 time 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Time 객체를 만들 때 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 time으로 변환할 수 없을 경우 SQLException이 발생한다.

Time getTime(String columnLabel, Calendar cal) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 time 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Time 객체를 만들 때 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 time으로 변환할 수 없을 경우 SQLException이 발생한다.

getTimestamp

Timestamp getTimestamp(int columnIndex) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 timestamp 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Timestamp 객체를 만들 때 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 timestamp로 변환할 수 없을 경우, SQLException이 발생한다.

Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException

• 동작: columnIndex 번째 column의 데이터를 timestamp 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Timestamp 객체를 만들 때 cal의 timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 columnIndex가 범위를 벗어났거나 해당 타입을 timestamp로 변환할 수 없을 경우, SQLException이 발생한다.

Timestamp getTimestamp(String columnLabel) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 timestamp 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Timestamp 객체를 만들 때 local timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 timestamp로 변환할 수 없을 경우, SQLException이 발생한다.

Timestamp getTimestamp(String columnLabel, Calendar cal) throws SQLException

• 동작: 이름이 columnLabel인 column의 데이터를 timestamp 타입으로 얻는다. GOLDILOCKS 타입 별 지원 여부는 GOLDILOCKS 타입에 대한 getter method 지원 여부-1를 참조한다. Timestamp 객체를 만들 때 cal의 timezone을 사용한다.

• 예외: ResultSet이 이미 close되었거나 해당 columnLabel을 찾을 수 없거나 해당 타입을 timestamp로 변환할 수 없을 경우, SQLException이 발생한다.

getType

int getType() throws SQLException

• 동작: 현재 ResultSet 타입을 반환한다. ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.TYPE_SCROLL_SENSITIVE 중의 하나를 반환한다.

• 예외: ResultSet이 이미 close되어 있으면 SQLException이 발생한다.

getUnicodeStream

InputStream getUnicodeStream(int columnIndex) throws SQLException

• 동작: Deprecated 된 method이다. 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

InputStream getUnicodeStream(String columnLabel) throws SQLException

• 동작: Deprecated 된 method이다. 구현되어 있지 않다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getURL

URL getURL(int columnIndex) throws SQLException

• 동작: URL 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

URL getURL(String columnLabel) throws SQLException

• 동작: URL 타입은 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

getWarnings

SQLWarning getWarnings() throws SQLException

• 동작: 현재까지 이 객체에 축적된 SQLWarning 목록을 반환한다. 서버로부터 경고를 전달받으면 SQLWarning을 생성하는데 clearWarning하지 않을 경우 계속 누적된다. 없을 경우, null이 반환된다.

• 예외: 발생하지 않는다.

insertRow

void insertRow() throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우에는 동작을 참조한다.

isAfterLast

boolean isAfterLast() throws SQLException

• 동작: 현재 커서 위치가 after last인지 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 이미 close되어 있으면 SQLException이 발생한다.

isBeforeFirst

boolean isBeforeFirst() throws SQLException

• 동작: 현재 커서 위치가 before first인지 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 이미 close되어 있으면 SQLException이 발생한다.

isClosed

boolean isClosed() throws SQLException

• 동작: 현재 ResultSet이 close되었는지 묻는다. Close되었으면 true를, 그렇지 않으면 false를 반환한다. 사용자가 close를 호출하지 않았더라도 서버의 커서가 close되어 ResultSet이 close될 수 있다. 예를 들어 ResultSet을 생성한 statement가 close 되거나 holdability가 ResultSet.CLOSE_CURSOR_AT_COMMIT 모드일 때 트랜잭션이 commit 되거나, fetch 도중에 서버로부터 에러를 반환받을 때 등이다.

• 예외: 발생하지 않는다.

isFirst

boolean isFirst() throws SQLException

• 동작: 현재 커서 위치가 first (첫 번째 row)인지 여부를 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 이미 close되어 있으면 SQLException이 발생한다.

isLast

boolean isLast() throws SQLException

• 동작: 현재 커서 위치가 last (마지막 row)인지 여부를 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 이미 close되어 있으면 SQLException이 발생한다.

last

boolean last() throws SQLException

• 동작: Row 커서를 last (마지막 row)에 위치시킨다. Row 캐시가 마지막 row set (전체 result set의 일부)이면 커서 위치만 변경하고 그렇지 않으면 마지막 row set (last-n+1부터 last의 row, n은 fetch 할 때 서버로부터 가져오는 row 개수)을 fetch해 온 후 커서를 last에 위치시킨다. 해당 row가 있으면 true를, 없으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

moveToCurrentRow

void moveToCurrentRow() throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

moveToInsertRow

void moveToInsertRow() throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

next

boolean next() throws SQLException

• 동작: Row 커서를 현재 row 다음에 위치시킨다. 현재 row가 row 캐시의 마지막 row이면 서버로부터 다음 row 캐시를 가져온다. 해당 row가 있으면 true를, 없으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

previous

boolean previous() throws SQLException

• 동작: Row 커서를 현재 위치 이전 row에 위치시킨다. 현재 row가 row 캐시의 첫 번째 row이면 서버로부터 이전 row 캐시 (x-n부터 x-1까지 n개의 row, x는 현재 row 인덱스)를 가져온다. 해당 row가 있으면 true를, 없으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

refreshRow

void refreshRow() throws SQLException

• 동작: ResultSet 타입이 ResultSet.SCROLL_SENSITIVE일 경우, 서버로부터 현재 row 캐시를 다시 가져온다. 그동안 (동일 트랜잭션에 의해서든, 타 트랜잭션에 의해서든) row에 갱신된 것이 있으면 반영된다. ResultSet 타입이 ResultSet.Scroll_INSENSITIVE일 경우 아무런 작업을 하지 않는다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

relative

boolean relative(int rows) throws SQLException

• 동작: Row 커서를 현재 위치로부터 rows 만큼 떨어진 곳으로 이동시킨다. 현재 row 캐시 내에서 이동할 수 있으면 커서 위치만 변경시키고, 그렇지 않으면 서버로부터 해당 row 캐시를 fetch해온 후 커서를 위치시킨다. 이 때 이동할 위치가 현재 위치보다 뒤쪽이면 (next 방향이면) (next에 유리하도록) row 캐시를 rows부터 rows+n-1까지 fetch하고, 현재 위치보다 앞쪽이면 (previous 방향이면) (previous에 유리하도록) row 캐시를 rows-n+1부터 rows까지 fetch한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이거나 fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

rowDeleted

boolean rowDeleted() throws SQLException

• 동작: 현재 커서 위치의 row가 (동일 트랜잭션에 의해서든, 타 트랜잭션에 의해서든) delete 되었는지 여부를 묻는다. Delete 되었으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이면 예외가 발생한다.

rowInserted

boolean rowInserted() throws SQLException

• 동작: 현재 커서 위치의 row가 (동일 트랜잭션에 의해서든, 타 트랜잭션에 의해서든) insert 되었는지 여부를 묻는다. Insert되었으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이면 예외가 발생한다.

rowUpdated

boolean rowUpdated() throws SQLException

• 동작: 현재 커서 위치의 row가 (동일 트랜잭션에 의해서든, 타 트랜잭션에 의해서든) update 되었는지 여부를 묻는다. Update되었으면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 close되었거나 ResultSet 타입이 ResultSet.TYPE_FORWARD_ONLY이면 예외가 발생한다.

setFetchDirection

void setFetchDirection(int direction) throws SQLException

• 동작: 서버가 backward fetch를 지원하지 않는다. 따라서 ResultSet.FETCH_FORWARD만 가능하다. 다른 값이 입력되면 SQLWarning을 생성한다.

• 예외: ResultSet이 이미 close되었거나 정의된 값이 아닌 다른 값이 인자로 입력되었을 경우 예외가 발생한다.

setFetchSize

void setFetchSize(int rows) throws SQLException

• 동작: 서버로부터 한 번에 fetch 할 row 개수를 지정한다. 0이면 서버가 자동으로 결정한다. 0일 경우 forward only 커서에 대해서는 한 번의 통신 패킷에 담을 수 있는 row 개수로 정하고, scrollable 커서일 경우 100개로 정한다.

• 예외: ResultSet이 이미 close되었으면 예외가 발생한다.

updateArray

void updateArray(int columnIndex, Array x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateArray(String columnLabel, Array x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateAsciiStream

void updateAsciiStream(int columnIndex, InputStream x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우엔 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateAsciiStream(int columnIndex, InputStream x, int length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateAsciiStream(int columnIndex, InputStream x, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateAsciiStream(String columnLabel, InputStream x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateAsciiStream(String columnLabel, InputStream x, int length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateAsciiStream(String columnLabel, InputStream x, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateBigDecimal

void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBigDecimal(String columnLabel, BigDecimal x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateBinaryStream

void updateBinaryStream(int columnIndex, InputStream x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBinaryStream(int columnIndex, InputStream x, int length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBinaryStream(int columnIndex, InputStream x, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBinaryStream(String columnLabel, InputStream x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBinaryStream(String columnLabel, InputStream x, int length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBinaryStream(String columnLabel, InputStream x, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateBlob

void updateBlob(int columnIndex, Blob x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBlob(int columnIndex, InputStream inputStream) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBlob(int columnIndex, InputStream inputStream, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBlob(String columnLabel, Blob x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBlob(String columnLabel, InputStream inputStream) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateBoolean

void updateBoolean(int columnIndex, boolean x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBoolean(String columnLabel, boolean x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateByte

void updateByte(int columnIndex, byte x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateByte(String columnLabel, byte x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateBytes

void updateBytes(int columnIndex, byte[] x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateBytes(String columnLabel, byte[] x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateCharacterStream

void updateCharacterStream(int columnIndex, Reader x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateCharacterStream(int columnIndex, Reader x, int length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateCharacterStream(int columnIndex, Reader x, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateCharacterStream(String columnLabel, Reader reader) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateCharacterStream(String columnLabel, Reader reader, int length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateCharacterStream(String columnLabel, Reader reader, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateClob

void updateClob(int columnIndex, Clob x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateClob(int columnIndex, Reader reader) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateClob(int columnIndex, Reader reader, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateClob(String columnLabel, Clob x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateClob(String columnLabel, Reader reader) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateClob(String columnLabel, Reader reader, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateDate

void updateDate(int columnIndex, Date x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateDate(String columnLabel, Date x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateDouble

void updateDouble(int columnIndex, double x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateDouble(String columnLabel, double x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateFloat

void updateFloat(int columnIndex, float x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateFloat(String columnLabel, float x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateInt

void updateInt(int columnIndex, int x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateInt(String columnLabel, int x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateLong

void updateLong(int columnIndex, long x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateLong(String columnLabel, long x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateNCharacterStream

void updateNCharacterStream(int columnIndex, Reader x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNCharacterStream(int columnIndex, Reader x, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNCharacterStream(String columnLabel, Reader reader) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNCharacterStream(String columnLabel, Reader reader, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateNClob

void updateNClob(int columnIndex, NClob nClob) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNClob(int columnIndex, Reader reader) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNClob(int columnIndex, Reader reader, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNClob(String columnLabel, NClob nClob) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNClob(String columnLabel, Reader reader) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNClob(String columnLabel, Reader reader, long length) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateNString

void updateNString(int columnIndex, String nString) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNString(String columnLabel, String nString) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateNull

void updateNull(int columnIndex) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateNull(String columnLabel) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateObject

void updateObject(int columnIndex, Object x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateObject(int columnIndex, Object x, int scaleOrLength) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateObject(String columnLabel, Object x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateObject(String columnLabel, Object x, int scaleOrLength) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateRef

void updateRef(int columnIndex, Ref x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateRef(String columnLabel, Ref x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateRow

void updateRow() throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateRowId

void updateRowId(int columnIndex, RowId x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateRowId(String columnLabel, RowId x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateShort

void updateShort(int columnIndex, short x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateShort(String columnLabel, short x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateSQLXML

void updateSQLXML(int columnIndex, SQLXML xmlObject) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateSQLXML(String columnLabel, SQLXML xmlObject) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateString

void updateString(int columnIndex, String x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateString(String columnLabel, String x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateTime

void updateTime(int columnIndex, Time x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateTime(String columnLabel, Time x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

updateTimestamp

void updateTimestamp(int columnIndex, Timestamp x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

void updateTimestamp(String columnLabel, Timestamp x) throws SQLException

• 동작: Cursor update 기능은 아직 구현되어 있지 않다. ResultSet concurrency가 ResultSet.CONCUR_READ_ONLY일 경우에는 SQLException이 발생하고 ResultSet.CONCUR_UPDATABLE일 경우에는 SQLFeatureNotSupportedException이 발생한다.

• 예외: 이미 close되어 있으면 SQLException이 발생한다. 그 외의 경우는 동작을 참조한다.

wasNull

boolean wasNull() throws SQLException

• 동작: 마지막으로 읽은 column의 값이 NULL인지 여부를 묻는다. NULL이면 true를, 그렇지 않으면 false를 반환한다.

• 예외: ResultSet이 이미 close되었거나 column 값을 읽은 적이 없으면 SQLException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface)

• 동작: 이 객체가 iface 인터페이스를 구현한 클래스인지 여부를 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다. GOLDILOCKS ResultSet 객체는 다른 클래스의 wrapper가 아니므로 wrapper의 유무는 판단하지 않고 오직 주어진 인자 클래스 타입을 구현했는지 여부만 묻는다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface)

• 동작: GOLDILOCKS ResultSet은 다른 클래스의 wrapper가 아니므로 unwrap 하더라도 결국 자기 자신을 반환한다. 해당 타입으로 캐스팅한 후에 반환한다. iface가 isWrapperFor() method의 인자로 주어졌을 때 false를 반환하는 값일 경우, 이 method는 예외를 발생시킨다.

• 예외: iface가 이 객체의 타입이 아닌 경우 (이 객체가 implement 하지 않은 타입인 경우) SQLException이 발생한다.

ResultSetMetaData

getCatalogName

String getCatalogName(int column) throws SQLException

• 동작: 해당 column의 카탈로그 이름을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getColumnClassName

String getColumnClassName(int column) throws SQLException

• 동작: 해당 column의 타입에 가장 적합한 Java 클래스의 이름을 반환한다. java.math.BigDecimal 등으로 명시되며, Java 내부의 getName()method를 참조한다. Binary 타입의 경우에는 byte[].class.getName()을 참조하기 때문에 '[B'등으로 표시될 수 있다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getColumnCount

int getColumnCount() throws SQLException

• 동작: ResultSet이 가지는 column 개수를 반환한다.

• 예외: 발생하지 않는다.

getColumnDisplaySize

int getColumnDisplaySize(int column) throws SQLException

• 동작: 해당 column의 값을 출력할 때 최대 폭을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getColumnLabel

String getColumnLabel(int column) throws SQLException

• 동작: 해당 column의 label을 얻어온다. 예를 들어 "select C1 + 1 from t1"과 같은 질의문의 경우 label은 "C1 + 1"이고 name은 ""이다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getColumnName

String getColumnName(int column) throws SQLException

• 동작: 해당 column의 alias name을 반환한다. JDBC 스펙에는 alias name이 아니라 column의 원래 이름을 얻어오도록 명시했지만, 각종 view의 경우 원래 이름들이 의미없거나 복잡하므로 alias name을 사용하는게 더 좋다. 예를 들어 "select C1 as C2 from t1"과 같은 질의문의 경우 name과 label 모두 "C2"가 된다. name과 label이 다른 경우는 getColumnLabel을 참조한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getColumnType

int getColumnType(int column) throws SQLException

• 동작: 해당 column의 타입을 반환한다. 반환값은 types에 정의된 값이다. GOLDILOCKS interval 계열 타입에 대해서는 Types.OTHERS가 반환된다. 그 외 다른 타입들에 대해서는 해당 types의 상수값이 반환된다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getColumnTypeName

String getColumnTypeName(int column) throws SQLException

• 동작: 해당 column의 GOLDILOCKS column 타입 이름이 반환된다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getPrecision

int getPrecision(int column) throws SQLException

• 동작: 해당 column의 precision을 반환한다. Precision이 없는 타입에 대해서는 0을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getScale

int getScale(int column) throws SQLException

• 동작: 해당 column의 scale을 반환한다. Scale이 없는 타입에 대해서는 0을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getSchemaName

String getSchemaName(int column) throws SQLException

• 동작: 해당 column의 스키마 이름을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

getTableName

String getTableName(int column) throws SQLException

• 동작: 해당 column의 테이블 이름을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isAutoIncrement

boolean isAutoIncrement(int column) throws SQLException

• 동작: 해당 column이 자동으로 고유값을 부여받는 column인지 여부를 반환한다. 맞으면 true를 그렇지 않으면 false를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isCaseSensitive

boolean isCaseSensitive(int column) throws SQLException

• 동작: 해당 column이 대소문자를 구별하는지 여부를 반환한다. 구별하면 true를, 구별하지 않으면 false를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isCurrency

boolean isCurrency(int column) throws SQLException

• 동작: 서버에서 column의 currency 판단을 할 수 없으므로 항상 false를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isDefinitelyWritable

boolean isDefinitelyWritable(int column) throws SQLException

• 동작: 해당 column의 updatable 여부를 반환한다. GOLDILOCKS에서 definitely writable은 지원하지 않는다. 항상 isUpdatable()과 같은 값을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isNullable

int isNullable(int column) throws SQLException

• 동작: 해당 column이 NULL을 가질 수 있는지 여부를 반환한다. columnNullable이나 columnNoNulls 중 하나를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isReadOnly

boolean isReadOnly(int column) throws SQLException

• 동작: 해당 column의 read-only 여부를 반환한다. 항상 isUpdatable()의 반대값을 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isSearchable

boolean isSearchable(int column) throws SQLException

• 동작: 해당 column이 조건절에 사용될 수 있는지 여부를 반환한다. GOLDILOCKS의 모든 target column이 조건절에 사용될 수 있으므로 항상 true를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isSigned

boolean isSigned(int column) throws SQLException

• 동작: 해당 column이 부호를 가지는지 여부를 반환한다. 부호를 가지면 true를, 그렇지 않으면 false를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isWritable

boolean isWritable(int column) throws SQLException

• 동작: 해당 column이 updatable인지 여부를 반환한다.

• 예외: Column이 잘못된 값이면 SQLException이 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface)

• 동작: 이 객체가 iface 인터페이스를 구현한 클래스인지 여부를 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다. GOLDILOCKS ResultSetMetaData 객체는 다른 클래스의 wrapper가 아니므로 wrapper의 유무는 판단하지 않고 오직 주어진 인자 클래스 타입을 구현했는지 여부만 묻는다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface)

• 동작: GOLDILOCKS ResultSetMetaData는 다른 클래스의 wrapper가 아니므로 unwrap 하더라도 결국 자기 자신을 반환한다. 해당 타입으로 캐스팅한 후에 반환한다. iface가 isWrapperFor() method의 인자로 주어졌을 때 false를 반환하는 값이라면 이 method는 예외를 발생시킨다.

• 예외: iface가 이 객체의 타입이 아닌 경우 (이 객체가 implement 하지 않은 타입을 부여한 경우) SQLException이 발생한다.

RowId

equals

boolean equals(Object obj) throws SQLException

• 동작: 이 객체가 obj와 같은 RowId를 나타내면 true를, 그렇지 않으면 false를 반환한다.

• 예외: 발생하지 않는다.

getBytes

byte[] getBytes() throws SQLException

• 동작: RowId의 바이트 배열 값을 반환한다.

• 예외: 발생하지 않는다.

hashCode

int hashCode() throws SQLException

• 동작: 해시 코드 값을 반환한다.

• 예외: 발생하지 않는다.

toString

String toString() throws SQLException

• 동작: RowId 값의 base-64 문자열을 반환한다.

• 예외: 발생하지 않는다.

RowSet

클래스가 구현되지 않았다.

addRowSetListener

void addRowSetListener(RowSetListener listener) throws SQLException

clearParameters

void clearParameters() throws SQLException

execute

void execute() throws SQLException

getCommand

String getCommand() throws SQLException

getDataSourceName

String getDataSourceName() throws SQLException

getEscapeProcessing

boolean getEscapeProcessing() throws SQLException

getMaxFieldSize

int getMaxFieldSize() throws SQLException

getMaxRows

int getMaxRows() throws SQLException

getPassword

String getPassword() throws SQLException

getQueryTimeout

int getQueryTimeout() throws SQLException

getTransactionIsolation

int getTransactionIsolation() throws SQLException

getTypeMap

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

getUrl

String getUrl() throws SQLException

getUsername

String getUsername() throws SQLException

isReadOnly

boolean isReadOnly() throws SQLException

removeRowSetListener

void removeRowSetListener(RowSetListener listener) throws SQLException

setArray

void setArray(int i, Array x) throws SQLException

setAsciiStream

void setAsciiStream(int parameterIndex, InputStream x) throws SQLException

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

void setAsciiStream(String parameterName, InputStream x) throws SQLException

void setAsciiStream(String parameterName, InputStream x, int length) throws SQLException

setBigDecimal

void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException

void setBigDecimal(String parameterName, BigDecimal x) throws SQLException

setBinaryStream

void setBinaryStream(int parameterIndex, InputStream x) throws SQLException

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

void setBinaryStream(String parameterName, InputStream x) throws SQLException

void setBinaryStream(String parameterName, InputStream x, int length) throws SQLException

setBlob

void setBlob(int i, Blob x) throws SQLException

void setBlob(int parameterIndex, InputStream inputStream) throws SQLException

void setBlob(int parameterIndex, InputStream inputStream, long length) throws SQLException

void setBlob(String parameterName, Blob x) throws SQLException

void setBlob(String parameterName, InputStream inputStream) throws SQLException

void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException

setBoolean

void setBoolean(int parameterIndex, boolean x) throws SQLException

void setBoolean(String parameterName, boolean x) throws SQLException

setByte

void setByte(int parameterIndex, byte x) throws SQLException

void setByte(String parameterName, byte x) throws SQLException

setBytes

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

void setBytes(String parameterName, byte[] x) throws SQLException

setCharacterStream

void setCharacterStream(int parameterIndex, Reader reader) throws SQLException

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

void setCharacterStream(String parameterName, Reader reader) throws SQLException

void setCharacterStream(String parameterName, Reader reader, int length) throws SQLException

setClob

void setClob(int i, Clob x) throws SQLException

void setClob(int parameterIndex, Reader reader) throws SQLException

void setClob(int parameterIndex, Reader reader, long length) throws SQLException

void setClob(String parameterName, Clob x) throws SQLException

void setClob(String parameterName, Reader reader) throws SQLException

void setClob(String parameterName, Reader reader, long length) throws SQLException

setCommand

void setCommand(String cmd) throws SQLException

setConcurrency

void setConcurrency(int concurrency) throws SQLException

setDataSourceName

void setDataSourceName(String name) throws SQLException

setDate

void setDate(int parameterIndex, Date x) throws SQLException

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

void setDate(String parameterName, Date x) throws SQLException

void setDate(String parameterName, Date x, Calendar cal) throws SQLException

setDouble

void setDouble(int parameterIndex, double x) throws SQLException

void setDouble(String parameterName, double x) throws SQLException

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

setFloat

void setFloat(int parameterIndex, float x) throws SQLException

void setFloat(String parameterName, float x) throws SQLException

setInt

void setInt(int parameterIndex, int x) throws SQLException

void setInt(String parameterName, int x) throws SQLException

setLong

void setLong(int parameterIndex, long x) throws SQLException

void setLong(String parameterName, long x) throws SQLException

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

setMaxRows

void setMaxRows(int max) throws SQLException

setNCharacterStream

void setNCharacterStream(int parameterIndex, Reader value) throws SQLException

void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException

void setNCharacterStream(String parameterName, Reader value) throws SQLException

void setNCharacterStream(String parameterName, Reader value, long length) throws SQLException

setNClob

void setNClob(int parameterIndex, NClob value) throws SQLException

void setNClob(int parameterIndex, Reader reader) throws SQLException

void setNClob(int parameterIndex, Reader reader, long length) throws SQLException

void setNClob(String parameterName, NClob value) throws SQLException

void setNClob(String parameterName, Reader reader) throws SQLException

void setNClob(String parameterName, Reader reader, long length) throws SQLException

setNString

void setNString(int parameterIndex, String value) throws SQLException

void setNString(String parameterName, String value) throws SQLException

setNull

void setNull(int parameterIndex, int sqlType) throws SQLException

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

void setNull(String parameterName, int sqlType) throws SQLException

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

setObject

void setObject(int parameterIndex, Object x) throws SQLException

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

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

void setObject(String parameterName, Object x) throws SQLException

void setObject(String parameterName, Object x, int targetSqlType) throws SQLException

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

setPassword

void setPassword(String password) throws SQLException

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

setReadOnly

void setReadOnly(boolean value) throws SQLException

setRef

void setRef(int i, Ref x) throws SQLException

setRowId

void setRowId(int parameterIndex, RowId x) throws SQLException

void setRowId(String parameterName, RowId x) throws SQLException

setShort

void setShort(int parameterIndex, short x) throws SQLException

void setShort(String parameterName, short x) throws SQLException

setSQLXML

void setSQLXML(int parameterIndex, SQLXML xmlObject) throws SQLException

void setSQLXML(String parameterName, SQLXML xmlObject) throws SQLException

setString

void setString(int parameterIndex, String x) throws SQLException

void setString(String parameterName, String x) throws SQLException

setTime

void setTime(int parameterIndex, Time x) throws SQLException

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

void setTime(String parameterName, Time x) throws SQLException

void setTime(String parameterName, Time x, Calendar cal) throws SQLException

setTimestamp

void setTimestamp(int parameterIndex, Timestamp x) throws SQLException

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

void setTimestamp(String parameterName, Timestamp x) throws SQLException

void setTimestamp(String parameterName, Timestamp x, Calendar cal) throws SQLException

setTransactionIsolation

void setTransactionIsolation(int level) throws SQLException

setType

void setType(int type) throws SQLException

setTypeMap

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

setURL

void setURL(int parameterIndex, URL x) throws SQLException

setUrl

void setUrl(String url) throws SQLException

setUsername

void setUsername(String name) throws SQLException

RowSetMetaData

클래스가 구현되지 않았다.

setAutoIncrement

void setAutoIncrement(int columnIndex, boolean property) throws SQLException

setCaseSensitive

void setCaseSensitive(int columnIndex, boolean property) throws SQLException

setCatalogName

void setCatalogName(int columnIndex, String catalogName) throws SQLException

setColumnCount

void setColumnCount(int columnCount) throws SQLException

setColumnDisplaySize

void setColumnDisplaySize(int columnIndex, int size) throws SQLException

setColumnLabel

void setColumnLabel(int columnIndex, String label) throws SQLException

setColumnName

void setColumnName(int columnIndex, String columnName) throws SQLException

setColumnType

void setColumnType(int columnIndex, int SQLType) throws SQLException

setColumnTypeName

void setColumnTypeName(int columnIndex, String typeName) throws SQLException

setCurrency

void setCurrency(int columnIndex, boolean property) throws SQLException

setNullable

void setNullable(int columnIndex, int property) throws SQLException

setPrecision

void setPrecision(int columnIndex, int precision) throws SQLException

setScale

void setScale(int columnIndex, int scale) throws SQLException

setSchemaName

void setSchemaName(int columnIndex, String schemaName) throws SQLException

setSearchable

void setSearchable(int columnIndex, boolean property) throws SQLException

setSigned

void setSigned(int columnIndex, boolean property) throws SQLException

setTableName

void setTableName(int columnIndex, String tableName) throws SQLException

Savepoint

getSavepointId

int getSavepointId() throws SQLException

• 동작: 자동으로 부여된 ID 값을 반환한다.

• 예외: Savepoint 객체에 이름을 주어 생성한 경우 ID를 가지지 않으므로 SQLException이 발생한다.

getSavepointName

String getSavepointName() throws SQLException

• 동작: Savepoint 객체를 생성할 때 지정한 이름을 반환한다.

• 예외: 자동 ID 값으로 savepoint 객체를 생성한 경우, SQLException이 발생한다.

SQLData

클래스가 구현되지 않았다.

getSQLTypeName

String getSQLTypeName() throws SQLException

readSQL

void readSQL(SQLInput stream, String typeName) throws SQLException

writeSQL

void writeSQL(SQLOutput stream) throws SQLException

SQLXML

클래스가 구현되지 않았다.

free

void free() throws SQLException

getBinaryStream

InputStream getBinaryStream() throws SQLException

getCharacterStream

Reader getCharacterStream() throws SQLException

getSource

<T extends Source> T getSource(Class<T> sourceClass) throws SQLException

getString

String getString() throws SQLException

setBinaryStream

OutputStream setBinaryStream() throws SQLException

setCharacterStream

Writer setCharacterStream() throws SQLException

setResult

<T extends Result> T setResult(Class<T> resultClass) throws SQLException

setString

void setString(String value) throws SQLException

Statement

addBatch

void addBatch(String sql) throws SQLException

• 동작: SQL 문을 batch job에 추가한다.

• 예외: 발생하지 않는다.

cancel

void cancel() throws SQLException

• 동작: 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException을 반환한다.

clearBatch

void clearBatch() throws SQLException

• 동작: 등록된 batch job들을 모두 제거한다. 등록된 batch job이 없을 경우, 아무런 작업도 하지 않는다.

• 예외: 발생하지 않는다.

clearWarnings

void clearWarnings() throws SQLException

• 동작: Statement 객체가 가지고 있는 SQLWarning 객체들을 모두 제거한다.

• 예외: 발생하지 않는다.

close

void close() throws SQLException

• 동작: 현재 statement 객체를 close하고 서버에 할당된 statement 관련 정보가 있을 경우, 이를 해제한다. 이 객체에서 생성한 ResultSet이 있으면 이를 모두 close한다. 이 statement 객체를 생성한 connection 객체로부터 이 객체를 제거한다.

• 예외: 서버로부터 statement 정보를 해제할 때 에러가 발생하면 예외가 발생한다.

execute

boolean execute(String sql) throws SQLException

• 동작: SQL 문을 실행한다. 실행한 SQL 문이 ResultSet을 가지면 true를, 그렇지 않으면 false를 반환한다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하면 예외가 발생한다.

boolean execute(String sql, int autoGeneratedKeys) throws SQLException

• 동작: SQL 문을 실행한다. 실행한 SQL 문이 ResultSet을 가지면 true를, 그렇지 않으면 false를 반환한다. Auto key generation은 지원하지 않는다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하면 예외가 발생한다. autoGeneratedKeys가 Statement.NO_GENERATED_KEYS가 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

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

• 동작: SQL 문을 실행한다. 실행한 SQL 문이 ResultSet을 가지면 true를, 그렇지 않으면 false를 반환한다. Auto key generation은 지원하지 않는다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하면 예외가 발생한다. acolumnIndexes가 null이 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

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

• 동작: SQL 문을 실행한다. 실행한 SQL 문이 ResultSet을 가지면 true를, 그렇지 않으면 false를 반환한다. Auto key generation은 지원하지 않는다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하면 예외가 발생한다. columnNames가 null이 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

executeBatch

int[] executeBatch() throws SQLException

• 동작: 등록된 batch job을 차례대로 execute한다. 각 batch job마다 서버와 통신이 발생한다. 각 batch job이 실행된 후 갱신된 row 개수들의 배열이 반환된다.

• 예외: Statement가 이미 close되었거나 등록된 batch job이 없거나 실행할 때 서버로부터 에러가 발생하면 예외가 발생한다.

executeQuery

ResultSet executeQuery(String sql) throws SQLException

• 동작: 주어진 SQL 문을 실행하고 결과의 일부를 받아서 ResultSet을 생성한다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하였거나 SQL 문이 select 구문이 아닐 경우 예외가 발생한다.

executeUpdate

int executeUpdate(String sql) throws SQLException

• 동작: SQL 문을 실행한다. 실행에 의해 갱신된 row의 개수를 반환한다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하였거나 SQL 문이 select 문일 경우, 예외가 발생한다.

int executeUpdate(String sql, int autoGeneratedKeys) throws SQLException

• 동작: SQL 문을 실행한다. 실행에 의해 갱신된 row의 개수를 반환한다. Auto key generation 기능은 지원하지 않는다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하였거나 SQL 문이 select 문일 경우 예외가 발생한다. autoGeneratedKeys가 Statement.NO_GENERATED_KEYS가 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

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

• 동작: SQL 문을 실행한다. 실행에 의해 갱신된 row의 개수를 반환한다. Auto key generation 기능은 지원하지 않는다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하였거나 SQL 문이 select 문일 경우 예외가 발생한다. columnIndexes가 null이 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

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

• 동작: SQL 문을 실행한다. 실행에 의해 갱신된 row의 개수를 반환한다. Auto key generation 기능은 지원하지 않는다.

• 예외: Statement가 이미 close되었거나 batch job이 등록되어 있거나 실행할 때 서버로부터 에러가 발생하였거나 SQL 문이 select 문일 경우 예외가 발생한다. columnNames가 null이 아닐 경우, SQLFeatureNotSupportedException이 발생한다.

getConnection

Connection getConnection() throws SQLException

• 동작: 이 객체를 생성한 connection 객체를 반환한다. PooledConnection을 통해 얻은 logical connection으로 statement 객체를 생성하였을 경우, 사용자는 이 method를 통해 physical connection이 아닌 logical connection을 얻는다.

• 예외: Statement가 이미 close 된 경우에는 예외가 발생한다.

getExplainPlan

String getExplainPlan() throws SQLException

• 동작: 비표준 method로써 GoldilocksStatement의 고유한 method이다. 생성된 plan text를 얻어온다. 이 method를 사용하려면 setExplainPlanOption() method를 통해 plan text를 생성하도록 설정해야 한다. 자세한 사용법은 Plan Text 조회를 참조한다.

• 예외: Statement가 이미 close되었거나 서버에서 에러가 발생할 경우 예외가 발생한다.

getExplainPlanOption

int getExplainPlanOption() throws SQLException

• 동작: 비표준 method로써 GoldilocksStatement의 고유한 method이다. 현재 설정된 plan text 생성에 대한 옵션을 얻어온다. 반환되는 값은 다음 값 중의 하나이고, 기본값은 GoldilocksStatement.EXPLAIN_PLAN_OPTION_OFF이다.

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_OFF

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_ON

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_ON_VERBOSE

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_ONLY

• 예외: 발생하지 않는다.

getFetchDirection

int getFetchDirection() throws SQLException

• 동작: 항상 ResultSet.FETCH_FORWARD를 반환한다.

• 예외: Statement가 이미 close 되었을 경우, 예외가 발생한다.

getFetchSize

int getFetchSize() throws SQLException

• 동작: 이 statement 객체로부터 얻는 ResultSet의 기본 fetch size를 반환한다. 기본값은 0이고, 0일 경우 fetch 할 row 개수를 서버가 자동으로 결정한다. 자세한 내용 ResultSet의 getFetchSize를 참조한다.

• 예외: Statement가 이미 close 되었을 경우, 예외가 발생한다.

getGeneratedKeys

ResultSet getGeneratedKeys() throws SQLException

• 동작: 지원하지 않는다.

• 예외: 항상 SQLFeatureNotSupportedException이 발생한다.

getMaxFieldSize

int getMaxFieldSize() throws SQLException

• 동작: Max field size를 반환한다. 이 값은 column의 최대 길이를 제한한다. Fetch 할 때 column 값이 이 길이보다 길면 나머지 데이터는 잘린다. 기본값은 0이고, 0일 경우 최대 길이는 무한대이다.

• 예외: Statement가 이미 close 되었을 경우, 예외가 발생한다.

getMaxRows

int getMaxRows() throws SQLException

• 동작: Max rows를 반환한다. Max rows는 이 statement로부터 얻은 ResultSet이 가질 수 있는 최대 row 개수를 의미한다. 최대 row 개수 이상의 row들은 무시된다. 기본값은 0이고, 0은 무제한을 의미한다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

getMoreResults

boolean getMoreResults() throws SQLException

• 동작: 현재는 한 번의 execution당 하나의 ResultSet만 가질 수 있기 때문에 항상 false를 반환한다. 현재의 ResultSet은 close된다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

boolean getMoreResults(int current) throws SQLException

getQueryTimeout

int getQueryTimeout() throws SQLException

• 동작: Query timeout 값을 얻는다. 이 값은 서버가 execution 할 때 적용하는 timeout 값으로써 실행 시간이 이 시간을 넘기면 execution이 취소되고 사용자는 timeout 관련 에러를 반환받는다. 단위는 초이며 사용자가 특별히 설정하지 않을 경우, 세션의 기본값을 가져온다. 세션의 기본값은 프로퍼티로 지정하지 않을 경우 0이며 0은 무한 대기를 의미한다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

getResultSet

ResultSet getResultSet() throws SQLException

• 동작: 현재 수행된 execution에 대해 fetch를 수행하고 fetch 결과의 일부를 받아 ResultSet을 생성한 후 반환한다. JDBC 스펙에 명시된 것처럼 execution 한 번당 이 method를 한 번만 호출하도록 구현하지 않고 이 method를 여러 번 부르더라도 같은 객체를 반환하도록 했다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다. Fetch 할 때 서버로부터 에러가 발생하면 예외가 발생한다.

getResultSetConcurrency

int getResultSetConcurrency() throws SQLException

• 동작: ResultSet concurrency를 반환한다. 이 값은 이 객체로부터 생성되는 ResultSet의 concurrency를 결정한다. 기본값은 ResultSet.CONCUR_READ_ONLY이다. Updatable cursor는 아직 지원하지 않는다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

getResultSetHoldability

int getResultSetHoldability() throws SQLException

• 동작: ResultSet holdability를 반환한다. 이 값은 이 객체로부터 생성되는 ResultSet의 holdability를 결정한다. 기본값은 ResultSet.HOLD_CURSORS_OVER_COMMIT이다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

getResultSetType

int getResultSetType() throws SQLException

• 동작: ResultSet type을 반환한다. 이 값은 이 객체로부터 생성되는 ResultSet의 type을 결정한다. 기본값은 ResultSet.TYPE_FORWARD_ONLY이다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

getUpdateCount

int getUpdateCount() throws SQLException

• 동작: 마지막으로 수행한 execution에 대한 갱신이 반영된 row 개수를 반환한다. 마지막으로 수행한 SQL 문이 UPDATE, INSERT 문이 아닐 경우에는 -1을 반환한다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

getUpdateRowCount

long getUpdateRowCount() throws SQLException

• 동작: getUpdateCount와 같지만 반환되는 타입이 long이다. 비표준 method로써 GoldilocksStatement 타입으로 캐스팅해야 사용할 수 있다.

• 예외: 발생하지 않는다.

getWarnings

SQLWarning getWarnings() throws SQLException

• 동작: 이 객체에 축적된 SQLWarning을 반환한다. 없으면 null을 반환한다.

• 예외: 발생하지 않는다.

isClosed

boolean isClosed() throws SQLException

• 동작: 이 statement가 close 되었는지 여부를 반환한다. Close되었으면 true를, 그렇지 않으면 false를 반환한다. 사용자가 명시적으로 close()를 호출했을 때 뿐만 아니라 서버에 의해서나 connection 객체에 의해서도 close 될 수 있다.

• 예외: 발생하지 않는다.

isPoolable

boolean isPoolable() throws SQLException

• 동작: Statement pooling은 지원하지 않는다. 항상 false를 반환한다.

• 예외: 발생하지 않는다.

setCursorName

void setCursorName(String name) throws SQLException

• 동작: 현재 수행된 statement에 의해 생성된 커서의 이름을 설정한다.

• 예외: 커서 이름을 설정할 때 서버로부터 에러가 발생하면 예외가 발생한다.

setEscapeProcessing

void setEscapeProcessing(boolean enable) throws SQLException

• 동작: SQL 문의 escape는 서버의 parser에서 처리되기 때문에 JDBC에서 그 기능을 막을 수는 없다. 아무런 동작도 하지 않는다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

setExplainPlanOption

void setExplainPlanOption(int option) throws SQLException

• 동작: 비표준 method로써 GoldilocksStatement의 고유 method이다. Plan text 생성 옵션을 지정한다. Option은 다음 값 중의 하나로 설정되어야 하며 그 의미는 다음과 같다.

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_OFF: Plan text를 생성하지 않는다.

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_ON: 실행할 때 plan text를 생성한다.

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_ON_VERBOSE: 실행할 때 더 자세한 plan text를 생성한다.

  • GoldilocksStatement.EXPLAIN_PLAN_OPTION_ONLY: 실행할 때 plan text를 생성하지만 실제 실행은 수행하지 않는다.

• 예외: 위의 네 가지 이외의 다른 값을 설정할 경우 예외가 발생한다.

setFetchDirection

void setFetchDirection(int direction) throws SQLException

• 동작: Fetch 방향을 설정한다. GOLDILOCKS는 forward fetch만 지원하기 때문에 direction이 ResultSet.FETCH_FORWARD가 아닐 경우, 예외가 발생한다.

• 예외: Statement가 이미 close되었거나 direction이 FETCH_FORWARD가 아닌 경우 예외가 발생한다.

setFetchSize

void setFetchSize(int rows) throws SQLException

• 동작: 이 statement 객체로부터 얻는 ResultSet의 기본 fetch size를 설정한다. 기본값은 0이고, 0일 경우 fetch 할 때 row 개수를 서버가 자동으로 결정한다. 자세한 내용은 ResultSet의 setFetchSize를 참조한다.

• 예외: Statement가 이미 close 되었을 경우, 예외가 발생한다.

setMaxFieldSize

void setMaxFieldSize(int max) throws SQLException

• 동작: Max field size를 설정한다. 이 값은 column의 최대 길이를 제한한다. Fetch 할 때 column 값이 이 길이보다 길면 나머지 데이터는 잘린다. 기본값은 0이고, 0은 최대 길이가 무한대라는 의미이다. CHAR, VARCHAR, LONG VARCHAR, BINARY, VARBINARY, LONG VARBINARY 타입에 대해서만 유효하다.

• 예외: Statement가 이미 close되었을 경우, 예외가 발생한다.

setMaxRows

void setMaxRows(int max) throws SQLException

• 동작: Max rows를 설정한다. Max rows는 이 statement로부터 얻은 ResultSet이 가질 수 있는 최대 row 개수를 의미한다. 최대 row 개수 이상의 row들은 무시된다. 기본값은 0이고, 0은 무제한을 의미한다.

• 예외: Statement가 이미 close 되었을 경우, 예외가 발생한다.

setPoolable

void setPoolable(boolean poolable) throws SQLException

• 동작: Statement pooling은 지원하지 않는다. 아무런 동작을 하지 않는다.

• 예외: 발생하지 않는다.

setQueryTimeout

void setQueryTimeout(int seconds) throws SQLException

• 동작: Query timeout 값을 설정한다. 이 값은 서버가 execution 할 때 적용하는 timeout 값으로써 실행 시간이 이 시간을 넘기면 execution이 취소되고 사용자는 timeout 관련 에러를 반환받는다. 단위는 초이다. 사용자가 특별히 설정하지 않으면 세션의 기본값이 적용된다. 세션의 기본값은 프로퍼티로 지정하지 않을 경우, 0이며 이는 무한 대기를 의미한다.

• 예외: Statement가 이미 close 되었을 경우, 예외가 발생한다.

isWrapperFor

boolean isWrapperFor(Class<?> iface) throws SQLException

• 동작: 이 객체가 iface 인터페이스를 구현한 클래스인지 여부를 묻는다. 맞으면 true를, 그렇지 않으면 false를 반환한다. GOLDILOCKS statement 객체는 다른 클래스의 wrapper가 아니므로 wrapper의 유무는 판단하지 않고 오직 주어진 인자 클래스 타입을 구현했는지 여부만 묻는다.

• 예외: 발생하지 않는다.

unwrap

<T> T unwrap(Class<T> iface) throws SQLException

• 동작: GOLDILOCKS statement는 다른 클래스의 wrapper가 아니므로 unwrap 하더라도 결국 자기 자신을 반환한다. 해당 타입으로 캐스팅한 후에 반환한다. iface가 isWrapperFor() method의 인자로 주어졌을 때 false를 반환하는 값이라면 이 method가 예외를 발생시킨다.

• 예외: iface가 이 객체의 타입이 아닌 경우 (이 객체가 implement 하지 않은 타입을 준 경우) SQLException이 발생한다.

Struct

클래스가 구현되지 않았다.

getAttributes

Object[] getAttributes() throws SQLException

getAttributes

Object[] getAttributes(Map<String,Class<?>> map) throws SQLException

getSQLTypeName

String getSQLTypeName() throws SQLException

XAConnection

getXAResource

XAResource getXAResource() throws SQLException

• 동작: XA 명령을 수행할 수 있는 XAResource 객체를 반환한다. Method를 여러 번 호출하면 계속 같은 결과를 반환받는다.

• 예외: 발생하지 않는다.

XADataSource

getXAConnection

XAConnection getXAConnection() throws SQLException

• 동작: XAConnection 객체를 생성하고 반환한다. 연결에 필요한 정보들은 별도의 비표준 method들로 사전에 설정되어 있어야 한다.

• 예외: 서버와의 연결에 실패하면 SQLException이 발생한다.

XAConnection getXAConnection(String user, String password) throws SQLException

• 동작: Username과 password로 새로운 XAConnection 객체를 열어서 반환한다. 그 외에 연결에 필요한 정보들은 별도의 비표준 method들로 사전에 설정되어 있어야 한다.

• 예외: 서버와의 연결에 실패하면 SQLException이 발생한다.

XAResource

commit

void commit(Xid xid, boolean onePhase) throws XAException

• 동작: 글로벌 트랜잭션 xid에 대해 XA commit 명령을 수행한다. onePhase를 true로 설정하면 one phase commit이 수행된다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

end

void end(Xid xid, int flags) throws XAException

• 동작: 글로벌 트랜잭션 xid에 대해 XA end 명령을 수행한다. flags는 TMSUCCESS, TMFAIL 또는 TMSUSPEND 중의 하나를 가진다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

forget

void forget(Xid xid) throws XAException

• 동작: 글로벌 트랜잭션 xid에 대해 XA forget 명령을 수행한다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

getTransactionTimeout

int getTransactionTimeout() throws XAException

• 동작: GOLDILOCKS는 트랜잭션 타임아웃을 지원하지 않는다. 항상 0을 반환한다.

• 예외: 발생하지 않는다.

isSameRM

boolean isSameRM(XAResource xares) throws XAException

• 동작: XAResource 객체가 생성될 때 고유의 rmid를 가지는데 이 rmid로 동일한 XAResource 객체인지 여부를 판단한다.

• 예외: 발생하지 않는다.

prepare

int prepare(Xid xid) throws XAException

• 동작: 글로벌 트랜잭션 xid에 대해 XA prepare 명령을 수행한다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

recover

Xid[] recover(int flag) throws XAException

• 동작: 주어진 flag로 XA recover 명령을 수행하고 prepare된 트랜잭션 브랜치들의 배열을 반환받는다. flag는 TMSTARTRSCAN, TMENDRSCAN, TMNOFLAGS 중 하나의 값을 가질 수 있다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

rollback

void rollback(Xid xid) throws XAException

• 동작: 글로벌 트랜잭션 xid에 대해 XA rollback 명령을 수행한다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

setTransactionTimeout

boolean setTransactionTimeout(int seconds) throws XAException

• 동작: GOLDILOCKS는 트랜잭션 타임아웃을 지원하지 않는다. 아무런 작업을 하지 않는다.

• 예외: 발생하지 않는다.

start

void start(Xid xid, int flags) throws XAException

• 동작: 주어진 flag로 글로벌 트랜잭션을 시작한다. flag는 TMNOFLAGS, TMJOIN, TMRESUME 중 하나의 값을 가질 수 있다.

• 예외: 수행 결과 에러가 발생하면 XAException이 발생한다.

GoldilocksInterval

GoldilocksInterval 객체를 사용하여 GOLDILOCKS의 column에 값을 부여하려면 추가 타입 사용하기를 참조한다.

createIntervalYear

public static GoldilocksInterval createIntervalYear(int yearPrecision, boolean sign, int year) throws SQLException

• 동작: 주어진 year 값을 가지고 GoldilocksInterval 객체를 생성한다. yearPrecision은 year가 가질 수 있는 자릿수를 의미한다. Year는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 주어진 year 값이 yearPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalYear(int yearPrecision, String year) throws SQLException

• 동작: 주어진 year 값을 가지고 GoldilocksInterval 객체를 생성한다. yearPrecision은 year가 가질 수 있는 자릿수를 의미한다. Year는 0 이상의 정수 값이어야 한다.

• 예외: 주어진 year 값이 yearPrecision을 초과하면 에러가 발생한다.

createIntervalMonth

public static GoldilocksInterval createIntervalMonth(int monthPrecision, boolean sign, int month) throws SQLException

• 동작: 주어진 month 값을 가지고 GoldilocksInterval 객체를 생성한다. monthPrecision은 month가 가질 수 있는 자릿수를 의미한다. Month는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 주어진 month 값이 monthPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalMonth(int monthPrecision, String month) throws SQLException

• 동작: 주어진 month 값을 가지고 GoldilocksInterval 객체를 생성한다. monthPrecision은 month가 가질 수 있는 자릿수를 의미한다. Month는 0 이상의 정수 값이어야 한다.

• 예외: 주어진 month 값이 monthPrecision을 초과하면 에러가 발생한다.

createIntervalYearToMonth

public static GoldilocksInterval createIntervalYearToMonth(int yearPrecision, boolean sign, int year, int month) throws SQLException

• 동작: 주어진 year, month 값을 가지고 GoldilocksInterval 객체를 생성한다. yearPrecision은 year가 가질 수 있는 자릿수를 의미한다. Year, month는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 주어진 year 값이 yearPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalYearToMonth(int yearPrecision, String yearToMonth) throws SQLException

• 동작: 주어진 yearToMonth 값을 가지고 GoldilocksInterval 객체를 생성한다. yearPrecision은 year가 가질 수 있는 자릿수를 의미한다. yearToMonth는 "yy-mm" 패턴을 만족해야 한다.

• 예외: 주어진 year 값이 yearPrecision을 초과하면 에러가 발생한다.

createIntervalDay

public static GoldilocksInterval createIntervalDay(int dayPrecision, boolean sign, int day) throws SQLException

• 동작: 주어진 day 값을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. Day는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 주어진 day 값이 dayPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalDay(int dayPrecision, String day) throws SQLException

• 동작: 주어진 day 값을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. Day는 0 이상의 정수 값이어야 한다.

• 예외: 주어진 day 값이 dayPrecision을 초과하면 에러가 발생한다.

createIntervalHour

public static GoldilocksInterval createIntervalHour(int hourPrecision, boolean sign, int hour) throws SQLException

• 동작: 주어진 hour 값을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. Hour는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고, 음수이면 false이다.

• 예외: 주어진 hour 값이 hourPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalHour(int hourPrecision, String hour) throws SQLException

• 동작: 주어진 hour 값을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. Hour는 0 이상의 정수 값이어야 한다.

• 예외: 주어진 hour 값이 hourPrecision을 초과하면 에러가 발생한다.

createIntervalMinute

public static GoldilocksInterval createIntervalMinute(int minutePrecision, boolean sign, int minute) throws SQLException

• 동작: 주어진 minute 값을 가지고 GoldilocksInterval 객체를 생성한다. minutePrecision은 minute가 가질 수 있는 자릿수를 의미한다. Minute는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 주어진 minute 값이 minutePrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalMinute(int minutePrecision, String minute) throws SQLException

• 동작: 주어진 minute 값을 가지고 GoldilocksInterval 객체를 생성한다. minutePrecision은 minute가 가질 수 있는 자릿수를 의미한다. Minute는 0 이상의 정수 값이어야 한다.

• 예외: 주어진 minute 값이 minutePrecision을 초과하면 에러가 발생한다.

createIntervalSecond

public static GoldilocksInterval createIntervalSecond(int secondPrecision, int fractionalPrecision, boolean sign, int second, int microsecond) throws SQLException

• 동작: 주어진 second 값을 가지고 GoldilocksInterval 객체를 생성한다. secondPrecision은 second가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Second와 microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 주어진 second 값이 secondPrecision을 초과하거나 microSecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalSecond(int secondPrecision, int fractionalPrecision, boolean sign, int day, int hour, int minute, int second, int microsecond) throws SQLException

• 동작: 주어진 day, hour, minute, second, microsecond 값을 가지고 GoldilocksInterval 객체를 생성한다. secondPrecision은 day, hour, minute, second를 second로 환산했을 때 second가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Day, hour, minute, second, microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: 환산된 second 값이 secondPrecision을 초과하거나 microSecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalSecond(int secondPrecision, int fractionalPrecision, String second) throws SQLException

• 동작: 주어진 second 문자열을 가지고 GoldilocksInterval 객체를 생성한다. secondPrecision은 second가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Second 문자열은 "dd hh:mm:ss.ffffff"나 "dd hh:mm:ss", "dd hh:mm", "dd hh", "hh:mm", "ss.ffffff", "ss" 패턴 중 하나여야 한다.

• 예외: 환산된 second 값이 secondPrecision을 초과하거나 microSecond 값이 fractionalPrecision을 초과하면 에러가 발생한다. 문자열이 정해진 포맷에 적합하지 않을 경우에도 에러가 발생한다.

createIntervalDayToHour

public static GoldilocksInterval createIntervalDayToHour(int dayPrecision, boolean sign, int day, int hour) throws SQLException

• 동작: 주어진 day, hour 값을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. Day, hour는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Day 값이 dayPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalDayToHour(int dayPrecision, String dayToHour) throws SQLException

• 동작: 주어진 dayToHour 문자열을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. dayToHour는 "dd hh" 포맷을 만족해야 한다. 혹은 "dd hh:mm:ss"와 같은 포맷일 경우, dd, hh 외에는 모두 0이어야 한다.

• 예외: Day 값이 dayPrecision을 초과하거나 주어진 문자열이 포맷을 만족하지 않으면 에러가 발생한다.

createIntervalDayToMinute

public static GoldilocksInterval createIntervalDayToMinute(int dayPrecision, boolean sign, int day, int hour, int minute) throws SQLException

• 동작: 주어진 day, hour, minute 값을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. Day, hour, minute는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Day 값이 dayPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalDayToMinute(int dayPrecision, String dayToMinute) throws SQLException

• 동작: 주어진 dayToMinute 문자열을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. dayToMinute는 "dd hh:mm" 포맷을 만족해야 한다. 혹은 "dd hh:mm:ss"와 같은 포맷일 경우, dd, hh, mm 외에는 모두 0이어야 한다.

• 예외: Day 값이 dayPrecision을 초과하거나 주어진 문자열이 포맷을 만족하지 않으면 에러가 발생한다.

createIntervalDayToSecond

public static GoldilocksInterval createIntervalDayToSecond(int dayPrecision, int fractionalPrecision, boolean sign, int day, int hour, int minute, int second, int microsecond) throws SQLException

• 동작: 주어진 day, hour, minute, second, microsecond 값을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Day, hour, minute, second, microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Day 값이 dayPrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalDayToSecond(int dayPrecision, String dayToSecond) throws SQLException

• 동작: 주어진 dayToSecond 문자열을 가지고 GoldilocksInterval 객체를 생성한다. dayPrecision은 day가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. dayToSecond는 "dd hh:mm:ss.ffffff", "dd hh:mm:ss", "hh:mm:ss" 또는 "hh:mm" 포맷을 만족해야 한다.

• 예외: Day 값 또는 환산된 day 값이 dayPrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하거나 주어진 문자열이 포맷을 만족하지 않을 경우, 에러가 발생한다.

createIntervalHourToMinute

public static GoldilocksInterval createIntervalHourToMinute(int hourPrecision, boolean sign, int hour, int minute) throws SQLException

• 동작: 주어진 hour, minute 값을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. Hour, minute는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Hour 값이 hourPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalHourToMinute(int hourPrecision, boolean sign, int day, int hour, int minute) throws SQLException

• 동작: 주어진 day, hour, minute 값을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. Day, hour, minute는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Hour 값 또는 환산된 hour 값이 이 hourPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalHourToMinute(int hourPrecision, String hourToMinute) throws SQLException

• 동작: 주어진 hourToMinute 문자열을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. hourToMinute는 "hh:mm"를 만족해야 한다. 다른 포맷일 경우 ss나 ffffff 값은 모두 0이어야 한다.

• 예외: Hour 값 또는 환산된 hour 값이 hourPrecision을 초과하면 에러가 발생한다. 주어진 문자열이 포맷을 만족하지 않아도 에러가 발생한다.

createIntervalHourToSecond

public static GoldilocksInterval createIntervalHourToSecond(int hourPrecision, int fractionalPrecision, boolean sign, int hour, int minute, int second, int microsecond) throws SQLException

• 동작: 주어진 hour, minute, second, microsecond 값을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Hour, minute, second, microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Hour 값이 hourPrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalHourToSecond(int hourPrecision, int fractionalPrecision, boolean sign, int day, int hour, int minute, int second, int microsecond) throws SQLException

• 동작: 주어진 day, hour, minute, second, microsecond 값을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Day, hour, minute, second, microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Hour 값 또는 환산된 hour 값이 hourPrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalHourToSecond(int hourPrecision, int fractionalPrecision, String hourToSecond) throws SQLException

• 동작: 주어진 hourToSecond 문자열을 가지고 GoldilocksInterval 객체를 생성한다. hourPrecision은 hour가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. hourToSecond는 "hh:mm:ss.ffffff", "hh:mm:ss" 또는 "hh:mm" 포맷을 만족해야 한다. dd를 포함할 경우, 환산된 hour 값이 hourPrecision을 초과하면 안된다.

• 예외: Hour 값 또는 환산된 hour 값이 hourPrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하거나 주어진 문자열이 포맷을 만족하지 않으면 에러가 발생한다.

createIntervalMinuteToSecond

public static GoldilocksInterval createIntervalMinuteToSecond(int minutePrecision, int fractionalPrecision, boolean sign, int minute, int second, int microsecond) throws SQLException

• 동작: 주어진 minute, second, microsecond 값을 가지고 GoldilocksInterval 객체를 생성한다. minutePrecision은 minute가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Minute, second, microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Minute 값이 minutePrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalMinuteToSecond(int minutePrecision, int fractionalPrecision, boolean sign, int day, int hour, int minute, int second, int microsecond) throws SQLException

• 동작: 주어진 day, hour, minute, second, microsecond 값을 가지고 GoldilocksInterval 객체를 생성한다. minutePrecision은 minute가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. Day, hour, minute, second, microsecond는 0 이상의 값이어야 한다. Sign은 시간이 양수이면 true이고 음수이면 false이다.

• 예외: Minute 값 또는 환산된 minute 값이 minutePrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하면 에러가 발생한다.

public static GoldilocksInterval createIntervalMinuteToSecond(int minutePrecision, int fractionalPrecision, String minuteToSecond) throws SQLException

• 동작: 주어진 minuteToSecond 문자열을 가지고 GoldilocksInterval 객체를 생성한다. minutePrecision은 minute가 가질 수 있는 자릿수를 의미한다. fractionalPrecision은 microsecond가 가질 수 있는 자릿수를 의미한다. minuteToSecond는 "mm:ss.ffffff"나 "mm:ss" 포맷을 만족해야 한다. dd나 hh를 포함할 경우, 환산된 minute 값이 minutePrecision을 넘으면 안된다.

• 예외: Minute 값 또는 환산된 minute 값이 minutePrecision을 초과하거나 microsecond 값이 fractionalPrecision을 초과하거나 주어진 문자열이 포맷을 만족하지 않을 경우, 에러가 발생한다.

getSign

public int getSign()

• 동작: 시간이 양수이면 1을, 음수이면 -1을 반환한다.

• 예외: 발생하지 않는다.

getYear

public int getYear()

• 동작: Year 값을 반환한다. Interval 객체가 음수인지 여부는 getYear()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getMonth

public int getMonth()

• 동작: Month 값을 반환한다. Interval 객체가 음수인지 여부는 getMonth()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getAccumulatedMonth

public int getAccumulatedMonth()

• 동작: Year와 month를 month로 환산한 값을 반환한다.

• 예외: 발생하지 않는다.

getDay

public int getDay()

• 동작: Day 값을 반환한다. Interval 객체가 음수인지 여부는 getDay()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getHour

public int getHour()

• 동작: Hour 값을 반환한다. Interval 객체가 음수인지 여부는 getHour()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getAccumulatedHour

public int getAccumulatedHour()

• 동작: Day와 hour를 hour로 환산한 값을 반환한다.

• 예외: 발생하지 않는다.

getMinute

public int getMinute()

• 동작: Minute 값을 반환한다. Interval 객체가 음수인지 여부는 getMinute()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getAccumulatedMinute

public int getAccumulatedMinute()

• 동작: Day, hour, minute를 minute로 환산한 값을 반환한다.

• 예외: 발생하지 않는다.

getSecond

public int getSecond()

• 동작: Second 값을 반환한다. Interval 객체가 음수인지 여부는 getSecond()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getAccumulatedSecond

public int getAccumulatedSecond()

• 동작: Day, hour, minute, second를 second로 환산한 값을 반환한다.

• 예외: 발생하지 않는다.

getMicroSecond

public int getMicroSecond()

• 동작: Microsecond 값을 반환한다. Interval 객체의 음수 여부는 getMicroSecond()를 통해 반환되지 않는다.

• 예외: 발생하지 않는다.

getAccumulatedMicroSecond

public long getAccumulatedMicroSecond()

• 동작: Day, hour, minute, second, microsecond를 microsecond로 환산한 값을 반환한다.

• 예외: 발생하지 않는다.

getTypeName

public String getTypeName()

• 동작: 타입 이름을 반환한다.

• 예외: 발생하지 않는다.

getSqlType

public int getSqlType()

• 동작: 이 객체에 해당되는 타입을 GoldilocksTypes에 정의된 타입 상수로 반환한다.

• 예외: 발생하지 않는다.

toString

public String toString()

• 동작: 이 객체가 나타내는 interval 값을 문자열로 반환한다.

• 예외: 발생하지 않는다.

GOLDILOCKS Type

상수 정의

public static final int INTERVAL_YEAR;
public static final int INTERVAL_MONTH;
public static final int INTERVAL_DAY;
public static final int INTERVAL_HOUR;
public static final int INTERVAL_MINUTE;
public static final int INTERVAL_SECOND;
public static final int INTERVAL_YEAR_TO_MONTH;
public static final int INTERVAL_DAY_TO_HOUR;
public static final int INTERVAL_DAY_TO_MINUTE;
public static final int INTERVAL_DAY_TO_SECOND;
public static final int INTERVAL_HOUR_TO_MINUTE;
public static final int INTERVAL_HOUR_TO_SECOND;
public static final int INTERVAL_MINUTE_TO_SECOND;
public static final int TIME_WITH_TIME_ZONE;
public static final int TIMESTAMP_WITH_TIME_ZONE;

이 상수들은 java.sql.Types의 상수처럼 사용된다. 즉, PreparedStatement의 setObject나 ResultSet의 getObject에 타입을 명시할 때 사용된다. 이 타입들은 JDBC 표준에는 정의되어 있지 않으므로 GoldilocksTypes를 통해 별도로 제공된다.

타입 변환

다음 표는 타입 변환 방법을 설명한다.