Пожалуйста, учтите, что спецификации и другая информация, содержащаяся здесь, не являются заключительными и могут быть изменены. Информация доступна для вас исключительно ради ознакомления.
Интерфейс, который должен реализовать каждый драйвер class.
Платформа SQL Java учитывает многократные драйверы базы данных.
Каждый драйвер должен предоставить class, который реализует интерфейс Драйвера.
DriverManager попытается загрузить так много драйверов, как он может найти и затем для любого данного запроса соединения, он попросит, чтобы каждый драйвер поочередно попытался соединиться с целевым URL.
Строго рекомендуется, чтобы каждый Драйвер class был маленьким и автономным так, чтобы Драйвер class мог быть загружен и запрошен, не вводя обширные количества поддержки кода.
Когда Драйвер, class загружается, он должен создать экземпляр себя и зарегистрировать это в DriverManager. Это означает, что пользователь может загрузить и зарегистрировать драйвер, вызывая:
Попытки сделать соединение с базой данных к данному URL. Драйвер должен возвратить "нуль", если это понимает, что это - неправильный вид драйвера, чтобы соединиться с данным URL. Это будет распространено, как тогда, когда менеджера по драйверу JDBC просят соединиться с данным URL, он передает URL к каждому загруженному драйверу поочередно.
Драйвер должен бросить SQLException если это - правильный драйвер, чтобы соединиться с данным URL, но испытывает затруднения, соединяясь с базой данных.
Properties параметр может использоваться, чтобы передать произвольных строковых пар тега/значения как параметры соединения. Обычно, по крайней мере, "пользователь" и свойства "пароля" должны быть включены в Properties объект.
Отметьте: Если свойство определяется как часть url и также определяется в Properties объект, это определяется с помощью реализации, относительно которого будет иметь приоритет значение. Для максимальной мобильности приложение должно только определить свойство однажды.
Параметры:
url - URL базы данных, с которой можно соединиться
info - список произвольной строки тегирует/оценивает пар как параметры соединения. Обычно, по крайней мере, свойство "пользователя" и "пароля" должно быть включено.
Возвраты:
a Connection объект, который представляет соединение с URL
Броски:
SQLException - если ошибка доступа к базе данных происходит, или url null
Получает, думает ли драйвер, что может открыть соединение с данным URL. Обычно драйверы возвратятся true если они понимают подпротокол, определенный в URL и false если они не делают.
Параметры:
url - URL базы данных
Возвраты:
true если этот драйвер понимает данный URL; false иначе
Броски:
SQLException - если ошибка доступа к базе данных происходит, или url null
Получает информацию о возможных свойствах для этого драйвера.
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 иначе
Возвратите родительский Регистратор всех Регистраторов, используемых этим драйвером. Это должно быть Регистратором, самым дальним от корневого Регистратора, который является все еще предком всех Регистраторов, используемых этим драйвером. Конфигурирование этого Регистратора будет влиять на все сообщения журнала, сгенерированные драйвером. В худшем случае это может быть корневым Регистратором.