Grundlegendes zur Java EE-Unterstützung
In den folgenden Abschnitten wird dokumentiert, wie Microsoft JDBC-Treiber für SQL Server die optionalen API-Features für die Java-Plattform, Enterprise Edition (Java EE) und JDBC 3.0 unterstützt. Die Quellcodebeispiele in diesem Hilfesystem stellen eine gute Referenz für die ersten Schritte mit diesen Features dar.
Stellen Sie zunächst sicher, dass die Java-Umgebung (JDK, JRE) das Paket javax.sql einschließt. Dieses Paket ist für alle JDBC-Anwendungen erforderlich, 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.
Für JDBC Driver 12.8 ist der Treiber in mssql-jdbc-12.8.0.jre8.jar oder mssql-jdbc-12.8.0.jre11.jar enthalten.
Für JDBC Driver 12.6 ist der Treiber in mssql-jdbc-12.6.0.jre8.jar oder mssql-jdbc-12.6.0.jre11.jar enthalten.
Für JDBC Driver 12.4 ist der Treiber in mssql-jdbc-12.4.0.jre8.jar oder mssql-jdbc-12.4.0.jre11.jar enthalten.
JDBC-Treiber 12.2: Der Treiber ist in der Datei mssql-jdbc-12.2.0.jre8.jar oder mssql-jdbc-12.2.0.jre11.jar enthalten.
JDBC-Treiber 11.2: Der Treiber ist in der Datei mssql-jdbc-11.2.0.jre8.jar, mssql-jdbc-11.2.0.jre11.jar, mssql-jdbc-11.2.0.jre17.jar oder mssql-jdbc-11.2.0.jre18.jar enthalten.
JDBC-Treiber 10.2: Der Treiber ist in der Datei mssql-jdbc-10.2.0.jre8.jar, mssql-jdbc-10.2.0.jre11.jar oder mssql-jdbc-10.2.0.jre17.jar enthalten.
JDBC-Treiber 9.4: Der Treiber ist in der Datei mssql-jdbc-9.4.1.jre8.jar, mssql-jdbc-9.4.1.jre11.jar oder mssql-jdbc-9.4.1.jre16.jar enthalten.
JDBC-Treiber 9.2: Der Treiber ist in der Datei mssql-jdbc-9.2.1.jre8.jar, mssql-jdbc-9.2.1.jre11.jar oder mssql-jdbc-9.2.1.jre15.jar enthalten.
JDBC Driver 8.4: Der Treiber ist in der Datei mssql-jdbc-8.4.1.jre8.jar, mssql-jdbc-8.4.1.jre11.jar oder mssql-jdbc-8.4.1.jre14.jar enthalten.
JDBC Driver 8.2: Der Treiber ist in der Datei mssql-jdbc-8.2.2.jre8.jar, mssql-jdbc-8.2.2.jre11.jar oder mssql-jdbc-8.2.2.jre13.jar enthalten.
JDBC-Treiber 7.4: Der Treiber ist in der Datei mssql-jdbc-7.4.1.jre8.jar, mssql-jdbc-7.4.1.jre11.jar oder mssql-jdbc-7.4.1.jre12.jar enthalten.
JDBC-Treiber 7.2: Der Treiber ist in der Datei mssql-jdbc-7.2.2.jre8.jar oder mssql-jdbc-7.2.2.jre11.jar enthalten.
JDBC-Treiber 7.0: Der Treiber ist in der Datei mssql-jdbc-7.0.0.jre8.jar oder mssql-jdbc-7.0.0.jre10.jar enthalten.
JDBC-Treiber 6.4: Der Treiber ist in der Datei mssql-jdbc-6.4.0.jre7.jar, mssql-jdbc-6.4.0.jre8.jar oder mssql-jdbc-6.4.0.jre9.jar enthalten.
JDBC-Treiber 6.2: Der Treiber ist in der Datei mssql-jdbc-6.2.2.jre7.jar oder mssql-jdbc-6.2.2.jre8.jar enthalten.
Für die JDBC-Treiber 4.1, 4.2 und 6.0 ist der Treiber in einer der folgenden Dateien enthalten: sqljdbc.jar, sqljdbc4.jar, sqljdbc41.jar oder sqljdbc42.jar.
Der Klassenname wird jedes Mal verwendet, wenn Sie den Treiber mit der JDBC-Klasse „DriverManager“ laden und wenn Sie den Klassennamen des Treibers in einer beliebigen Treiberkonfiguration angeben. Für das Konfigurieren einer Datenquelle in einem Java EE-Anwendungsserver kann es beispielsweise erforderlich sein, den Treiberklassennamen einzugeben.
Datenquellen
Der JDBC-Treiber unterstützt Java EE-/JDBC 3.0-Datenquellen. Die JDBC-Treiberklasse SQLServerXADataSource 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 und 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-Anwendungsserver. Wird normalerweise verwendet, wenn die Anwendung innerhalb eines Java EE-Anwendungsservers ausgeführt wird. |
| XADataSource | com.microsoft.sqlserver.jdbc.SQLServerXADataSource Die Datenquelle zum Konfigurieren von Java EE-XA-Datenquellen. Wird normalerweise verwendet, wenn die Anwendung innerhalb eines Java EE-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 der Datenquelleneigenschaften.