패키지 java.sql

Java^TM 프로그램 언어를 사용해 데이터 소스 (일반적으로 RDB)의 데이터에 접속해 처리하는 API를 제공합니다.

참조처:
설명

인터페이스 개요

Array	SQL 형 ARRAY Java 프로그램 언어에서의 매핑입니다.
Blob	SQL BLOB값의 JavaTM 프로그램 언어에서의 표현 (매핑)입니다.
CallableStatement	SQL 스토어드 프로시저를 실행하는데 사용되는 인터페이스입니다.
Clob	SQL CLOB 형태의 JavaTM 프로그램 언어에서의 매핑입니다.
Connection	특정의 데이타베이스와의 접속 (세션)을 표현합니다.
DatabaseMetaData	데이타베이스에 관한 포괄적인 정보입니다.
Driver	모든 드라이버 클래스가 구현해야 하는 인터페이스입니다.
ParameterMetaData	PreparedStatement 객체내의 파라미터의 형태와 프로퍼티에 대한 정보의 취득에 사용하는 객체입니다.
PreparedStatement	프리컴파일 된 SQL 문을 나타내는 객체입니다.
Ref	Java 프로그램 언어에서의 SQL REF값의 매핑으로 데이타베이스의 SQL 구조화형의 값에의 참조가 됩니다.
ResultSet	데이타베이스의 결과 세트를 나타내는 데이터의 테이블로 보통, 데이타베이스에 조회하는 문장을 실행하는 것에 의해 생성됩니다.
ResultSetMetaData	ResultSet 객체의 열의 형태와 프로퍼티에 관한 정보를 얻는 데 사용할 수 있는 객체입니다.
Savepoint	Connection.rollback 메서드로부터 참조되는 현재의 트랜잭션(transaction)내의 포인트인 세이브 포인트의 표현입니다.
SQLData	SQL 사용자 정의형 (UDT)을 Java 프로그램 언어의 클래스에 커스텀 매핑 하는데 사용되는 인터페이스입니다.
SQLInput	SQL 구조화형 또는 SQL 개별의 형태의 인스턴스를 나타내는 값의 스트림을 포함하는 입력 스트림입니다.
SQLOutput	사용자 정의형의 속성을 데이타베이스에 써 되돌리기 위한 출력 스트림입니다.
Statement	정적 SQL 문을 실행해, 작성된 결과를 돌려주기 위해서 사용되는 객체입니다.
Struct	SQL 구조화형의 Java 프로그램 언어의 표준의 매핑입니다.

클래스 개요

Date	밀리 세컨드의 값을감싸는 thin 래퍼이며, 이것에 의해 JDBC가 밀리 세컨드의 값을 SQL DATE 값으로 취급할 수가 있게 됩니다.
DriverManager	일련의 JDBC 드라이버를 관리하기 위한 기본적인 서비스입니다.
DriverPropertyInfo	접속용의 드라이버 프로퍼티입니다.
SQLPermission	애플릿으로 실행되고 있는 코드가 DriverManager.setLogWriter 메서드 또는 DriverManager.setLogStream 메서드 (추천 되지 않는다)를 호출할 때, SecurityManager 확인 대상이 되는 접근 권한입니다.
Time	java.util.Date 클래스의 thin 래퍼로 이 래퍼에 의해 JDBC API는 이것을 SQL TIME 값으로 식별할 수 있습니다.
Timestamp	이 클래스는 java.util.Date thin 래퍼로 이 래퍼에 의해 JDBC API는 이것을 SQL TIMESTAMP 값으로 식별할 수 있습니다.
Types	JDBC 형으로 불리는 범용의 SQL 형을 식별하기 위해서 사용하는 정수를 정의하는 클래스입니다.

예외 개요

