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 오브젝트가 look 업 조작에 의해 취득되어,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

public Connection  getConnection()
                         throws SQLException 

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

반환값:

데이터 소스에의 접속

예외:

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

getConnection

public Connection  getConnection(String  username,
                                String  password)
                         throws SQLException 

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

파라미터:

username - 그 대리로서 접속을 하는 데이타베이스 유저

password - 유저의 패스워드

반환값:

데이터 소스에의 접속

예외:

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

getLogWriter

public PrintWriter  getLogWriter()
                         throws SQLException 

이 DataSource 오브젝트의 로그 라이터를 취득합니다.

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

반환값:

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

예외:

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

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

public void setLogWriter(PrintWriter  out)
                  throws SQLException 

이 DataSource 오브젝트의 로그 라이터를 java.io.PrintWriter 오브젝트로 설정합니다.

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

파라미터:

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

예외:

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

관련 항목:

getLogWriter()

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws SQLException 

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

파라미터:

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

예외:

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

관련 항목:

getLoginTimeout()

getLoginTimeout

public int getLoginTimeout()
                    throws SQLException 

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

반환값:

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

예외:

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

관련 항목:

setLoginTimeout(int)