java.sql
클래스 DriverManager

java.lang.Object 
  |
  +--java.sql.DriverManager

public class DriverManager

extends Object

JDBC 드라이버를 관리하기 위한 기본적인 서비스입니다.
주: JDBC 2.0 API 로 새롭게 추가된 DataSource 인터페이스는 데이터 소스에 접속하는 이제(벌써) 1 개의 방법을 제공하고 있습니다. DataSource 오브젝트를 사용해 데이터 소스에 접속하는 것을 추천합니다.

DriverManager 클래스는 초기화시에 "jdbc.drivers" 시스템 프로퍼티로 참조되는 드라이버 클래스를 로드하려고 합니다. 이것에 의해, 유저는 어플리케이션으로 사용하는 JDBC Driver 를 커스터마이즈 할 수 있습니다. 예를 들어,~/. hotjava/properties 파일로 다음의 항목을 지정합니다.

 jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.taste.ourDriver
 

프로그램은 언제라도 JDBC 드라이버를 로드할 수가 있습니다. 예를 들어, 다음의 문장으로 my.sql.Driver 가 로드 됩니다.

 Class.forName("my.sql.Driver");
 

getConnection 메소드가 불려 가면(자),DriverManager 는 초기화시에 로드 된 드라이버나, 현애플릿 혹은 어플리케이션과 같은 클래스 로더를 사용해 명시적으로 로드 된 드라이버중에서 적절한 드라이버를 찾으려고 합니다.

Java 2 SDK, Standard Edition, 버젼 1.3 이후는 로그 스트림은 적절한 액세스권이 허가되고 있는 경우에 한정해 설정할 수 있습니다. 통상 이것은 툴 PolicyTool 를 사용해 행해집니다. 이 툴은 permission java.sql.SQLPermission "setLog" 를 허가하는데 사용할 수 있습니다.

관련 항목:

Driver , Connection

메소드의 개요

static void	deregisterDriver (Driver driver) DriverManager 의 리스트로부터 드라이버를 제외합니다.
static Connection	getConnection (String url) 지정된 데이타베이스의 URL 에의 접속을 시도합니다.
static Connection	getConnection (String url, Properties info) 지정된 데이타베이스의 URL 에의 접속을 시도합니다.
static Connection	getConnection (String url, String user, String password) 지정된 데이타베이스의 URL 에의 접속을 시도합니다.
static Driver	getDriver (String url) 지정된 URL 를 인식하는 드라이버를 획득하려고 합니다.
static Enumeration	getDrivers () 현재의 호출원이 액세스 하고 있는 로드 사라질 수 있어 모든 JDBC 드라이버의 Enumeration 를 취득합니다.
static int	getLoginTimeout () 데이타베이스에 로그인하고 있을 때, 드라이버가 기다릴 수 있는 최장의 시간을 초수로 취득합니다.
static PrintStream	getLogStream () 추천 되고 있지 않습니다.
static PrintWriter	getLogWriter () 로그 라이터를 취득합니다.
static void	println (String message) 현재의 JDBC 로그 스트림에 메세지를 인쇄합니다.
static void	registerDriver (Driver driver) 지정된 드라이버를 DriverManager 에 등록합니다.
static void	setLoginTimeout (int seconds) 데이타베이스에 접속하려고 하고 있을 때, 드라이버가 기다릴 수 있는 최장의 시간을 초수로 설정합니다.
static void	setLogStream (PrintStream out) 추천 되고 있지 않습니다.
static void	setLogWriter (PrintWriter out) DriverManager 및 모든 드라이버가 사용하는 로그 및 트레이스의 PrintWriter 오브젝트를 설정합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

메소드의 상세

getLogWriter

public static PrintWriter  getLogWriter()

로그 라이터를 취득합니다. getLogWriter 메소드 및 setLogWriter 메소드는 추천 되지 않는 get/setlogStream 메소드 대신에 사용합니다.

반환값:

java.io.PrintWriter 오브젝트

도입된 버젼:

1.2

관련 항목:

setLogWriter(java.io.PrintWriter)

setLogWriter

public static void setLogWriter(PrintWriter  out)

DriverManager 및 모든 드라이버가 사용하는 로그 및 트레이스의 PrintWriter 오브젝트를 설정합니다.

setLogWriter 메소드의 도입에 의해, 마이너 버젼의 관리의 문제가 발생합니다. SetLogWriter 메소드는 getLogStream 에 의해 돌려주어지는 PrintStream 오브젝트를 생성할 수 없습니다. Java 플랫폼에는 역방향의 변환은 없습니다. 그 때문에, 새로운 어플리케이션으로,setLogWriter 를 사용해,getLogStream 를 사용하고 있는 JDBC 1.0 드라이버도 사용하고 있는 것은 그 드라이버에 의해 기술된 디버그 정보를 볼 수가 없습니다.

Java 2 SDK, Standard Edition, 버젼 1.3 릴리스에서는 로그 스트림을 설정하기 전에,SQLPermission 오브젝트가 있을지 어떨지를 이 메소드가 체크합니다. SecurityManager 가 존재해, 그 checkPermission 메소드가 로그 라이터의 설정을 허가하지 않는 경우, 이 메소드는 java.lang.SecurityException 를 슬로우 합니다.

파라미터:

out - 새로운 로그 및 트레이스의 PrintStream 오브젝트. 로그 및 트레이스를 무효로 하는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 그 checkPermission 메소드가 로그 라이터의 설정을 거부했을 경우

