Java EE のサポートについて
以下のセクションでは、Microsoft SQL Server JDBC Driver が Java Platform, Enterprise Edition (Java EE) および JDBC 3.0 のオプションの API 機能をサポートするしくみについて説明します。このヘルプ システムで提供されるソース コード例は、これらの機能を使用するための優れた参考資料となります。
まず、使用している Java 環境 (JDK、JRE) に javax.sql パッケージが含まれていることを確認してください。このパッケージは、オプションの API を使用するすべての JDBC アプリケーションに必須です。JDK 1.5 以降のバージョンには、このパッケージが既に含まれているので、別途インストールする必要はありません。
ドライバー名
このドライバーのクラス名は、com.microsoft.sqlserver.jdbc.SQLServerDriver です。このドライバーは sqljdbc.jar ファイルまたは sqljdbc4.jar ファイルに含まれています。
このクラス名は、JDBC DriverManager クラスを使用してドライバーを読み込むたびに使用されます。また、ドライバー構成でドライバーのクラス名を指定する必要があるときにも使用されます。たとえば、Java EE アプリケーション サーバー内でデータ ソースを構成するには、ドライバーのクラス名を入力する必要が生じる場合があります。
データ ソース
この JDBC ドライバーは、Java EE または JDBC 3.0 データ ソースをサポートします。この JDBC ドライバーの SQLServerXADataSource クラスは、com.microsoft.sqlserver.jdbc.SQLServerXADataSource によって実装されています。
データ ソース名
データ ソースを使用して、データベース接続を確立できます。次の表は、JDBC ドライバーで使用できるデータ ソースを示しています。
| データ ソースの種類 | クラス名 | 説明 |
|---|---|---|
DataSource |
com.microsoft.sqlserver.jdbc.SQLServerDataSource |
非プーリング データ ソース。 |
ConnectionPoolDataSource |
com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource |
JAVA EE アプリケーション サーバー接続プールを構成するデータ ソース。通常は、アプリケーションが JAVA EE アプリケーション サーバー内で実行される場合に使用されます。 |
XADataSource |
com.microsoft.sqlserver.jdbc.SQLServerXADataSource |
JAVA EE XA データ ソースを構成するデータ ソース。通常は、アプリケーションが JAVA EE アプリケーション サーバーおよび 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");
データ ソース プロパティの詳細については、「データ ソースのプロパティの設定」を参照してください。