Jetty の接続プールから Shopify のデータ に接続

CData JDBC Driver for Shopify は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から Shopify のデータ に効率的に接続する方法を説明します。Jetty で Shopify 用の JNDI リソースを設定していきましょう。

Salesforce 用の JDBC Driver を JNDI データソースとして設定

以下のステップで Jetty から Salesforce に接続します。

1. Jetty ベースで JNDI モジュールを有効にします。次のコマンドは、コマンドラインから JNDI を有効にします。

   java -jar ../start.jar --add-to-startd=jndi
   

2. インストールディレクトリの lib サブフォルダにある CData およびライセンスファイルを、コンテキストパスの lib サブフォルダに追加します。

3. リソースとそのスコープを宣言します。リソース宣言に必要な接続プロパティを入力します。次の例では、WEB-INF\jetty-env.xml に Web アプリレベルで Shopify データソースを宣言しています。

   
   <Configure id='shopifydemo' class="org.eclipse.jetty.webapp.WebAppContext">
       <New id="shopifydemo" class="org.eclipse.jetty.plus.jndi.Resource">
       <Arg><Ref refid="shopifydemo"/></Arg>
       <Arg>jdbc/shopifydb</Arg>
       <Arg>
         <New class="cdata.jdbc.shopify.ShopifyDriver">
           <Set name="url">jdbc:shopify:</Set>
           <Set name="AppId">MyAppId</Set>
           <Set name="Password">MyPassword</Set>
           <Set name="ShopUrl">https://yourshopname.myshopify.com</Set>
         </New>
       </Arg>
     </New>
   </Configure>
   

   それでは、Shopify への接続・認証について説明していきましょう。Shopify では、アクセストークンとOAuth の2つの接続方法をサポートしています。

   アクセストークンによる接続

   アクセストークン経由の接続には、以下の2つのステップが必要です。

   1. Shopify の管理画面でアクセストークンを作成
   2. アクセストークンを使用して認証

   アクセストークンの作成

   まず、アプリを登録してアクセストークンを取得してみましょう。手順は以下のとおりです。

   1. 管理画面からShopify にログインし、Apps → Apps and sales channels に進みます
   2. Develop apps をクリックしてCreate an app を選択します
   3. Overview タブのConfiguration で、Admin API integration をクリックし、アプリに許可するストアのアクセス権を選択してください。CData製品が必要とするAdmin API 権限については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」セクションをご確認ください
   4. Save をクリックします
   5. Overview タブのConfiguration で、Storefront API integration をクリックし、アプリに許可するストアのアクセス権を選択します。CData製品が必要とするStorefront API 権限は以下のとおりです：
      • unauthenticated_read_content
   6. Save をクリックします
   7. API Credentials を選択します
   8. "Access tokens" の下でInstall app をクリックします。これでアクセストークンが作成されます
   9. Admin API Access token のアクセストークンをコピーします。注意：トークンの公開およびコピーは1回のみ可能ですので、必ず保存してください

   アクセストークンによる認証

   続いて、アクセストークンで認証するには、以下のプロパティを設定してください。

   • AuthScheme：AccessToken に設定
   • AccessToken：カスタムアプリからコピーしたアクセストークンの値に設定

   OAuth 認証を介した接続については、ヘルプドキュメントの「OAuth 認証の使用」をご確認ください。

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

   
     jdbc/shopifydb
     javax.sql.DataSource
     Container
   
   

5. これで、java:comp/env/jdbc/shopifydb をルックアップして Shopify にアクセスできます。

   InitialContext ctx = new InitialContext();
   DataSource myshopify = (DataSource)ctx.lookup("java:comp/env/jdbc/shopifydb");
   

Jetty 統合の詳細

上記のステップでは、シンプルな接続プールのシナリオでドライバーを設定する方法を説明しました。その他のユースケースや詳細については、Jetty ドキュメントのWorking with Jetty JNDI の章を参照してください。