Jetty コネクションプールからPCA Sales データに連携。

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData JDBC Driver for PCASales は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にPCA Sales データをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for PCASales を設定します。

DBC Driver for PCASales を JNDI Data Source として設定

次の手順で、Jetty とPCA Sales の接続を確立します。

1. Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:

   java -jar ../start.jar --add-to-startd=jndi
2. JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
3. リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、PCA Sales データソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
   <Configure id='pcasalesdemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="pcasalesdemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="pcasalesdemo"/></Arg> <Arg>jdbc/pcasalesdb</Arg> <Arg> <New class="cdata.jdbc.pcasales.PCASalesDriver"> <Set name="url">jdbc:pcasales:</Set> <Set name="OAuthClientId">MyOAuthClientId</Set> <Set name="OAuthClientSecret">MyOAuthClientSecret</Set> <Set name="CallbackURL">http://localhost:33333</Set> <Set name="ProductCode">MyProductCode</Set> <Set name="ApiVersion">V1</Set> <Set name="DataCenter">DataCenterName</Set> <Set name="DefaultDataArea">MyDefaultDataArea</Set> </New> </Arg> </New> </Configure>

   PCA クラウド商魂・商管DX では、OAuth 2 認証標準を使います。

   ユーザー資格情報の接続プロパティを設定せずに接続できます。接続に最小限必要な接続プロパティは、次のとおりです。

   • InitiateOAuth：GETANDREFRESH に設定。InitiateOAuth を使って、OAuth 交換や、手動での接続文字列のアクセストークン設定の繰り返しを避けられます。
   • OAuthClientId：アプリケーション設定のクライアントId に設定。
   • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
   • CallbackURL：アプリケーション設定のリダイレクトURL に設定。
   • ApiVersion：接続するPCA API Server バージョンを設定。
   • DefaultDataArea：接続するデータ領域を設定。
   • DataCenter：接続するサーバーのDataCenter 名を設定。
   • ProductCode：PCA 製品コード名を設定。

   接続すると、CData 製品はデフォルトブラウザでPCA Accounting OAuth エンドポイントを開きます。ログインして、CData 製品にアクセス許可を与えます。CData 製品がOAuth プロセスを完了します。

   ヘッドレスマシンの認証など、他のOAuth 認証フローについては、ヘルプドキュメントの「OAuth 認証の使用」を参照してください。

4. Web xml でリソースを設定します:

   jdbc/pcasalesdb javax.sql.DataSource Container

5. これで、java:comp/env/jdbc/pcasalesdb へのルックアップでPCA Sales データにアクセスできます: InitialContext ctx = new InitialContext(); DataSource mypcasales = (DataSource)ctx.lookup("java:comp/env/jdbc/pcasalesdb");

Jetty にさらに統合

ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 　参照してください。