22. Jdbc драйверлерін қолдану
В этом разделе приведены краткие указания по установлению простого соединения с базой данных SQL Server с использованием драйвера Драйвер Microsoft JDBC для SQL Server. Перед соединением с базой данных SQL Server необходимо установить SQL Server на локальном компьютере или на сервере, а также установить драйвер JDBC на локальном компьютере.
Выбор нужного JAR-файла
Драйвер Драйвер Microsoft JDBC для SQL Server включает файлы библиотек классов sqljdbc.jar и sqljdbc4.jar, которые используются в зависимости от выбранных параметров среды выполнения Java (JRE). Дополнительные сведения о том, какие файлы JAR следует выбрать, см. в разделе Системные требования для драйверов JDBC.
Начиная с версии Драйвер Microsoft JDBC для SQL Server, в драйвере JDBC поддержка API спецификации Java Database Connectivity была расширена и теперь включает API JDBC 4.0. JDBC 4.0 была реализована как часть Sun Java SE Development Kit (JDK) 6.0 и среды выполнения Java (JRE) 6.0. JDBC 4.0 является множеством JDBC 3.0.
Драйвер Драйвер Microsoft JDBC для SQL Server поддерживает JDBC 3.0 и JDBC 4.0.
При развертывании драйвера Драйвер Microsoft JDBC для SQL Server в операционных системах Windows и UNIX необходимо использовать пакеты установкиsqljdbc_<version>_enu.exe и sqljdbc_<version>_enu.tar.gz соответственно. Дополнительные сведения о развертывании драйвера JDBC см. в разделе Развертывание драйвера JDBC.
Драйвер JDBC во всех пакетах установки содержит две JAR-библиотеки классов, sqljdbc.jar и sqljdbc4.jar, что позволяет обеспечить поддержку обратной совместимости и возможных вариантов обновления.
JAR |
Описание |
sqljdbc.jar |
Библиотека классов sqljdbc.jar обеспечивает поддержку JDBC 3.0. Для класса sqljdbc.jar необходима среда выполнения Java (JRE) версии 5.0. Использование sqljdbc.jar в JRE 6.0 приведет к возникновению исключения при соединении с базой данных.
Драйвер JDBC не поддерживает JRE 1.4. При использовании драйвера JDBC необходимо обновить JRE 1.4 до версии 5.0 или 6.0. В некоторых случаях может потребоваться перекомпиляция приложения, если оно не совместимо с JDK 5.0 или более поздней версией. Дополнительные сведения см. в документации на веб-сайте Sun Microsystems. |
sqljdbc4.jar |
Библиотека классов sqljdbc4.jar обеспечивает поддержку JDBC 4.0. Она включает все функции sqljdbc.jar, а также новые методы JDBC 4.0. Для класса sqljdbc4.jar необходима среда выполнения Java (JRE) версии 6.0. Использование sqljdbc4.jar в JRE 1.4 или 5.0 приведет к возникновению исключения. Примечание Если необходимо использование приложения в JRE 6.0, следует использовать sqljdbc4.jar, даже если в приложении не используются функции JDBC 4.0. |
ПримечаниеОбратите внимание, что драйвер JDBC разработан и поддерживается при использовании со всеми основными аналогами виртуальных машин Java от Sun, но его проверка выполняется в Sun JRE 5.0 или более поздней версии.
Требования к SQL Server
Драйвер JDBC поддерживает подключения к SQL Server 2005 и более поздним версиям.
Требования к операционной системе
Драйвер JDBC предназначен для работы в любой операционной системе, поддерживающей использование виртуальной машины Java (JVM). Официально были протестированы только следующие операционные системы: Sun Solaris, SUSE Linux, Windows Vista и Windows 7.
Поддерживаемые языки
Драйвер JDBC поддерживает все параметры сортировки столбцов SQL Server. Дополнительные сведения о параметрах сортировки, поддерживаемых драйвером JDBC, см. в разделе Функции поддержки различных языков драйвера JDBC.
Дополнительные сведения о параметрах сортировки см. в разделе "Использование параметров сортировки" электронной документации SQL Server.
Задание пути к классу
Драйвер JDBC не входит в пакет Java SDK. Если нужно его использовать, необходимо включить в путь к классу файл sqljdbc.jar или sqljdbc4.jar. Если в пути к классу не указан файл sqljdbc.jar или sqljdbc4.jar, то приложение вызовет общее исключение «Класс не найден».
Файлы sqljdbc.jar и sqljdbc4.jar устанавливаются в следующую папку:
<installation directory>\sqljdbc_<version>\<language>\sqljdbc.jar
<installation directory>\sqljdbc_<version>\<language>\sqljdbc4.jar
Далее представлен пример инструкции CLASSPATH, используемой для приложения Windows.
CLASSPATH =.;C:\Program Files\Microsoft JDBC Driver 4.0 for SQL Server\sqljdbc_4.0\enu\sqljdbc.jar
Далее представлен пример инструкции CLASSPATH, используемой для приложения Unix/Linux.
CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_4.0/enu/sqljdbc.jar
Необходимо убедиться в том, что в инструкции CLASSPATH содержится только один драйвер Драйвер Microsoft JDBC для SQL Server, то есть либо sqljdbc.jar, либо sqljdbc4.jar.
Примечание |
В системах Windows имена каталогов длиной более 8 символов (+ 3 символа расширения) и имена папок, содержащие пробелы, могут вызывать проблемы с путями к классу. Если предполагаются проблемы такого типа, следует временно переместить файл sqljdbc.jar или sqljdbc4.jar в каталог с простым именем, напримерC:\Temp, изменить путь к классу и проверить, устранена ли проблема. |
Приложения, которые выполняются непосредственно в командной строке
Путь к классу настраивается в операционной системе. Добавьте в путь к классу в системе файл sqljdbc.jar или sqljdbc4.jar. Также можно указать путь к классу в командной строке Java, которая запускает приложения, воспользовавшись параметром java -classpath.
Приложения, выполняющиеся в интегрированной среде разработки
Каждый поставщик интегрированной среды разработки предоставляет собственный метод задания пути к классу в среде. Простой установки пути к классу в операционной системе недостаточно. Необходимо добавить файл sqljdbc.jar или sqljdbc4.jar к пути к классу в интегрированной среде разработки.
Сервлеты и JSP
Сервлеты и JSP выполняются в подсистеме сервлетов/JSP, например Tomcat. Путь к классу необходимо установить в соответствии с документацией по подсистеме сервлетов/JSP. Простой установки пути к классу в операционной системе недостаточно. Некоторые подсистемы сервлетов/JSP выводят окна установка, в которых можно задать путь к классу. В этом случае необходимо добавить к существующему пути к классу подсистемы нужный JAR-файл драйвера JDBC и перезапустить подсистему. В остальных случаях можно развернуть драйвер, скопировав файл sqljdbc.jar или sqljdbc4.jar в определенный каталог (например, lib) во время установки подсистемы. Путь к классу драйвера подсистемы также можно указать в файле конфигурации для подсистемы.
Enterprise Java Beans
Компоненты Enterprise Java Beans (EJB) выполняются в контейнере EJB. Контейнеры EJB предоставляются различными поставщиками. Java-приложения работают в браузере, но загружаются с веб-сервера. Скопируйте файл sqljdbc.jar или sqljdbc4.jar в корневой каталог веб-сервера и укажите имя JAR-файл на вкладке HTML-архива приложения, например <applet ... archive=sqljdbc.jar>.
Установление простого соединения с базой данных
В случае использования библиотеки классов sqljdbc.jar приложения сначала должны зарегистрировать драйвер следующим образом:
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
После загрузки драйвера можно установить соединение, используя URL-адрес соединения и метод getConnection класса DriverManager:
String connectionUrl = "jdbc:sqlserver://localhost:1433;" +
"databaseName=AdventureWorks;user=MyUserName;password=*****;";
Connection con = DriverManager.getConnection(connectionUrl);
В JDBC API 4.0 метод DriverManager.getConnection усовершенствован и автоматически загружает драйверы JDBC. Поэтому в случае использования библиотеки классов sqljdbc4.jar приложениям не обязательно вызывать метод Class.forName для регистрации или загрузки драйвера.
Когда вызывается метод getConnection класса DriverManager, из набора зарегистрированных драйверов JDBC выбирается подходящий драйвер. Файл sqljdbc4.jar содержит файл «META-INF/services/java.sql.Driver», который содержит зарегистрированный драйвер com.microsoft.sqlserver.jdbc.SQLServerDriver. Существующие приложения, которые загружают драйверы с помощью метода Class.forName, продолжат работать, не требуя изменений.