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

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

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

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

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

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

   java -jar ../start.jar --add-to-startd=jndi
2. JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
3. リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Reckon Accounts Hosted データソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
   <Configure id='reckonaccountshosteddemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="reckonaccountshosteddemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="reckonaccountshosteddemo"/></Arg> <Arg>jdbc/reckonaccountshosteddb</Arg> <Arg> <New class="cdata.jdbc.reckonaccountshosted.ReckonAccountsHostedDriver"> <Set name="url">jdbc:reckonaccountshosted:</Set> <Set name="SubscriptionKey">my_subscription_key</Set> <Set name="CountryVersion">2021.R2.AU</Set> <Set name="CompanyFile">Q:/CompanyName.QBW</Set> <Set name="User">my_user</Set> <Set name="Password">my_password</Set> <Set name="CallbackURL">http://localhost:33333</Set> <Set name="OAuthClientId">my_oauth_client_id</Set> <Set name="OAuthClientSecret">my_oauth_client_secret</Set> </New> </Arg> </New> </Configure>

   CData 製品 はOAuth 経由でReckon Accounts Hosted にリクエストを作成します。次の接続プロパティを指定します。

   • User： 必須。企業ファイルのユーザー名。
   • Password： 必須。企業ファイルのパスワード。
   • CompanyFile: 必須。企業ファイルへのパス。
   • InitiateOAuth：アクセストークンの処理をドライバーに任せる場合はGETANDREFRESH に設定。
   • CountryVersion：デフォルトは、2021.R2.AU です。

   カスタムOAuth アプリケーションを作成し、以下の追加の接続プロパティを指定することもできます。

   • SubscriptionKey：Azure Platform 上のReckon Portal から取得したAPI キー。
   • OAuthClientId：アプリケーション設定のクライアントID に設定。
   • OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
   • CallbackURL：カスタムOAuth アプリのリダイレクトURI。

   CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。ほかのOAuth 認証方法（Web、ヘッドレスなど）、カスタムOAuth アプリケーションの作成、その理由などについては、ヘルプドキュメントを参照してください。

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

   jdbc/reckonaccountshosteddb javax.sql.DataSource Container

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

Jetty にさらに統合

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