各製品の資料を入手。
詳細はこちら →Jetty コネクションプールからfreee のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします:本記事では、Jetty のWeb アプリからfreee のデータに連携する手順を説明します。
最終更新日:2023-06-18
この記事で実現できるfreee 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for API は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にfreee のデータをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for API を設定します。
DBC Driver for API を JNDI Data Source として設定
次の手順で、Jetty とfreee の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi
- JDBC Driver の.jar ファイルと.lic ファイル(インストールディレクトリのlib フォルダ下)をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、freee のデータソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
<Configure id='freeedemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="freeedemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="freeedemo"/></Arg> <Arg>jdbc/freeedb</Arg> <Arg> <New class="cdata.jdbc.api.APIDriver"> <Set name="url">jdbc:api:</Set> <Set name="Profile">freee.apip</Set> <Set name="ProfileSettings">'CompanyId</Set> <Set name="'"></Set> <Set name="Authscheme">OAuth</Set> <Set name="InitiateOAuth">GETANDREFRESH</Set> <Set name="OAuthClientId">your_client_id</Set> <Set name="OAuthClientSecret">your_client_secret</Set> <Set name="CallbackUrl">your_callback_url</Set> </New> </Arg> </New> </Configure>
まずはOAuth アプリを作成します。https://app.secure.freee.co.jp/developers/applications にアクセスして、「新しいアプリケーションの作成」ボタンをクリックします。アプリケーション名を指定し、リダイレクトURL を設定して登録をクリックします。そうすると、クライアントシークレットとクライアントID が発行されます。
次に、プロファイルをダウンロードしてドライバーがアクセス可能な場所に配置します。こちらからプロファイルをダウンロードして、「C:/profiles/」 などに設置してください。
その後、Companies ビューからCompanyId を取得します。以下の接続プロパティを設定したら、接続する準備ができます。
- AuthScheme:OAuth に設定します。
- OAuthClientID:アプリ設定で指定されたOAuth クライアントID に設定します。
- OAuthClientSecret:アプリ設定で指定されたOAuth クライアントシークレットに設定します。
- CallbackURL:アプリ設定で指定したリダイレクトURI に設定します。
- InitiateOAuth:GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
-
Web xml でリソースを設定します:
jdbc/freeedb javax.sql.DataSource Container -
これで、java:comp/env/jdbc/freeedb へのルックアップでfreee のデータにアクセスできます:
InitialContext ctx = new InitialContext(); DataSource myfreee = (DataSource)ctx.lookup("java:comp/env/jdbc/freeedb");
Jetty にさらに統合
ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 参照してください。