BatchUpdateException	배치 갱신 조작중에 에러가 발생했을 때에 발생되는 예외입니다.
DataTruncation	JDBC 로 예상외로 데이터의 잘라서 버림이 발생했을 때에 독해의 경우는 DataTruncation 경고를 보고해, 출력의 경우는 DataTruncation 예외를 Throw 하는 예외입니다.
SQLException	데이타베이스 액세스 에러 또는 그 외의 에러에 관한 정보를 제공하는 예외입니다.
SQLWarning	데이타베이스 액세스의 경고에 관한 정보를 제공하는 예외입니다.

패키지 java.sql 설명

Java^TM 프로그램 언어를 사용해 데이터 소스 (일반적으로 RDB)의 데이터에 접속해 처리하는 API를 제공합니다. 이 API에 포함되어 있는 체제로 복수의 드라이버를 인스톨의해 복수의 데이터 소스에 동적으로 액세스 할 수 있습니다. JDBC^TM API는 주로 SQL 문을 데이타베이스에 건네주기 위해서 만들어지고 있습니다만, 겉(표) 형식의 임의의 데이터 소스의 데이터의 read 및 write를 제공합니다. javax.sql.RowSet인터페이스 그룹을 개입시켜 사용 가능한 읽기 /출력 기능은 스프레드쉬트, 플랫 파일, 또는 다른 겉(표) 형식의 데이터 소스의 데이터를 사용 또는 갱신하기 위해서 커스터마이즈 할 수 있습니다.

JDBC^TM 3.0 API에 포함되는 것

JDBC^TM 3.0 API 에는 JDBC 코어 API 로 불리는 java.sql 패키지와 JDBC 옵션 패키지 API 로 불리는 javax.sql 패키지의 양쪽 모두가 포함됩니다. 이 완전한 JDBC API는 J2SE 1.4에 포함되어 있습니다. javax.sql 패키지는 JDBC API 기능을 클라이언트측 API 로부터 서버측 API에 확장해서, Java^TM 2 SDK, Enterprise Edition(J2EE^TM) 기술의 필수 부분입니다 (J2EE 플랫폼에도 완전한 JDBC API가 포함된다. JDBC 3.0 API 신기능은 J2EE 버전 1.3에 포함된다).

버전

JDBC 3.0 API에는 이전의 버전의 JDBC API가 모두 삽입되어 있습니다.

• JDBC 2.1 코어 API
• JDBC 2.0 옵션 패키지 API
  (JDBC 2.1 코어 API와 JDBC 2.0 옵션 패키지 API를 아울러, JDBC 2.0 API 라고 부른다)
• JDBC 1.2 API
• JDBC 1.0 API

클래스, 인터페이스, 메서드, 필드, 생성자 및 예외에는 이것들이 언제 Java 플랫폼에 도입되었는지를 나타내는 다음의 since 태그가 있습니다. since 태그가 JDBC API Javadoc^TM 코멘트로 사용되고 있는 경우, 그 미는 다음과 같습니다.

• since 1.4 -- JDBC 3.0 API에 새롭게 추가. J2SE 플랫폼, 버전 1.4 부분
• since 1.2 -- JDBC 2.0 API에 새롭게 추가. J2SE 플랫폼, 버전 1.2 부분
• since 1.1 또는 since 태그 없음 -- JDBC 1.0 API에 새롭게 추가. JDK^TM, 버전 1.1 부분

주: 신기능의 상당수는 옵션입니다. 따라서, 드라이버 및 드라이버가 지원하는 기능에는 몇개의 바리에이션이 있습니다. 기능을 사용하기 전에 그 기능이 지원 되고 있는지를 드라이버의 문서로 반드시 확인해 주세요.

주: 클래스 SQLPermission가 JDK 1.3 릴리스로 추가되었습니다. 이 클래스를 사용하면, 테이블명, 열데이터등의 정보를 포함하는 DriverManager에 관련한 로그 스트림에의 무권한에서의 액세스를 방지할 수 있습니다.

java.sql 패키지에 포함되는 것

java.sql 패키지는 다음의 용도의 API를 포함하고 있습니다.

