javax.sql
인터페이스 DataSource

public interface DataSource

이 DataSource 객체가 나타내는 물리 데이터 소스에의 접속에 대한 팩토리입니다. DriverManager 기능 대신에 DataSource 객체가 접속을 얻기 위한 적절한 수단이 됩니다. DataSource인터페이스를 구현하는 객체는 일반적으로 Java^TM Naming and Directory (JNDI) API를 기본으로 한 네임 서비스로 등록되어 있습니다.

DataSource인터페이스는 드라이버 벤더에 의해 구현되고 있습니다. 구현에는 3 종류 있습니다.

1. 기본 구현 -- 표준 Connection 객체를 생성한다
2. 접속 풀 구현 -- 자동적으로 접속 풀에 참가하는 Connection 객체를 생성한다. 이 구현은 중간층의 접속 풀 관리 프로그램과 함께 동작한다
3. 분산 트랜잭션(transaction) 구현 -- 분산 트랜잭션(transaction)로 사용되어 대부분의 경우에 항상 접속 풀에 참가하는 Connection 객체를 생성한다. 이 구현은 중간층의 트랜잭션(transaction) 매니저와 많은 경우는 항상 접속 풀 관리 프로그램과 함께 동작하는

DataSource객체는 필요에 따라서 변경 가능한 프로퍼티를 보관 유지합니다. 예를 들어 데이터 소스가 다른 서버에 이동했을 경우, 그 서버에 대한 프로퍼티를 변경할 수 있습니다. 데이터 소스의 프로퍼티를 변경할 수 있기 때문에 데이터 소스에 액세스 하는 코드를 변경할 필요가 없다고 하는 이점이 있습니다.

DataSource 객체를 개입시켜 액세스 된 드라이버는 자기 자신을 DriverManager로 등록하지 않습니다. 오히려, DataSource 객체가 룩 업 조작에 의해 취득되어, Connection 객체를 작성하기 위해서 사용됩니다. 기본 구현에서는 DataSource 객체에 의해 취득된 접속은, DriverManager 기능에 의해 취득한 접속과 같은 것이 됩니다.

도입된 버전 :

1.4

메서드 개요

Connection	getConnection () 이 DataSource 객체가 나타내는 데이터 소스에의 접속의 확립을 시도합니다.
Connection	getConnection (String username, String password) 이 DataSource 객체가 나타내는 데이터 소스에의 접속의 확립을 시도합니다.
int	getLoginTimeout () 데이타베이스에의 접속 시행중에 이 데이터 소스가 대기하는 최장 시간 (초)을 취득합니다.
PrintWriter	getLogWriter () 이 DataSource 객체의 로그 라이터를 취득합니다.
void	setLoginTimeout (int seconds) 데이타베이스에의 접속 시행중에 이 데이터 소스가 대기하는 최장 시간 (초)을 지정합니다.
void	setLogWriter (PrintWriter out) 이 DataSource 객체의 로그 라이터를 java.io.PrintWriter 객체로 설정합니다.

메서드의 상세

getConnection

Connection  getConnection()
                         throws SQLException 

이 DataSource 객체가 나타내는 데이터 소스에의 접속의 확립을 시도합니다.

반환값:

데이터 소스에의 접속

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getConnection

Connection  getConnection(String  username,
                         String  password)
                         throws SQLException 

이 DataSource 객체가 나타내는 데이터 소스에의 접속의 확립을 시도합니다.

파라미터:

username - 그 대리로서 접속을 하는 데이타베이스 사용자

password - 사용자 의 패스워드

반환값:

데이터 소스에의 접속

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

getLogWriter

PrintWriter  getLogWriter()
                         throws SQLException 

이 DataSource 객체의 로그 라이터를 취득합니다.

로그 라이터란 이 데이터 소스에 대해서 로그가 기록되거나 트레이스 된, 모든 메세지가 표시되는 캐릭터 출력 스트림입니다. 이 객체의 메서드에 한 메세지나, 이 객체가 작성한 것 외의 객체에 한 메세지등도 포함됩니다. 데이터 소스에 특유의 로그 Writer에 표시된 메세지는 java.sql.DriverManager 클래스에 관련된 로그 Writer에는 표시되지 않습니다. DataSource 객체가 작성되면, 로그 라이터는 null에 초기화됩니다. 즉, 디폴트에서는 로그의 취득은 무효입니다.

반환값:

이 데이터 소스의 로그 라이터. 로그의 취득이 무효의 경우는 null

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter  out)
                  throws SQLException 

이 DataSource 객체의 로그 라이터를 java.io.PrintWriter 객체로 설정합니다.

로그 라이터란 이 데이터 소스에 대해서 로그가 기록되거나 트레이스 된, 모든 메세지가 표시되는 캐릭터 출력 스트림입니다. 이 객체의 메서드에 한 메세지나, 이 객체가 작성한 것 외의 객체에 한 메세지등도 포함됩니다. 데이터 소스에 특유의 로그 Writer에 표시된 메세지는 java.sql.DriverManager 클래스에 관련된 로그 Writer에는 표시되지 않습니다. DataSource 객체가 작성되면, 로그 라이터는 null에 초기화됩니다. 즉, 디폴트에서는 로그의 취득은 무효입니다.

파라미터:

out - 새로운 로그 라이터. 로그의 취득을 무효로 하는 경우는 null 로 설정한다

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
                     throws SQLException 

데이타베이스에의 접속 시행중에 이 데이터 소스가 대기하는 최장 시간 (초)을 지정합니다. 값이 0 때, 디폴트의 시스템 타임 아웃이 설정되어 있는 경우는 그 값이 됩니다. 그렇지 않은 경우는 타임 아웃 하지 않는 것을의미합니다. DataSource 객체가 작성되면, 로그인 타임 아웃은 0에 초기화됩니다.

파라미터:

seconds - 데이터 소스의 로그인 제한 시간

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
                    throws SQLException 

데이타베이스에의 접속 시행중에 이 데이터 소스가 대기하는 최장 시간 (초)을 취득합니다. 값이 0 때, 디폴트의 시스템 타임 아웃이 설정되어 있는 경우는 그 값이 됩니다. 그렇지 않은 경우는 타임 아웃 하지 않는 것을의미합니다. DataSource 객체가 작성되면, 로그인 타임 아웃은 0에 초기화됩니다.

반환값:

데이터 소스의 로그인 제한 시간

예외:

SQLException - 데이타베이스 액세스 에러가 발생했을 경우

관련 항목:

setLoginTimeout(int)