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

CData JDBC Driver for SharePoint は、Java Web アプリケーションへの統合が簡単です。この記事では、接続プールを設定することで Jetty から SharePoint のデータ に効率的に接続する方法を説明します。Jetty で SharePoint 用の 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 アプリレベルで SharePoint データソースを宣言しています。

   
   <Configure id='sharepointdemo' class="org.eclipse.jetty.webapp.WebAppContext">
       <New id="sharepointdemo" class="org.eclipse.jetty.plus.jndi.Resource">
       <Arg><Ref refid="sharepointdemo"/></Arg>
       <Arg>jdbc/sharepointdb</Arg>
       <Arg>
         <New class="cdata.jdbc.sharepoint.SharePointDriver">
           <Set name="url">jdbc:sharepoint:</Set>
           <Set name="User">myuseraccount</Set>
           <Set name="Password">mypassword</Set>
           <Set name="Auth Scheme">NTLM</Set>
           <Set name="URL">http://sharepointserver/mysite</Set>
           <Set name="SharePointEdition">SharePointOnPremise</Set>
         </New>
       </Arg>
     </New>
   </Configure>
   

   Microsoft SharePoint への接続

   URL の設定：

   Microsoft SharePoint では、2つの範囲でデータを操作できます。グローバルなMicrosoft SharePoint サイト全体を対象にするか、個々のサイトのみを対象にするかを選択できます。

   グローバルなMicrosoft SharePoint サイトですべてのリストおよびドキュメントを操作したい場合は、URL 接続プロパティをサイトコレクションURL に設定しましょう。以下のような形式です。

   https://teams.contoso.com

   個々のサイトのリストおよびドキュメントのみを扱いたい場合は、URL 接続プロパティを個々のサイトURL に設定してください。以下のような形式です。

   https://teams.contoso.com/TeamA

   続いて、お使いの環境に適した認証プロパティを設定していきましょう。詳細な設定手順については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」をご参照ください。

   Microsoft SharePoint Online

   SharePointEdition を"SharePoint Online" に設定し、User およびPassword にはSharePoint へのログオンで使用するクレデンシャル（例：Microsoft Online Services アカウントのクレデンシャル）を設定します。

   Microsoft SharePoint Online は様々なクラウドベースアーキテクチャをサポートしており、それぞれ異なる認証スキームが利用できます。

   • Microsoft Entra ID（Azure AD）
   • ADFS、Okta、OneLogin、またはPingFederate SSO ID プロバイダーを介したシングルサインオン（SSO）
   • Azure MSI
   • Azure パスワード
   • OAuthJWT
   • SharePointOAuth

   Microsoft SharePoint オンプレミス

   Microsoft SharePoint オンプレミスでは、多くのオンプレミス環境に対応した認証方式をサポートしています。

   • Windows（NTLM）
   • Kerberos
   • ADFS
   • 匿名アクセス

   まずSharePointEdition を"SharePoint On-Premises" に設定しましょう。

   Windows（NTLM）認証

   これは最も一般的な認証方式です。そのため、CData 製品ではNTLM をデフォルトとして使用するよう事前設定されています。Windows のUser およびPassword を設定するだけで接続できます。

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

   
     jdbc/sharepointdb
     javax.sql.DataSource
     Container
   
   

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

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

Jetty 統合の詳細

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