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

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

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

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

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

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

   java -jar ../start.jar --add-to-startd=jndi
2. JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
3. リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、ADP データソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
   <Configure id='adpdemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="adpdemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="adpdemo"/></Arg> <Arg>jdbc/adpdb</Arg> <Arg> <New class="cdata.jdbc.adp.ADPDriver"> <Set name="url">jdbc:adp:</Set> <Set name="OAuthClientId">YourClientId</Set> <Set name="OAuthClientSecret">YourClientSecret</Set> <Set name="SSLClientCert">'c:\cert.pfx'</Set> <Set name="SSLClientCertPassword">'admin@123'</Set> </New> </Arg> </New> </Configure>

   ADP 接続プロパティの取得・設定方法

   接続を確立する前に、ADP に連絡してOAuth アプリとそれに関連するクレデンシャルを提供してもらう必要があります。 これらのクレデンシャルはADP からのみ取得が可能で、直接取得することはできません。

   ADP への接続

   次のプロパティを指定してADP に接続します。

   • OAuthClientId：ADP より提供されたアプリのクライアントId に設定。
   • OAuthClientSecret：ADP より提供されたアプリのクライアントシークレットに設定。
   • SSLClientCert：ADP より提供された証明書に設定。
   • SSLClientCertPassword：証明書のパスワードに設定。
   • UseUAT：CData 製品はデフォルトで、本番環境にリクエストを行います。開発者アカウントを使用している場合は、UseUAT をtrue に設定します。
   • RowScanDepth：テーブルで利用可能なカスタムフィールドカラムをスキャンする行数の最大値。デフォルト値は100に設定されています。大きい値を設定すると、パフォーマンスが低下する場合があります。

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

   jdbc/adpdb javax.sql.DataSource Container

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

Jetty にさらに統合

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