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

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

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

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

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

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

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

   Adobe Commerce はOAuth 1 認証標準を使用します。Adobe Commerce REST API に接続するには、Adobe Commerce システムにアプリを登録してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティの値を取得する必要があります。 OAuth 値を取得して接続するには、ヘルプドキュメントの「はじめに」を参照してください。

   また、Adobe Commerce システムへのURL を提供する必要があります。URL は、Adobe Commerce REST API を顧客として使用しているか管理者として使用しているかによって異なります。

   • Customer: Adobe Commerce を顧客として使用するには、事前にAdobe Commerce のホームページで顧客アカウントを作成します。これを行うには、「アカウント」->「登録」をクリックします。それからURL 接続プロパティをAdobe Commerce システムのエンドポイントに設定します。

   • Administrator: Adobe Commerce を管理者として使用するには、代わりにCustomAdminPath を設定します。この値は、「Admin」メニューの「Advanced」設定で取得できます。「System」->「Configuration」->「Advanced」->「Admin」->「Admin Base URL」を選択することでアクセスできます。

     このページ上の「Use Custom Admin Path」設定がYES に設定されている場合、値は「Custom Admin Path」テキストボックス内にあります。それ以外の場合は、CustomAdminPath 接続プロパティをデフォルト値の"admin" に設定します。

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

   jdbc/adobecommercedb javax.sql.DataSource Container

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

Jetty にさらに統合

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