• DriverManager 기능을 포함한 데이터 소스와의 접속
  • DriverManager 클래스 -- 드라이버와의 접속
  • SQLPermission 클래스 -- 애플릿등의 시큐러티 매니저내에서 실행되는 코드가 DriverManager를 개입시켜 로그 스트림을 설정하려고 할 때 접근 권한을 허가한다
  • Driver인터페이스 -- JDBC 테크놀러지에 근거하는 드라이버 (JDBC 드라이버)의 등록 및 접속을 API에 제공한다. 일반적으로 DriverManager 클래스만이 사용한다
  • DriverPropertyInfo 클래스 -- JDBC 드라이버의 프로퍼티를 제공한다. 일반 사용자는 사용하지 않는다
• 데이타베이스에의 SQL 문의 송신
  • Statement -- 기본 SQL 문을 송신한다
  • PreparedStatement -- 준비된 문장 또는 기본 SQL 문을 송신한다 (Statement로 부터 파생)
  • CallableStatement -- 데이타베이스스토어드 프로시저를 호출한다 (PreparedStatement로 부터 파생)
  • Connection인터페이스 -- 문을 작성해, 접속과 그 프로퍼티를 관리하는 메서드를 제공한다
  • Savepoint -- 트랜잭션(transaction)에 대해 세이브 포인트를 제공한다
• 쿼리결과의 취득과 갱신
  • ResultSet인터페이스
• SQL 형을 Java 프로그램 언어의 클래스 및 인터페이스에 표준 매핑
  • Array인터페이스 -- SQL ARRAY를 매핑 한다
  • Blob인터페이스 -- SQL BLOB를 매핑 한다
  • Clob인터페이스 -- SQL CLOB를 매핑 한다
  • Date 클래스 -- SQL DATE를 매핑 한다
  • Ref인터페이스 -- SQL REF를 매핑 한다
  • Struct인터페이스 -- SQL STRUCT를 매핑 한다
  • Time 클래스 -- SQL TIME를 매핑 한다
  • Timestamp 클래스 -- SQL TIMESTAMP를 매핑 한다
  • Types 클래스 -- SQL 형의 정수를 제공한다
• SQL 사용자 정의형 (UDT)을 Java 프로그램 언어의 클래스에 커스텀 매핑
  • SQLData인터페이스 -- 이 클래스의 인스턴스에의 UDT 매핑을 지정한다
  • SQLInput인터페이스 -- 스트림로부터 UDT 속성을 읽어들이는 메서드를 제공한다
  • SQLOutput인터페이스 -- 스트림에 UDT 속성을 출력하는 메서드를 제공한다
• 메타데이타
  • DatabaseMetaData인터페이스 -- 데이타베이스에 관한 정보를 제공한다
  • ResultSetMetaData인터페이스 -- ResultSet 객체의 열에 관한 정보를 제공한다
  • ParameterMetaData인터페이스 -- PreparedStatement 커멘드의 파라미터에 관한 정보를 제공한다
• 예외
  • SQLException -- 데이터 액세스의 장해등의 경우에 메서드가 Throw 한다
  • SQLWarning -- 경고를 나타내기 위해서 Throw 된다
  • DataTruncation -- 데이터를 잘라 버릴 수 있었던 가능성이 있는 것을 나타내기 위해서 Throw 된다
  • BatchUpdateException -- 배치 갱신의 커멘드가 모든 것은 정상적으로 실행되지 않았던 것을 나타내기 위해서 Throw 된다

JDBC 3.0 API 로 도입된 java.sql와 javax.sql 기능

