Présentation de la prise en charge de Java EE

Article
01/31/2024

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.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.

Voir aussi

Présentation du pilote JDBC