|
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 nullboolean acceptsURL(String url) throws SQLException
true если они понимают подпротокол, определенный в URL и false если они не делают.url - URL базы данныхtrue если этот драйвер понимает данный URL; false иначеSQLException - если ошибка доступа к базе данных происходит, или url nullDriverPropertyInfo[] 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