Основные сведения о поддержке Java EE
В следующих разделах описывается, как драйвер JDBC для SQL Server обеспечивает поддержку платформы Java Enterprise Edition (Java EE) и дополнительные функции API JDBC 3.0. Образцы исходного кода, собранные в данном разделе справки, позволяют быстро освоить эти функции.
Сначала убедитесь, что среда JAVA (JDK, JRE) включает пакет javax.sql. Это обязательный пакет для любого приложения JDBC, которое использует дополнительный API. JDK 1.5 и более поздние версии уже содержат этот пакет, поэтому устанавливать его отдельно не требуется.
Имя драйвера
Имя класса драйвера ― com.microsoft.sqlserver.jdbc.SQLServerDriver.
Для JDBC Driver 12.8 драйвер содержится в mssql-jdbc-12.8.0.jre8.jar или mssql-jdbc-12.8.0.jre11.jar.
Для JDBC Driver 12.6 драйвер содержится в mssql-jdbc-12.6.0.jre8.jar или mssql-jdbc-12.6.0.jre11.jar.
Для JDBC Driver 12.4 драйвер содержится в mssql-jdbc-12.4.0.jre8.jar или mssql-jdbc-12.4.0.jre11.jar.
Для JDBC Driver 12.2 драйвер содержится в mssql-jdbc-12.2.0.jre8.jar или mssql-jdbc-12.2.0.jre11.jar.
Для драйвера JDBC 11.2 драйвер содержится в файле mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar или mssql-jdbc-11.2.0.jre18.jar.
Для драйвера JDBC 10.2 драйвер содержится в файле mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar или mssql-jdbc-10.2.0.jre17.jar.
Для драйвера JDBC 9.4 драйвер содержится в файле mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar или mssql-jdbc-9.4.1.jre16.jar.
Для драйвера JDBC 9.2 драйвер содержится в файле mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar или mssql-jdbc-9.2.1.jre15.jar.
Для драйвера JDBC 8.4 драйвер содержится в файле mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar или mssql-jdbc-8.4.1.jre14.jar.
Для драйвера JDBC 8.2 драйвер содержится в файле mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar или mssql-jdbc-8.2.2.jre13.jar.
Для драйвера JDBC 7.4 драйвер содержится в файле mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar или mssql-jdbc-7.4.1.jre12.jar.
Для драйвера JDBC 7.2 драйвер содержится в файле mssql-jdbc-7.2.2.jre8.jar или mssql-jdbc-7.2.2.jre11.jar.
Для драйвера JDBC 7.0 драйвер содержится в файле mssql-jdbc-7.0.0.jre8.jar или mssql-jdbc-7.0.0.jre10.jar.
Для драйвера JDBC 6.4 драйвер содержится в файле mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar или mssql-jdbc-6.4.0.jre9.jar.
Для драйвера JDBC 6.2 драйвер содержится в файле mssql-jdbc-6.2.2.jre7.jar или mssql-jdbc-6.2.2.jre8.jar.
Для драйверов JDBC 4.1, 4.2 и 6.0 драйвер содержится в файле sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar или sqljdbc42.jar.
Имя класса используется каждый раз, когда вы загружаете драйвер с использованием класса JDBC DriverManager и указываете имя класса драйвера в любой конфигурации драйвера. Например, имя класса драйвера может потребоваться для настройки источника данных на сервере приложений Java EE.
Источники данных
Драйвер JDBC обеспечивает поддержку для источников данных Java EE/JDBC 3.0. Класс SQLServerXADataSource драйвера JDBC реализуется com.microsoft.sqlserver.jdbc.SQLServerXADataSource.
Имена источников данных
Подключения к базам данных можно создать, используя источники данных. Источники данных, доступные с драйвером JDBC, описываются в следующей таблице.
| Тип источника данных | Имя класса и описание |
|---|---|
| DataSource | com.microsoft.sqlserver.jdbc.SQLServerDataSource Источник данных без организации пулов. |
| ConnectionPoolDataSource | com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource Источник данных для настройки пулов соединений сервера приложений JAVA EE. Обычно используется, когда приложение работает на сервере приложений JAVA EE. |
| XADataSource | com.microsoft.sqlserver.jdbc.SQLServerXADataSource Источник данных для настройки источников данных JAVA EE XA. Обычно используется, когда приложение работает на сервере приложений JAVA EE и диспетчере транзакций XA. |
Свойства источника данных
Все источники данных поддерживают возможность задания и получения любого свойства, связанного с базовым набором свойств драйвера.
Примеры:
setServerName("localhost");
setDatabaseName("AdventureWorks");
Далее показано, как приложение подключается, используя источник данных.
//initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
См. о настройке свойств источника данных.