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

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

```
public class DriverManager
extends Object
```
Основная услуга для того, чтобы управлять рядом драйверов JDBC.
ОТМЕТЬТЕ: DataSource интерфейс, новый в JDBC 2.0 API, обеспечивает другой способ соединиться с источником данных. Использование a DataSource объект является привилегированными средствами соединения с источником данных.
Как часть его инициализации, DriverManager class попытается загрузить классы драйвера, на которые ссылаются в "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 class, 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()` Осуждаемый. Использовать `getLogWriter`
`static PrintWriter`	`getLogWriter()` Получает писателя журнала.
`static void`	`println(String message)` Печатает сообщение к текущему потоку журнала JDBC.
`static void`	`registerDriver(Driver driver)` Регистрирует данный драйвер в `DriverManager`.
`static void`	`registerDriver(Driver driver, DriverAction da)` Регистрирует данный драйвер в `DriverManager`.
`static void`	`setLoginTimeout(int seconds)` Устанавливает максимальное время в секундах, которые драйвер будет ожидать, пытаясь соединить с базой данных, как только драйвер был идентифицирован.
`static void`	`setLogStream(PrintStream out)` Осуждаемый. Использовать `setLogWriter`
`static void`	`setLogWriter(PrintWriter out)` Устанавливает журналирование/трассировку `PrintWriter` объект, который используется `DriverManager` и все драйверы.

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

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

Класс DriverManager

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

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

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

getLogWriter

setLogWriter

getConnection

getConnection

getConnection

getDriver

registerDriver

registerDriver

deregisterDriver

getDrivers

setLoginTimeout

getLoginTimeout

setLogStream

getLogStream

println