Использование драйвера JDBC

В этом разделе приводятся краткие указания по установлению простого соединения с базой данных SQL Server с использованием драйвера Microsoft SQL Server JDBC. Перед соединением с базой данных SQL Server необходимо установить SQL Server на локальном компьютере или на сервере, а также установить драйвер JDBC на локальном компьютере.

Выбор нужного JAR-файла

Драйвер Microsoft SQL Server JDBC предоставляет файлы библиотеки классов sqljdbc.jar и sqljdbc4.jar для использования в зависимости от выбранных параметров среды выполнения Java (JRE). Дополнительные сведения о том, какие файлы JAR следует выбрать, см. в разделе Системные требования для драйверов JDBC.

Задание пути к классу

Драйвер JDBC не входит в пакет Java SDK. Если нужно его использовать, необходимо включить в путь к классу файл sqljdbc.jar или sqljdbc4.jar. Если в пути к классу не указан файл sqljdbc.jar или sqljdbc4.jar, то приложение вызовет общее исключение «Класс не найден».

Файлы sqljdbc.jar и sqljdbc4.jar устанавливаются в следующую папку:

<каталог_установки>\sqljdbc_<версия>\<язык>\sqljdbc.jar

<каталог_установки>\sqljdbc_<версия>\<язык>\sqljdbc4.jar

Далее представлен пример инструкции CLASSPATH, используемой для приложения Windows.

CLASSPATH =.;C:\Program Files\Microsoft SQL Server JDBC Driver\sqljdbc_3.0\enu\sqljdbc.jar

Далее представлен пример инструкции CLASSPATH, используемой для приложения Unix/Linux.

CLASSPATH =.:/home/usr1/mssqlserverjdbc/Driver/sqljdbc_3.0/enu/sqljdbc.jar

Необходимо убедиться в том, что инструкция CLASSPATH содержит только один драйвер Microsoft SQL Server JDBC, то есть либо sqljdbc.jar, либо sqljdbc4.jar.

Приложения, которые выполняются непосредственно в командной строке

Путь к классу настраивается в операционной системе. Добавьте в путь к классу в системе файл 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, продолжат работать, не требуя изменений.

Дополнительные сведения о соединении с источниками данных и использовании URL-адреса соединения см. в разделах Формирование URL-адреса соединения и Задание свойств соединения.

См. также

Другие ресурсы

Общие сведения о драйвере JDBC