JavaTM Platform
Standard Ed. 6

패키지 java.sql

JavaTM 프로그램 언어를 사용해 데이터 소스 (일반적으로은 RDB)의 데이터에 액세스 해 처리하는 API 를 제공합니다.

참조처:
          설명

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

클래스의 개요
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 형을 식별하기 위해서 사용하는 정수를 정의하는 클래스입니다.
 

열거형의 개요
ClientInfoStatus Connection.setClientInfo 의 호출에 의해 프로퍼티을 설정할 수 없는 이유 상태의 열거입니다.
RowIdLifetime RowId 의 수명의 값의 열거입니다.
 

예외의 개요
BatchUpdateException 배치 갱신 조작중에 에러가 발생했을 때에 throw 되는 SQLException 의 서브 클래스입니다.
DataTruncation MaxFieldSize 를 초과한 이외의 이유로써 데이터값가 예기 하지 않고 절약할 수 있었을 때에,DataTruncation 예외로서 throw 되는 예외 (기입시), 또는 DataTruncation 경고로서 보고되는 예외 (read시)입니다.
SQLClientInfoException 1 개(살) 이상의 클라이언트 정보 프로퍼티을 Connection 로 설정할 수 없었을 때에,SQLException 의 서브 클래스가 throw 됩니다.
SQLDataException SQLState 클래스치가 '22' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLException 데이타베이스 액세스 에러 또는 그 외의 에러에 관한 정보를 제공하는 예외입니다.
SQLFeatureNotSupportedException SQLState 클래스치가 '0A' (제로 A) 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLIntegrityConstraintViolationException SQLState 클래스치가 '23' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLInvalidAuthorizationSpecException SQLState 클래스치가 '28' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLNonTransientConnectionException SQLState 클래스치가 '08' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLNonTransientException SQLException 의 원인이 수정되지 않는 한, 같은 조작을 재시행해도 인스턴스가 실패할 경우에 throw 되는 SQLException 의 서브 클래스입니다.
SQLRecoverableException 어플리케이션이 회복 순서를 실행해 트랜잭션(transaction) 전체 (분산 트랜잭션(transaction)의 경우는 트랜잭션(transaction) 브랜치(branch))를 재시행하면 전회 실패한 조작이 성공할 가능성이 있을 때 throw 되는 SQLException 의 서브 클래스입니다.
SQLSyntaxErrorException SQLState 클래스치가 '42' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLTimeoutException Statement 로 지정한 타임 아웃이 경과했을 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLTransactionRollbackException SQLState 클래스치가 '40' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLTransientConnectionException SQLState 클래스치가 '08' 때에 throw 되는 SQLException 의 서브 클래스입니다.
SQLTransientException 전회 실패한 조작이, 어플리케이션 레벨의 기능에 의한 개입이 없어도 재시행시에 성공할 가능성이 있는 상황에서는 SQLException 의 서브 클래스가 throw 됩니다.
SQLWarning 데이타베이스 액세스의 경고에 관한 정보를 제공하는 예외입니다.
 

패키지 java.sql 의 설명

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

JDBCTM 4.0 API 에 포함되는 것

JDBCTM 4.0 API 에는, JDBC 코어 API 로 불리는 java.sql 패키지와 JDBC 옵션 패키지 API 로 불리는 javax.sql 패키지의 양쪽 모두가 포함됩니다. 이 완전한 JDBC API 는, JavaTM Standard Edition (Java SETM)의 Versio 6 에 포함됩니다. javax.sql 패키지는 JDBC API 의 기능을 클라이언트측 API 로부터 서버측 API 에 확장해서 , JavaTM Enterprise Edition (Java EETM) 기술의 필수 부분입니다.

버젼

JDBC 4.0 API 에는 이전의 버젼의 JDBC API 가 모두 짜넣어지고 있습니다.

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

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

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

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

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

JDBC 4.0 API 로 도입된 java.sqljavax.sql 의 기능

JDBC 3.0 API 로 도입된 java.sqljavax.sql 의 기능

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

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

UDT 의 커스텀 매핑

SQL 로 정의한 사용자 정의형 (UDT)을 Java 프로그램 언어의 클래스에 매핑 할 수 있습니다. SQL 구조화형 또는 SQL DISTINCT 형이, 커스텀 매핑 할 수 있는 UDT 입니다. 다음의 3 개의 스텝에서, 커스텀 매핑을 설정합니다.
  1. SQL 구조화형 또는 SQL DISTINCT 형을 SQL 로 정의합니다.
  2. SQL UDT 를 매핑 하는 Java 프로그램 언어의 클래스를 정의합니다. 이 클래스는 SQLData 인터페이스를 구현하고 있을 필요가 있습니다.
  3. 다음의 2 항목을 포함한 Connection 객체의 형태 맵에 엔트리를 작성합니다.

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

패키지의 스펙

관련 문서

도입된 버젼:
1.1

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.