Utilisation d'un regroupement de connexions
Le Pilote Microsoft JDBC pour SQL Server prend en charge le regroupement de connexions Java EE (Java Platform, Enterprise Edition). Le pilote JDBC implémente les interfaces JDBC 3.0 requises pour permettre au pilote de participer aux implémentations de regroupements de connexions fournies par des fournisseurs d'intergiciels (middleware) et compatibles JDBC 3.0. Des intergiciels (middleware) tels que des serveurs d'applications Java EE offrent souvent des fonctionnalités de regroupement de connexions compatibles. Le pilote JDBC prendra part à des connexions regroupées dans ces environnements.
Notes
Même si le pilote JDBC prend en charge le regroupement de connexions Java EE, il ne fournit pas sa propre implémentation de regroupement. Le pilote recourt à des serveurs d'applications Java tiers pour gérer les connexions.
Notes
Les classes pour l'implémentation du regroupement de connexions sont les suivantes.
| Classe | Implémentations | Description |
|---|---|---|
| com.microsoft.sqlserver.jdbc. SQLServerXADataSource | javax.sql.ConnectionPoolDataSource et javax.sql.XADataSource | Nous vous recommandons d’utiliser la classe SQLServerXADataSource pour tous les besoins de serveur Java EE, car elle implémente l’ensemble des regroupements JDBC 3.0 et des interfaces XA. |
| com.microsoft.sqlserver.jdbc. SQLServerConnectionPoolDataSource | javax.sql.ConnectionPoolDataSource | Cette classe est une fabrique de connexions qui permet au serveur d'applications Java EE de peupler son regroupement de connexions à l'aide de connexions physiques. Si la configuration du fournisseur de Java EE nécessite une classe implémentant javax.sql.ConnectionPoolDataSource, définissez le nom de classe comme SQLServerConnectionPoolDataSource. En règle générale, nous vous recommandons d’utiliser plutôt la classe SQLServerXADataSource, car elle implémente le regroupement et les interfaces XA ; de plus, elle a été vérifiée dans davantage de configurations de serveur Java EE. |
Le code d'application JDBC doit toujours fermer les connexions de façon explicite afin de profiter au maximum du regroupement. Si l'application ferme explicitement une connexion, l'implémentation du regroupement peut réutiliser la connexion immédiatement. Si la connexion n'est pas fermée, d'autres applications ne peuvent pas la réutiliser. Des applications peuvent utiliser la construction finally pour s’assurer que les connexions regroupées sont fermées même en cas d’exception.
Notes
Toutes les bibliothèques de regroupement de connexions Java tierces implémentent les API JDBC ci-dessus à des fins de regroupement de connexions. Ces bibliothèques doivent implémenter leurs propres méthodes pour renvoyer les connexions à leurs états d’origine lorsqu’elles sont retournées au pool de connexions.