J2EE のサポートについて
以下のセクションでは、Microsoft SQL Server 2005 JDBC Driver が J2EE および JDBC 3.0 のオプションの API 機能をサポートするしくみについて説明します。 このヘルプ システムで提供されるソース コード例は、これらの機能を使用するための優れた参考資料となります。
まず、使用している Java 環境 (JDK、JRE) に javax.sql パッケージが含まれていることを確認してください。 このパッケージは、オプションの API を使用するすべての JDBC アプリケーションに必須です。 JDK 1.4 以降のバージョンには、このパッケージが既に含まれているので、別途インストールする必要はありません。
ドライバ名
このドライバのクラス名は、com.microsoft.sqlserver.jdbc.SQLServerDriver です。 このドライバは sqljdbc.jar ファイルに含まれています。
このクラス名は、JDBC DriverManager クラスを使用してドライバを読み込むたびに使用されます。 また、ドライバ構成でドライバのクラス名を指定する必要があるときにも使用されます。 たとえば、J2EE アプリケーション サーバー内でデータ ソースを構成するには、ドライバのクラス名を入力する必要が生じる場合があります。
データ ソース
この JDBC ドライバは、J2EE または JDBC 3.0 データ ソースをサポートします。 この JDBC ドライバの SQLServerXADataSource クラスは、com.microsoft.sqlserver.jdbc.SQLServerXADataSource によって実装されます。
データ ソース名
データ ソースを使用して、データベース接続を確立できます。 次の表は、JDBC ドライバで使用できるデータ ソースを示しています。
| データ ソースの種類 | クラス名 | 説明 |
|---|---|---|
DataSource |
com.microsoft.sqlserver.jdbc.SQLServerDataSource |
非プーリング データ ソース。 |
ConnectionPoolDataSource |
com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource |
J2EE アプリケーション サーバー接続プールを構成するデータ ソース。 通常は、アプリケーションが J2EE アプリケーション サーバー内で実行される場合に使用されます。 |
XADataSource |
com.microsoft.sqlserver.jdbc.SQLServerXADataSource |
J2EE XA データ ソースを構成するデータ ソース。 通常は、アプリケーションが J2EE アプリケーション サーバーおよび XA トランザクション マネージャ内で実行される場合に使用されます。 |
データ ソースのプロパティ
すべてのデータ ソースは、基になるドライバのプロパティ セットに関連付けられているプロパティを設定または取得する機能をサポートします。
例 :
setServerName("localhost");
setDatabaseName("AdventureWorks");
以下は、アプリケーションがデータ ソースを使用して接続するしくみを示しています。
initialize JNDI ..
Context ctx = new InitialContext(System.getProperties());
...
DataSource ds = (DataSource) ctx.lookup("MyDataSource");
Connection c = ds.getConnection("user", "pwd");
データ ソース プロパティの詳細については、「データ ソースのプロパティの設定」を参照してください。