DriverManager (Платформа Java SE 7)

java.lang. Объект
- java.sql. DriverManager

```
public class DriverManager
extends Object
```
Основная услуга для того, чтобы управлять рядом драйверов JDBC.
ОТМЕТЬТЕ: DataSource интерфейс, новый в JDBC 2.0 API, обеспечивает другой способ соединиться с источником данных. Использование a DataSource объект является привилегированными средствами соединения с источником данных.
Как часть его инициализации, DriverManager класс попытается загрузить классы драйвера, на которые ссылаются в "jdbc.drivers" системном свойстве. Это позволяет пользователю настраивать Драйверы JDBC, используемые их приложениями. Например в Вашем ~/.hotjava/properties файл Вы могли бы определить:
```
 jdbc.drivers=foo.bah.Driver:wombat.sql.Driver:bad.taste.ourDriver
 
```
DriverManager методы getConnection и getDrivers были улучшены, чтобы поддерживать Java Standard Edition механизм Поставщика услуг. JDBC 4.0 Драйвера должен включать файл META-INF/services/java.sql.Driver. Этот файл содержит имя реализации драйверов JDBC java.sql.Driver. Например, чтобы загрузиться my.sql.Driver класс, META-INF/services/java.sql.Driver файл содержал бы запись:
```
 my.sql.Driver
 
```
Приложения больше не должны к explictly загрузить использование драйверов JDBC Class.forName(). Существующие программы, которые в настоящий момент загружают использование драйверов JDBC Class.forName() будет продолжать работать без модификации.
Когда метод getConnection вызывается, DriverManager попытается определить местоположение подходящего драйвера от среди загруженных в инициализации и загруженных явно использование того же самого classloader как текущий апплет или приложение.
Запускаясь с Java, 2 SDK, Standard Edition, версия 1.3, поток журналирования могут быть установлены, только если надлежащее разрешение предоставили. Обычно это будет сделано с инструментом PolicyTool, который может использоваться, чтобы предоставить permission java.sql.SQLPermission "setLog".
См. Также:
Driver, Connection

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`static void`	`deregisterDriver(Driver driver)` Отбрасывает драйвер от `DriverManager`'s список.
`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<Driver>`	`getDrivers()` Получает Перечисление со всеми в настоящий момент загруженными драйверами JDBC, к которым у текущей вызывающей стороны есть доступ.
`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)` Устанавливает журналирование/трассировку `PrintWriter` объект, который используется `DriverManager` и все драйверы.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь метода
  - getLogWriter
```
public static PrintWriter getLogWriter()
```
    Получает писателя журнала. getLogWriter и setLogWriter методы должны использоваться вместо get/setlogStream методы, которые осуждаются.
    
    Возвраты:
    a java.io.PrintWriter объект
    С тех пор:
    
    1.2
    
    См. Также:
    setLogWriter(java.io.PrintWriter)
  - setLogWriter
