Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface Driver
Платформа SQL Java учитывает многократные драйверы базы данных.
Каждый драйвер должен предоставить class, который реализует интерфейс Драйвера.
DriverManager попытается загрузить так много драйверов, как он может найти и затем для любого данного запроса соединения, он попросит, чтобы каждый драйвер поочередно попытался соединиться с целевым URL.
Строго рекомендуется, чтобы каждый Драйвер class был маленьким и автономным так, чтобы Драйвер class мог быть загружен и запрошен, не вводя обширные количества поддержки кода.
Когда Драйвер, class загружается, он должен создать экземпляр себя и зарегистрировать это в DriverManager. Это означает, что пользователь может загрузить и зарегистрировать драйвер, вызывая:
Class.forName("foo.bah.Driver")
Драйвер JDBC может создать реализацию DriverAction, чтобы получить уведомления когда DriverManager.deregisterDriver (java.sql. Драйвер), был вызван.
DriverManager
, Connection
, DriverAction
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
acceptsURL(String url)
Получает, думает ли драйвер, что может открыть соединение с данным URL.
|
Соединение |
connect(String url, Properties info)
Попытки сделать соединение с базой данных к данному URL.
|
int |
getMajorVersion()
Получает номер основной версии драйвера.
|
int |
getMinorVersion()
Получает номер вспомогательной версии драйвера.
|
Регистратор |
getParentLogger()
Возвратите родительский Регистратор всех Регистраторов, используемых этим драйвером.
|
DriverPropertyInfo[] |
getPropertyInfo(String url, Properties info)
Получает информацию о возможных свойствах для этого драйвера.
|
boolean |
jdbcCompliant()
Отчеты, является ли этот драйвер подлинным драйвером CompliantTM JDBC.
|
Connection connect(String url, Properties info) throws SQLException
Драйвер должен бросить SQLException
если это - правильный драйвер, чтобы соединиться с данным URL, но испытывает затруднения, соединяясь с базой данных.
Properties
параметр может использоваться, чтобы передать произвольных строковых пар тега/значения как параметры соединения. Обычно, по крайней мере, "пользователь" и свойства "пароля" должны быть включены в Properties
объект.
Отметьте: Если свойство определяется как часть url
и также определяется в Properties
объект, это определяется с помощью реализации, относительно которого будет иметь приоритет значение. Для максимальной мобильности приложение должно только определить свойство однажды.
url
- URL базы данных, с которой можно соединитьсяinfo
- список произвольной строки тегирует/оценивает пар как параметры соединения. Обычно, по крайней мере, свойство "пользователя" и "пароля" должно быть включено.Connection
объект, который представляет соединение с URLSQLException
- если ошибка доступа к базе данных происходит, или url null
boolean acceptsURL(String url) throws SQLException
true
если они понимают подпротокол, определенный в URL и false
если они не делают.url
- URL базы данныхtrue
если этот драйвер понимает данный URL; false
иначеSQLException
- если ошибка доступа к базе данных происходит, или url null
DriverPropertyInfo[] getPropertyInfo(String url, Properties info) throws SQLException
getPropertyInfo
метод предназначается, чтобы позволить универсальному инструменту GUI обнаруживать, какие свойства он должен запросить человека то, чтобы получить достаточно информации, чтобы соединиться с базой данных. Отметьте, что в зависимости от значений человек до сих пор предоставлял, дополнительные значения могут стать необходимыми, таким образом, может быть необходимо выполнить итерации хотя несколько звонков getPropertyInfo
метод.
url
- URL базы данных, с которой можно соединитьсяinfo
- предложенный список пар тега/значения, которые будут пересланы, соединяется открытыйDriverPropertyInfo
объекты, описывающие возможные свойства. Этот массив может быть пустым массивом, если никакие свойства не требуются.SQLException
- если ошибка доступа к базе данных происходитint getMajorVersion()
int getMinorVersion()
boolean jdbcCompliant()
true
здесь, если это проходит тесты соответствия JDBC; иначе это обязано возвращаться false
. Соответствие JDBC требует полной поддержки API JDBC и полной поддержки SQL 92 Первых этажа. Ожидается, что совместимые драйверы JDBC будут доступны для всех главных коммерческих баз данных.
Этот метод не предназначается, чтобы поощрить разработку non-JDBC совместимых драйверов, но является распознаванием факта, что некоторые поставщики интересуются использованием API JDBC и платформы для легких баз данных, которые не поддерживают полную функциональность базы данных, или для специальных баз данных, таких как информационный поиск документа, где реализация SQL, возможно, не выполнима.
true
если этот драйвер JDBC Совместимый; false
иначеLogger getParentLogger() throws SQLFeatureNotSupportedException
SQLFeatureNotSupportedException
- если драйвер не использует java.util.logging.
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b92