Fonctionnement de la prise en charge Java EE
Les sections suivantes expliquent comment le pilote JDBC Microsoft SQL Server assure la prise en charge des fonctionnalités d'API facultatives pour Java EE 5 (Java Platform, Enterprise Edition 5) 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. Il s'agit d'un package requis pour toute application JDBC qui utilise l'API facultative. JDK 1.5 et versions ultérieures contiennent déjà ce package ; il est donc inutile de l'installer séparément.
Nom de pilote
Le nom de classe du pilote est com.microsoft.sqlserver.jdbc.SQLServerDriver. Le pilote est contenu dans le fichier sqljdbc.jar ou sqljdb4.jar.
Le nom de classe est utilisé chaque fois que vous chargez le pilote avec la classe DriverManager JDBC. Il est également utilisé lorsque vous devez spécifier le nom de classe du pilote dans une configuration de pilote. Par exemple, la configuration d'une source de données dans un serveur d'applications Java EE 5 peut exiger que vous entriez le nom de classe du pilote.
Sources de données
Le pilote JDBC fournit la prise en charge des sources de données Java EE 5 / JDBC 3.0. La classe SQLServerXADataSource du pilote JDBC est implémentée par com.microsoft.sqlserver.jdbc.SQLServerXADataSource.
Noms de 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 | 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 5. Utilisé en général lorsque l'application s'exécute sur un serveur d'applications JAVA EE 5. |
XADataSource |
com.microsoft.sqlserver.jdbc.SQLServerXADataSource |
Source de données pour configurer des sources de données JAVA EE 5 XA. Utilisé en général lorsque l'application s'exécute sur un serveur d'applications JAVA EE 5 et un gestionnaire de transactions XA. |
Propriétés de 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 source de données, consultez Définition des propriétés de la source de données.