各製品の資料を入手。
詳細はこちら →Jetty コネクションプールからReckon Accounts Hosted のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします:本記事では、Jetty のWeb アプリからReckon Accounts Hosted のデータに連携する手順を説明します。
最終更新日:2023-06-18
この記事で実現できる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 の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi
- JDBC Driver の.jar ファイルと.lic ファイル(インストールディレクトリのlib フォルダ下)をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、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 アプリケーションの作成、その理由などについては、ヘルプドキュメントを参照してください。
-
Web xml でリソースを設定します:
jdbc/reckonaccountshosteddb javax.sql.DataSource Container -
これで、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 参照してください。