```
public static void setLogWriter(PrintWriter out)
```
    Устанавливает журналирование/трассировку PrintWriter объект, который используется DriverManager и все драйверы.
    Есть незначительная проблема управления версиями, создаваемая введением метода setLogWriter. Метод setLogWriter не может создать a PrintStream объект, который будет возвращен getLogStream---платформа Java не обеспечивает обратное преобразование. В результате новое приложение, которое использует setLogWriter и также использует JDBC 1.0 драйвера, которые используют getLogStream не будет, вероятно, видеть отладочной информации, записанной тем драйвером.
    Запускаясь с Java 2 SDK, Standard Edition, выпуск версии 1.3, этот метод проверки, чтобы видеть, что есть SQLPermission объект прежде, чем установить поток журналирования. Если a SecurityManager существует и checkPermission метод отрицает устанавливать писателя журнала, этот метод бросает a 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 - url базы данных формы jdbc:subprotocol:subname
    info - список произвольной строки тегирует/оценивает пар как параметры соединения; обычно, по крайней мере, свойство "пользователя" и "пароля" должно быть включено
    
    Возвраты:
    Соединение с URL
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - getConnection
```
public static Connection getConnection(String url,
                       String user,
                       String password)
                                throws SQLException
```
    Попытки установить соединение с данной базой данных URL. DriverManager попытки выбрать соответствующий драйвер из набора зарегистрированных драйверов JDBC.
    
    Параметры:
    url - url базы данных формы jdbc:subprotocol:subname
    user - пользователь базы данных, на имени которого делается соединение
    password - пароль пользователя
    
    Возвраты:
    соединение с URL
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - getConnection
```
public static Connection getConnection(String url)
                                throws SQLException
```
    Попытки установить соединение с данной базой данных URL. DriverManager попытки выбрать соответствующий драйвер из набора зарегистрированных драйверов JDBC.
    
    Параметры:
    url - url базы данных формы jdbc:subprotocol:subname
    
    Возвраты:
    соединение с URL
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - getDriver
```
public static Driver getDriver(String url)
                        throws SQLException
```
    Попытки определить местоположение драйвера, который понимает данный URL. DriverManager попытки выбрать соответствующий драйвер из набора зарегистрированных драйверов JDBC.
    
    Параметры:
    url - база данных URL формы jdbc:subprotocol:subname
    
    Возвраты:
    a Driver объект, представляющий драйвер, который может соединиться с данным URL
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - registerDriver
```
public static void registerDriver(Driver driver)
                           throws SQLException
```
    Регистрирует данный драйвер в DriverManager. Недавно загруженный класс драйвера должен вызвать метод registerDriver сделать себя известным DriverManager.
    
    Параметры:
    driver - новый Драйвер JDBC, который должен быть зарегистрирован в DriverManager
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - deregisterDriver
```
public static void deregisterDriver(Driver driver)
                             throws SQLException
```
    Отбрасывает драйвер от DriverManager's список. Апплеты могут только вычеркнуть из списка драйверы от своего собственного classloaders.
    
    Параметры:
    driver - Драйвер JDBC, чтобы отбросить
    
    Броски:
    
    SQLException - если ошибка доступа к базе данных происходит
  - getDrivers
```
public static Enumeration<Driver> getDrivers()
```
    Получает Перечисление со всеми в настоящий момент загруженными драйверами JDBC, к которым у текущей вызывающей стороны есть доступ.
    Отметьте: имя класса драйвера может быть найдено, используя d.getClass().getName()
    
    Возвраты:
    список Драйверов JDBC загружался загрузчиком класса вызывающей стороны
  - setLoginTimeout
```
public static void setLoginTimeout(int seconds)
```
    Устанавливает максимальное время в секундах, которые драйвер будет ожидать, пытаясь соединить с базой данных.
    
    Параметры:
    seconds - ограничение по времени входа в систему в секундах; обнулите означает, что нет никакого предела
    См. Также:
    getLoginTimeout()
  - getLoginTimeout
```
public static int getLoginTimeout()
```
    Получает максимальное время в секундах, что драйвер может ожидать, пытаясь войти в систему к базе данных.
    
    Возвраты:
    ограничение по времени входа в систему драйвера в секундах
    См. Также:
    setLoginTimeout(int)
  - setLogStream
```
public static void setLogStream(PrintStream out)
```
    Осуждаемый.
    
    Устанавливает журналирование/трассировку PrintStream, который используется DriverManager и все драйверы.
    В Java 2 SDK, Standard Edition, выпуск версии 1.3, этот метод проверки, чтобы видеть, что есть SQLPermission объект прежде, чем установить поток журналирования. Если a SecurityManager существует и checkPermission метод отрицает устанавливать писателя журнала, этот метод бросает a java.lang.SecurityException.
    
    Параметры:
    out - новое журналирование/трассировка PrintStream; чтобы отключить, установите в null
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkPermission метод отрицает устанавливать поток журнала
    См. Также:
    SecurityManager.checkPermission(java.security.Permission), getLogStream()
  - getLogStream
```
public static PrintStream getLogStream()
```
    Осуждаемый.
    
    Получает журналирование/трассировку PrintStream, который используется DriverManager и все драйверы.
    
    Возвраты:
    журналирование/трассировка PrintStream; если отключено, null
    См. Также:
    setLogStream(java.io.PrintStream)
  - println
```
public static void println(String message)
```
    Печатает сообщение к текущему потоку журнала JDBC.
    
    Параметры:
    message - журнал или прослеживающий сообщение

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс DriverManager

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь метода

getLogWriter

setLogWriter

getConnection

getConnection

getConnection

getDriver

registerDriver

deregisterDriver

getDrivers

setLoginTimeout

getLoginTimeout

setLogStream

getLogStream

println