Grundlegendes zur Java EE-Unterstützung
In den folgenden Abschnitten wird dokumentiert, wie Microsoft SQL Server JDBC Driver die optionalen API-Features für die Java-Plattform, Enterprise Edition 5 (Java EE 5) und JDBC 3.0 unterstützt. Die Quellcodebeispiele in diesem Hilfesystem stellen eine gute Referenz für erste Schritte mit diesen Features dar.
Stellen Sie zunächst sicher, dass die Java-Umgebung (JDK, JRE) das Paket javax.sql einschließt. Dies ist ein erforderliches Paket für alle JDBC-Anwendungen, die die optionale API verwenden. JDK 1.5 und höhere Versionen umfassen dieses Paket bereits, sodass Sie es nicht separat installieren müssen.
Treibername
Der Treiberklassenname lautet com.microsoft.sqlserver.jdbc.SQLServerDriver. Der Treiber ist in der Datei sqljdbc.jar oder sqljdb4.jar enthalten.
Der Klassenname wird immer dann verwendet, wenn Sie den Treiber mit der JDBC-Klasse DriverManager laden. Er wird außerdem verwendet, wenn Sie den Klassennamen des Treibers in einer Treiberkonfiguration angeben müssen. Für das Konfigurieren einer Datenquelle in einem Java EE 5-Anwendungsserver kann es beispielsweise erforderlich sein, den Treiberklassennamen einzugeben.
Datenquellen
Der JDBC-Treiber unterstützt Java EE 5-/JDBC 3.0-Datenquellen. Die SQLServerXADataSource-Klasse des JDBC-Treibers wird von com.microsoft.sqlserver.jdbc.SQLServerXADataSource implementiert.
Datenquellennamen
Sie können Datenbankverbindungen mithilfe von Datenquellen herstellen. Die mit dem JDBC-Treiber verfügbaren Datenquellen werden in der folgenden Tabelle beschrieben:
| DataSource-Typ | Klassenname | Beschreibung |
|---|---|---|
DataSource |
com.microsoft.sqlserver.jdbc.SQLServerDataSource |
Die Datenquelle ohne Pooling. |
ConnectionPoolDataSource |
com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource |
Die Datenquelle zum Konfigurieren von Verbindungspools für Java EE 5-Anwendungsserver. Wird normalerweise verwendet, wenn die Anwendung innerhalb eines Java EE 5-Anwendungsservers ausgeführt wird. |
XADataSource |
com.microsoft.sqlserver.jdbc.SQLServerXADataSource |
Die Datenquelle zum Konfigurieren von Java EE 5-XA-Datenquellen. Wird normalerweise verwendet, wenn die Anwendung innerhalb eines Java EE 5-Anwendungsservers und eines XA-Transaktions-Managers ausgeführt wird. |
Datenquelleneigenschaften
Alle Datenquellen unterstützen die Möglichkeit zum Festlegen und Abrufen aller Eigenschaften, die dem Eigenschaftenset des zugrunde liegenden Treibers zugeordnet sind.
Beispiele:
setServerName("localhost");
setDatabaseName("AdventureWorks");
Im Folgenden wird veranschaulicht, wie eine Anwendung mit einer Datenquelle eine Verbindung herstellt:
initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
Weitere Informationen zu den Datenquelleneigenschaften finden Sie unter Festlegen von Datenquelleneigenschaften.