Grundlegendes zur J2EE-Unterstützung
In den folgenden Abschnitten wird dokumentiert, wie Microsoft SQL Server 2005 JDBC Driver die optionalen API-Features J2EE 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.4 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 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 J2EE-Anwendungserver kann es beispielsweise erforderlich sein, den Treiberklassennamen einzugeben.
Datenquellen
Der JDBC-Treiber unterstützt J2EE-/ 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 J2EE-Anwendungserver. Wird normalerweise verwendet, wenn die Anwendung innerhalb eines J2EE-Anwendungsservers ausgeführt wird. |
XADataSource |
com.microsoft.sqlserver.jdbc.SQLServerXADataSource |
Die Datenquelle zum Konfigurieren von J2EE-XA-Datenquellen. Wird normalerweise verwendet, wenn die Anwendung innerhalb eines J2EE-Anwendungsservers und eines XA-Transaktionsmanagers 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.