Présentation de la prise en charge de Java EE
Les sections suivantes expliquent comment le pilote Microsoft JDBC pour SQL Server assure la prise en charge des fonctionnalités d'API facultatives pour Java EE (Java Platform, Enterprise Edition) et JDBC 3.0. Les exemples de code source fournis dans ce système d'aide constituent une bonne référence pour débuter avec ces fonctionnalités.
En premier lieu, assurez-vous que votre environnement Java (JDK, JRE) inclut le package javax.sql. Ce package est obligatoire pour toutes les applications JDBC qui utilisent l’API facultative. JDK 1.5 et les versions ultérieures contiennent déjà ce package ; il n’est donc pas nécessaire de l’installer séparément.
Nom du pilote
Le nom de la classe du pilote est com.microsoft.sqlserver.jdbc.SQLServerDriver.
Pour JDBC Driver 12.8, le pilote est contenu dans mssql-jdbc-12.8.0.jre8.jar ou mssql-jdbc-12.8.0.jre11.jar.
Pour JDBC Driver 12.6, le pilote est contenu dans mssql-jdbc-12.6.0.jre8.jar ou mssql-jdbc-12.6.0.jre11.jar.
Pour JDBC Driver 12.4, le pilote est contenu dans mssql-jdbc-12.4.0.jre8.jar ou mssql-jdbc-12.4.0.jre11.jar.
Pour JDBC Driver 12.2, le pilote est contenu dans mssql-jdbc-12.2.0.jre8.jar ou mssql-jdbc-12.2.0.jre11.jar.
Pour JDBC Driver 11.2, le pilote se trouve dans mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar ou mssql-jdbc-11.2.0.jre18.jar.
Pour JDBC Driver 10.2, le pilote se trouve dans mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar ou mssql-jdbc-10.2.0.jre17.jar.
Pour JDBC Driver 9.4, le pilote se trouve dans mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar ou mssql-jdbc-9.4.1.jre16.jar.
Pour JDBC Driver 9.2, le pilote se trouve dans mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar ou mssql-jdbc-9.2.1.jre15.jar.
Dans la version 8.4, le pilote JDBC est contenu dans mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar ou mssql-jdbc-8.4.1.jre14.jar.
Dans la version 8.2, le pilote JDBC est contenu dans mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar ou mssql-jdbc-8.2.2.jre13.jar.
Pour le pilote JDBC 7.4, le pilote est contenu dans mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar ou mssql-jdbc-7.4.1.jre12.jar.
Pour le pilote JDBC 7.2, le pilote est contenu dans mssql-jdbc-7.2.2.jre8.jar ou dans mssql-jdbc-7.2.2.jre11.jar.
Pour le pilote JDBC 7.0, le pilote est contenu dans mssql-jdbc-7.0.0.jre8.jar ou dans mssql-jdbc-7.0.0.jre10.jar.
Pour le pilote JDBC 6.4, le pilote est contenu dans mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar ou mssql-jdbc-6.4.0.jre9.jar.
Pour le pilote JDBC 6.2, le pilote est contenu dans mssql-jdbc-6.2.2.jre7.jar ou dans mssql-jdbc-6.2.2.jre8.jar.
Pour les pilotes JDBC Driver 4.1, 4.2 et 6.0, le pilote est contenu dans le fichier sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar ou sqljdbc42.jar.
Le nom de la classe est utilisé chaque fois que le pilote est chargé avec la classe DriverManager JDBC et chaque fois que le nom de la classe du pilote est spécifié dans n’importe quelle configuration de pilote. Par exemple, configurer une source de données dans un serveur d'applications Java EE peut imposer d’entrer le nom de la classe du pilote.
Sources de données
Le pilote JDBC assure la prise en charge des sources de données Java EE / JDBC 3.0. La classe SQLServerXADataSource du pilote JDBC est implémentée par com.microsoft.sqlserver.jdbc.SQLServerXADataSource.
Noms des sources de données
Vous pouvez établir des connexions de base de données à l'aide de sources de données. Les sources de données disponibles avec le pilote JDBC sont décrites dans le tableau suivant :
| Type DataSource | Nom de la classe et description |
|---|---|
| DataSource | com.microsoft.sqlserver.jdbc.SQLServerDataSource Source de données sans regroupement. |
| ConnectionPoolDataSource | com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource Source de données pour configurer des regroupements de connexions de serveur d'applications JAVA EE. Utilisée en général lorsque l'application s'exécute sur un serveur d'applications JAVA EE. |
| XADataSource | com.microsoft.sqlserver.jdbc.SQLServerXADataSource Source de données pour configurer des sources de données JAVA EE XA. Utilisée en général lorsque l'application s'exécute sur un serveur d'applications JAVA EE et un gestionnaire de transactions XA. |
Propriétés de la source de données
Toutes les sources de données prennent en charge la capacité à définir et à obtenir toute propriété associée à l'ensemble des propriétés du pilote sous-jacent.
Exemples :
setServerName("localhost");
setDatabaseName("AdventureWorks");
L'exemple suivant montre comment une application se connecte en utilisant une source de données :
//initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
Pour plus d'informations sur les propriétés de la source de données, consultez Définition des propriétés de la source de données.