• 풀문 -- 풀 접속에 관련한 문장을 재이용한다
• 세이브 포인트 -- 지정된 세이브 포인트까지 트랜잭션(transaction)를 롤백(rollback) 한다
• ConnectionPoolDataSource에 정의된 프로퍼티 -- 접속의 풀 방법을 지정한다
• PreparedStatement 객체의 파라미터의 메타데이타
• 자동 생성된 열로부터 값을 취득한다
• 동시에 오픈된 CallableStatement 객체로부터 리턴된 복수의 ResultSet 객체를 가진다
• CallableStatement 객체에의 파라미터를 이름과 인덱스에 의해 식별한다
• ResultSet 보관 유지 기능 -- 트랜잭션(transaction)의 종료로 커서를 오픈 상태 로 유지할까 클로우즈 상태 로 유지하는지를 지정한다
• Ref 객체가 참조하는 SQL 구조화형 인스턴스를 취득 및 갱신한다
• BLOB, CLOB, ARRAY 및 REF 각 치를 프로그램에 의해 갱신한다
• java.sql.Types.DATALINK 데이터형의 추가 -- JDBC 드라이버가 데이터 소스의 외부에 포함된 객체에 액세스 할 수 있도록 한다
• SQL 형 계층을 얻는 메타데이타의 추가

JDBC 2.1 코어 API 로 도입된 java.sql 기능

• 스크롤 가능한 결과 세트 -- 현재 위치에 관련된 특정의 행 또는 위값의 커서의 이동을 가능하게 하는 ResultSet인터페이스의 새로운 메서드를 사용
• 배치 갱신
• 프로그램의 갱신 -- ResultSet 갱신용 메서드를 사용
• 새로운 데이터형 -- SQL3 데이터형을 매핑 하는 인터페이스
• 사용자 정의형 (UDT)의 커스텀 매핑
• 그 외의 기능으로서 퍼포먼스의 힌트, 문자 스트림의 사용, java.math.BigDecimal값의 전정밀도, 추가 시큐러티, 날, 시간 및 타임 스탬프의 각 치에서의 타임 존의 지원 등

JDBC 2.0 옵션 패키지 API 로 도입된 javax.sql 기능

• 접속을 확립하기 위한 수단으로서의 DataSource인터페이스. Java Naming and Directory Interface^TM (JNDI)는 DataSource 객체를 네임 서비스에 등록해, 그것을 얻는 데 사용한다
• 풀 접속 -- 접속의 사용과 재이용을 가능하게 한다
• 분산 트랜잭션(transaction) -- 다양한 DBMS 서버에 이르는 트랜잭션(transaction)를 가능하게 한다
• RowSet 테크놀러지 -- 데이터를 처리해 건네주는 편리한 수단을 제공한다

UDT 커스텀 매핑

SQL 로 정의한 사용자 정의형 (UDT)을 Java 프로그램 언어의 클래스에 매핑 할 수 있습니다. SQL 구조화형 또는 SQL DISTINCT 형이, 커스텀 매핑 할 수 있는 UDT 입니다. 다음의 3개의 스텝에서 커스텀 매핑을 설정합니다.

1. SQL 구조화형 또는 SQL DISTINCT 형을 SQL 로 정의합니다.
2. SQL UDT를 매핑 하는 Java 프로그램 언어의 클래스를 정의합니다. 이 클래스는 SQLData인터페이스를 구현하고 있을 필요가 있습니다.
3. 다음의 2 항목을 포함한 Connection 객체의 형태 맵에 엔트리를 작성합니다.
   • UDT 완전 지정된 SQL 명
   • SQLData인터페이스를 구현하는 클래스의 Class 객체

이것들이 UDT 해당 위치에 있으면, 메서드 ResultSet.getObject 또는 메서드 CallableStatement.getObject를 호출했을 경우에 UDT는 자동적으로 UDT 에의 커스텀 매핑을 취득합니다. 또, PreparedStatement.setObject는 객체를 그 SQL 형에 자동적으로 매핑의해 데이터 소스에 객체를 포함합니다.

패키지의 사양

• 「JDBC 3.0 API 사양」

관련 문서

「JDBC API 입문」 -- 주된 인터페이스 개요

JDBC API 장 -- 「The Java Tutorial Continued」의 온라인 버전 보다

「JDBC^TMAPI Tutorial and Reference, Second Edition: Universal Data Access for the Java 2 Platform 」 -- JDBC 2.0 API 완전한 레퍼런스와 튜토리얼

도입된 버전 :

1.1