도입된 버젼:

1.2

관련 항목:

SecurityManager.checkPermission(java.security.Permission) , getLogWriter()

getConnection

public static Connection  getConnection(String  url,
                                       Properties  info)
                                throws SQLException 

지정된 데이타베이스의 URL 에의 접속을 시도합니다. DriverManager 는 등록된 JDBC 드라이버의 집합으로부터 적절한 드라이버를 선택하려고 합니다.

파라미터:

url - jdbc:subprotocol:subname 형식의 데이타베이스 URL

info - 접속 인수로서의, 임의의 캐릭터 라인 태그 및 값의 페어의 리스트. 통상은 적어도 "user" 프로퍼티와 "password" 프로퍼티는 지정해야 한다

반환값:

URL 에의 Connection

예외:

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

getConnection

public static Connection  getConnection(String  url,
                                       String  user,
                                       String  password)
                                throws SQLException 

지정된 데이타베이스의 URL 에의 접속을 시도합니다. DriverManager 는 등록된 JDBC 드라이버의 집합으로부터 적절한 드라이버를 선택하려고 합니다.

파라미터:

url - jdbc:subprotocol:subname 형식의 데이타베이스 URL

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

password - 유저의 패스워드

반환값:

URL 에의 접속

예외:

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

getConnection

public static Connection  getConnection(String  url)
                                throws SQLException 

지정된 데이타베이스의 URL 에의 접속을 시도합니다. DriverManager 는 등록된 JDBC 드라이버의 집합으로부터 적절한 드라이버를 선택하려고 합니다.

파라미터:

url - jdbc:subprotocol:subname 형식의 데이타베이스 URL

반환값:

URL 에의 접속

예외:

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

getDriver

public static Driver  getDriver(String  url)
                        throws SQLException 

지정된 URL 를 인식하는 드라이버를 획득하려고 합니다. DriverManager 는 등록된 JDBC 드라이버의 집합으로부터 적절한 드라이버를 선택하려고 합니다.

파라미터:

url - jdbc:subprotocol:subname 형식의 데이타베이스 URL

반환값:

지정된 URL 에 접속할 수 있는 드라이버를 나타내는 Driver 오브젝트

예외:

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

registerDriver

public static void registerDriver(Driver  driver)
                           throws SQLException 

지정된 드라이버를 DriverManager 에 등록합니다. 새롭고 로드 되는 드라이버 클래스는 registerDriver 메소드를 호출해, 그것을 DriverManager 에 통지하지 않으면 안됩니다.

파라미터:

driver - DriverManager 에 등록되는 새로운 JDBC Driver

예외:

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

deregisterDriver

public static void deregisterDriver(Driver  driver)
                             throws SQLException 

DriverManager 의 리스트로부터 드라이버를 제외합니다. 애플릿은 자신의 클래스 로더로부터 드라이버를 제외한 것만이 가능합니다.

파라미터:

driver - 제외하는 JDBC Driver

예외:

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

getDrivers

public static Enumeration  getDrivers()

현재의 호출원이 액세스 하고 있는 로드 사라질 수 있어 모든 JDBC 드라이버의 Enumeration 를 취득합니다.

주: 드라이버의 클래스명은 d.getClass(). getName() 를 사용해 찾아낼 수가 있습니다.

반환값:

호출원의 클래스 로더에 의해 로드 되는 JDBC Driver 의 리스트

setLoginTimeout

public static void setLoginTimeout(int seconds)

데이타베이스에 접속하려고 하고 있을 때, 드라이버가 기다릴 수 있는 최장의 시간을 초수로 설정합니다.

파라미터:

seconds - 로그인의 시한 (초단위)

관련 항목:

getLoginTimeout()

getLoginTimeout

public static int getLoginTimeout()

데이타베이스에 로그인하고 있을 때, 드라이버가 기다릴 수 있는 최장의 시간을 초수로 취득합니다.

반환값:

드라이버의 로그인의 시한 (초단위)

관련 항목:

setLoginTimeout(int)

setLogStream

public static void setLogStream(PrintStream  out)

추천 되고 있지 않습니다.

DriverManager 및 모든 드라이버가 사용하는 로그 및 트레이스의 PrintStream 를 설정합니다.

Java 2 SDK, Standard Edition, 버젼 1.3 릴리스에서는 로그 스트림을 설정하기 전에,SQLPermission 오브젝트가 있을지 어떨지를 이 메소드가 체크합니다. SecurityManager 가 존재해, 그 checkPermission 메소드가 로그 라이터의 설정을 허가하지 않는 경우, 이 메소드는 java.lang.SecurityException 를 슬로우 합니다.

파라미터:

out - 로그 및 트레이스의 새로운 PrintStream. 무효로 하는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 그 checkPermission 메소드가 로그 스트림의 설정을 거부했을 경우

관련 항목:

SecurityManager.checkPermission(java.security.Permission) , getLogStream()

getLogStream

public static PrintStream  getLogStream()

추천 되고 있지 않습니다.

DriverManager 및 모든 드라이버가 사용하는 로그 및 트레이스의 PrintStream 을 취득합니다.

반환값:

로그 및 트레이스의 PrintStream. 무효인 경우는 null

관련 항목:

setLogStream(java.io.PrintStream)

println

public static void println(String  message)

현재의 JDBC 로그 스트림에 메세지를 인쇄합니다.

파라미터:

message - 로그 메세지 또는 트레이스 메세지