패키지 java.sql

Java^TM 프로그램 언어를 사용해 데이터 소스 (통상은 리레셔널 데이터 베이스)의 데이터에 액세스 해 처리하는 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 경고를 통지하는 (read시)인가, DataTruncation 예외를 슬로우 하는 (기입시) 예외입니다.
SQLException	데이타베이스 액세스 에러 또는 그 외의 에러에 관한 정보를 제공하는 예외입니다.
SQLWarning	데이타베이스 액세스의 경고에 관한 정보를 제공하는 예외입니다.

패키지 java.sql 의 설명

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

JDBC^TM 3.0 API 에 포함되는 것

JDBC^TM 3.0 API 에는 JDBC 코어 API 로 불리는 java.sql 및 JDBC 옵션 패키지 API 로 불리는 javax.sql 가 포함됩니다. 이 완전한 JDBC API 는 Java^TM 2 SDK, Standard Edition (J2SE^TM), 버젼 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

클래스, 인터페이스, 메소드, 필드, constructor , 및 예외에는 이것들이 언제 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 가 Java^TM 2 SDK, Standard Edition, 버젼 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 -- 데이터 액세스의 장해등의 경우에 메소드가 슬로우 한다
  • SQLWarning -- 경고를 나타내기 위해서(때문에) 슬로우 된다
  • DataTruncation -- 데이터를 잘라 버릴 수 있었던 가능성이 있는 것을 나타내기 위해서(때문에) 슬로우 된다
  • BatchUpdateException -- 배치 갱신의 커멘드가 모든 것은 정상적으로 실행되지 않았던 것을 나타내기 위해서(때문에) 슬로우 된다

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 오브젝트의 형태 MAP에 엔트리를 작성합니다.
   • UDT 의 완전 지정된 SQL 명
   • SQLData 인터페이스를 구현하는 클래스의 Class 오브젝트

이것들이 UDT 의 해당 위치에 있으면(자), 메소드 ResultSet.getObject 또는 메소드 CallableStatement.getObject 를 호출했을 경우에 UDT 는 자동적으로 UDT 에의 커스텀 매핑을 취득합니다. 또,PreparedStatement.setObject 는 오브젝트를 그 SQL 형에 자동적으로 매핑 해 데이터 소스에 오브젝트를 저장합니다.

패키지의 사양

• 「Specification of the 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