各製品の資料を入手。
詳細はこちら →Jetty コネクションプールからWave Financial のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします:本記事では、Jetty のWeb アプリからWave Financial のデータに連携する手順を説明します。
最終更新日:2023-06-18
この記事で実現できるWave Financial 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for WaveFinancial は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にWave Financial のデータをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for WaveFinancial を設定します。
DBC Driver for WaveFinancial を JNDI Data Source として設定
次の手順で、Jetty とWave Financial の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi
- JDBC Driver の.jar ファイルと.lic ファイル(インストールディレクトリのlib フォルダ下)をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Wave Financial のデータソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
<Configure id='wavefinancialdemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="wavefinancialdemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="wavefinancialdemo"/></Arg> <Arg>jdbc/wavefinancialdb</Arg> <Arg> <New class="cdata.jdbc.wavefinancial.WaveFinancialDriver"> <Set name="url">jdbc:wavefinancial:</Set> </New> </Arg> </New> </Configure>
Wave Financial 接続プロパティの取得・設定方法
Wave Financial は、データに接続する手段として、API トークンを指定する方法とOAuth 認証情報を使用する方法の2つを提供しています。
API トークン
Wave Financial API トークンを取得するには:- Wave Financial アカウントにログインします。
- 左ペインのManage Applications に移動します。
- トークンを作成するアプリケーションを選択します。最初にアプリケーションを作成する必要がある場合があります。
- API トークンを生成するには、Create token をクリックします。
OAuth
Wave Financial はOAuth 認証のみサポートします。すべてのOAuth フローで、この認証を有効にするにはAuthScheme をOAuth に設定する必要があります。ヘルプドキュメントでは、以下の3つの一般的な認証フローでのWave Financial への認証について詳しく説明しています。
- デスクトップ:ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。組み込みOAuth またはカスタムOAuth で認証されます。
- Web:共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
- ヘッドレスサーバー:他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。組み込みOAuth またはカスタムOAuth で認証されます。
カスタムOAuth アプリケーションの作成についての情報と、組み込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、ヘルプドキュメント の「カスタムOAuth アプリケーションの作成」セクションを参照してください。
-
Web xml でリソースを設定します:
jdbc/wavefinancialdb javax.sql.DataSource Container -
これで、java:comp/env/jdbc/wavefinancialdb へのルックアップでWave Financial のデータにアクセスできます:
InitialContext ctx = new InitialContext(); DataSource mywavefinancial = (DataSource)ctx.lookup("java:comp/env/jdbc/wavefinancialdb");
Jetty にさらに統合
ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 参照してください。