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

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

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

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

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

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

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

   API Token を取得する方法

   API token は、アカウントへの認証に必須です。トークンの生成には、Atlassian アカウントでサービスにログインし、API tokens > Create API token に進みます。生成されたトークンが表示されます。

   Confluence Cloud Account への接続

   Cloud アカウントへの接続には、以下のプロパティを設定します（Password は、Server Instance への接続時のみ必要で、Cloud Account への接続には不要になりました。）:

   • User: Confluence サーバーに認証するユーザー名。
   • APIToken: 認証するユーザーに紐付けられたAPI Token。
   • Url: JIRA エンドポイントのURL。例： https://yoursitename.atlassian.net

   Confluence Server Instance への接続

   Server instance への接続には以下を設定します:

   • User: Confluence Instance に接続するユーザー名。
   • Password: Confluence Instance に接続するユーザーのパスワード。
   • Url: JIRA エンドポイントのURL。例： https://yoursitename.atlassian.net

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

   jdbc/confluencedb javax.sql.DataSource Container

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

Jetty にさらに統合

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