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

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

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

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

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

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

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

   TaxJar API への認証には、まず初めにTaxJar UI からAPI キーを取得する必要があります。

   NOTE：API の利用は、Professional およびPremium TaxJar プランでのみ可能です。

   すでにProfessional またはPremium プランをお持ちの方は、TaxJar UI にログインして、「アカウント」->「TaxJar API」に移動するとAPI キーを確認することができます。 API キーを取得したら、APIKey 接続プロパティに設定できます。

   その他の注意事項

   • デフォルトでは、エンティティが日付範囲フィルタをサポートしている場合、CData コネクタは過去3か月のデータを取得します。StartDate を設定して、取得するデータの最小作成日を指定することができます。
   • API キーがサンドボックスAPI アカウント用に作成されている場合は、UseSandbox をtrue に設定してください。ただし、すべてのエンドポイントが期待どおりに機能するとは限りません。詳しくは、TaxJar 開発者用ドキュメントを参照してください。

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

   jdbc/taxjardb javax.sql.DataSource Container

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

Jetty にさらに統合

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