JBoss のコネクションプールから Factorial のデータ に接続

CData JDBC Driver は、コネクションプーリングの標準手順に従ってJBoss で設定できます。本記事では、JBoss アプリケーションのコネクションプールから Factorial のデータ にアクセスする方法を解説します。JBoss 管理インターフェースを使用して CData JDBC Driver for Factorial を設定し、コネクションプールから Factorial のデータ にアクセスします。

管理コンソールから Factorial 用のJDBC データソースを作成

以下の手順に従って、ドライバーJAR を追加し、必要な接続プロパティを定義します。

1. Runtime メニューで、管理ドメインにデプロイするかスタンドアロンサーバーにデプロイするかに応じて、Domain またはServer メニューを選択し、「Manage deployments」をクリックしてDeployments ページを開きます。
2. Add をクリックします。表示されるウィザードで、インストールディレクトリのlib サブフォルダにあるドライバーのJAR ファイルとライセンスを追加します。デフォルト設定でウィザードを完了し、ドライバーを選択してEnable をクリックします。
3. Configuration メニューで、Subsystems -> Connector -> Datasources をクリックします。JDBC Datasources ページが開きます。
4. Add をクリックし、表示されるウィザードでドライバーの名前とJNDI 名を入力します。例：

   java:jboss/root/jdbc/API

5. 上記で追加したドライバーを選択します。

6. JDBC URL とユーザー名、パスワードを入力します。JDBC URL の構文は、jdbc:api: の後にセミコロン区切りの接続プロパティを記述します。

   認証

   Factorial は認証に OAuth 2.0 を使用し、自分の HR データに接続する場合も、他のユーザーが各自のデータに接続できるようにする場合も、OAuth 2.0 認証を利用できます。

   OAuth 認証の設定

   OAuth を使って接続するには、以下のステップで進めます：

   1. Factorial の管理パネルに移動して、新しい OAuth アプリケーションを作成します。
   2. アプリケーション設定から Client ID と Client Secret をコピーします。
   3. 以下の接続プロパティを設定します。
   • AuthScheme：OAuth に設定します。
   • OAuthClientId：OAuth Client ID に設定します。
   • OAuthClientSecret：OAuth Client Secret に設定します。
   • Scope：データへのアクセス権限を指定します（デフォルト："read write"）。

   組み込みの接続文字列デザイナー

   JDBC URL の作成には、Factorial JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからJAR ファイルを実行します。

   
   java -jar cdata.jdbc.api.jar
   

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   

   一般的な接続文字列は次のとおりです。

   
   jdbc:api:Profile=C:\profiles\Factorial.apip;AuthScheme=OAuth;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;
   

7. 接続をテストしてウィザードを完了します。Factorial データソースを選択し、Enable をクリックします。

JBoss のその他の統合

上記の手順は、シンプルなコネクションプーリングシナリオでドライバーを設定する方法を示しています。詳細については、JBoss EAP ドキュメントのData Source Management の章を参照してください。