各製品の資料を入手。
詳細はこちら →Jetty コネクションプールからKintone のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします:本記事では、Jetty のWeb アプリからKintone のデータに連携する手順を説明します。
最終更新日:2023-06-18
この記事で実現できるKintone 連携のシナリオ
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for Kintone は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にKintone のデータをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for Kintone を設定します。
DBC Driver for Kintone を JNDI Data Source として設定
次の手順で、Jetty とKintone の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi
- JDBC Driver の.jar ファイルと.lic ファイル(インストールディレクトリのlib フォルダ下)をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Kintone のデータソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
<Configure id='kintonedemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="kintonedemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="kintonedemo"/></Arg> <Arg>jdbc/kintonedb</Arg> <Arg> <New class="cdata.jdbc.kintone.KintoneDriver"> <Set name="url">jdbc:kintone:</Set> <Set name="User">myuseraccount</Set> <Set name="Password">mypassword</Set> <Set name="URL">http://subdomain.domain.com</Set> </New> </Arg> </New> </Configure>
Kintone 接続プロパティの設定方法
Kintone に接続するには、以下の接続プロパティを設定する必要があります。
- URL:Kintone のアクセスURL(例:https://yoursitename.cybozu.com または https://yoursitename.kintone.com)
- User:アカウントのユーザー名
- Password:アカウントのパスワード
- AuthScheme:Password を指定
パスワード認証の代わりにAPI トークン認証を利用する場合は、ヘルプドキュメントの「接続の設定」セクションをご参照ください。
Basic 認証の設定
ご利用のKintone ドメインでBasic 認証を有効にしている場合は、接続プロパティの「詳細」設定で以下の項目を追加設定してください。
- BasicAuthUser:Basic認証のユーザー名
- BasicAuthPassword:Basic認証のパスワード
クライアント証明書認証の設定
Basic認証の代わりにクライアント証明書による認証を利用する場合は、以下の項目を設定してください。
- SSLClientCert:クライアント証明書のパス
- SSLClientCertType:証明書の種類
- SSLClientCertSubject:証明書のサブジェクト
- SSLClientCertPassword:証明書のパスワード
-
Web xml でリソースを設定します:
jdbc/kintonedb javax.sql.DataSource Container -
これで、java:comp/env/jdbc/kintonedb へのルックアップでKintone のデータにアクセスできます:
InitialContext ctx = new InitialContext(); DataSource mykintone = (DataSource)ctx.lookup("java:comp/env/jdbc/kintonedb");
Jetty にさらに統合
ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 参照してください。