java.sql

Интерфейсный Драйвер

public interface Driver

Интерфейс, который должен реализовать каждый класс драйвера.

Платформа SQL Java учитывает многократные драйверы базы данных.

Каждый драйвер должен предоставить класс, который реализует интерфейс Драйвера.

DriverManager попытается загрузить так много драйверов, как он может найти и затем для любого данного запроса соединения, он попросит, чтобы каждый драйвер поочередно попытался соединиться с целевым URL.

Строго рекомендуется, чтобы каждый класс Драйвера был маленьким и автономным так, чтобы класс Драйвера мог быть загружен и запрошен, не вводя обширные количества поддержки кода.

Когда класс Драйвера загружается, он должен создать экземпляр себя и зарегистрировать это в DriverManager. Это означает, что пользователь может загрузить и зарегистрировать драйвер, вызывая

   Class.forName("foo.bah.Driver")
 

См. Также:

DriverManager, Connection

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

Методы

Модификатор и Тип	Метод и Описание
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

Попытки сделать соединение с базой данных к данному URL. Драйвер должен возвратить "нуль", если это понимает, что это - неправильный вид драйвера, чтобы соединиться с данным URL. Это будет распространено, как тогда, когда менеджера по драйверу JDBC просят соединиться с данным URL, он передает URL к каждому загруженному драйверу поочередно.

Драйвер должен бросить SQLException если это - правильный драйвер, чтобы соединиться с данным URL, но испытывает затруднения, соединяясь с базой данных.

java.util.Properties параметр может использоваться, чтобы передать произвольных строковых пар тега/значения как параметры соединения. Обычно, по крайней мере, "пользователь" и свойства "пароля" должны быть включены в Properties объект.

Параметры:

url - URL базы данных, с которой можно соединиться

info - список произвольной строки тегирует/оценивает пар как параметры соединения. Обычно, по крайней мере, свойство "пользователя" и "пароля" должно быть включено.

Возвраты:

a Connection объект, который представляет соединение с URL

Броски:

SQLException - если ошибка доступа к базе данных происходит

acceptsURL

boolean acceptsURL(String url)
                   throws SQLException

Получает, думает ли драйвер, что может открыть соединение с данным URL. Обычно драйверы возвратятся true если они понимают подпротокол, определенный в URL и false если они не делают.

Параметры:

url - URL базы данных

Возвраты:

true если этот драйвер понимает данный URL; false иначе

Броски:

SQLException - если ошибка доступа к базе данных происходит

getPropertyInfo

DriverPropertyInfo[] getPropertyInfo(String url,
                                   Properties info)
                                     throws SQLException

Получает информацию о возможных свойствах для этого драйвера.

getPropertyInfo метод предназначается, чтобы позволить универсальному инструменту GUI обнаруживать, какие свойства он должен запросить человека то, чтобы получить достаточно информации, чтобы соединиться с базой данных. Отметьте, что в зависимости от значений человек до сих пор предоставлял, дополнительные значения могут стать необходимыми, таким образом, может быть необходимо выполнить итерации хотя несколько звонков getPropertyInfo метод.

Параметры:

url - URL базы данных, с которой можно соединиться

info - предложенный список пар тега/значения, которые будут отправлены на открытом подключении

Возвраты:

массив DriverPropertyInfo объекты, описывающие возможные свойства. Этот массив может быть пустым массивом, если никакие свойства не требуются.

Броски:

SQLException - если ошибка доступа к базе данных происходит

getMajorVersion

int getMajorVersion()

Получает номер основной версии драйвера. Первоначально это должно быть 1.

Возвраты:

номер основной версии этого драйвера

getMinorVersion

int getMinorVersion()

Получает номер вспомогательной версии драйвера. Первоначально это должно быть 0.

Возвраты:

номер вспомогательной версии этого драйвера

jdbcCompliant

boolean jdbcCompliant()

Отчеты, является ли этот драйвер подлинным драйвером ^CompliantTM JDBC. Драйвер может только сообщить true здесь, если это проходит тесты соответствия JDBC; иначе это обязано возвращаться false.

Соответствие JDBC требует полной поддержки API JDBC и полной поддержки SQL 92 Первых этажа. Ожидается, что совместимые драйверы JDBC будут доступны для всех главных коммерческих баз данных.

Этот метод не предназначается, чтобы поощрить разработку non-JDBC совместимых драйверов, но является распознаванием факта, что некоторые поставщики интересуются использованием API JDBC и платформы для легких баз данных, которые не поддерживают полную функциональность базы данных, или для специальных баз данных, таких как информационный поиск документа, где реализация SQL, возможно, не выполнима.

Возвраты:

true если этот драйвер JDBC Совместимый; false иначе

getParentLogger

Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Возвратите родительский Регистратор всех Регистраторов, используемых этим драйвером. Это должно быть Регистратором, самым дальним от корневого Регистратора, который является все еще предком всех Регистраторов, используемых этим драйвером. Конфигурирование этого Регистратора будет влиять на все сообщения журнала, сгенерированные драйвером. В худшем случае это может быть корневым Регистратором.

Возвраты:

родительский Регистратор для этого драйвера

Броски:

SQLFeatureNotSupportedException - если драйвер не использует java.util.logging.

Since:

1.7