各製品の資料を入手。
詳細はこちら →
製品をチェック
Jetty コネクションプールからSalesforce Data Cloud のデータに連携。
CData JDBC Driver は、コネクションプーリングをサポートします：本記事では、Jetty のWeb アプリからSalesforce Data Cloud のデータに連携する手順を説明します。
最終更新日：2023-06-18
この記事で実現できるSalesforce Data Cloud 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData JDBC Driver for SalesforceDataCloud は、Java Web アプリケーションに簡単に統合して利用することができます。本記事では、Jetty でドライバーをコネクションプールとして設定することで、効率的にSalesforce Data Cloud のデータをアプリケーションで連携利用する方法を説明します。Jetty でJNDI resource for SalesforceDataCloud を設定します。
DBC Driver for SalesforceDataCloud を JNDI Data Source として設定
次の手順で、Jetty とSalesforce Data Cloud の接続を確立します。
Jetty ベースでJNDI モジュールを有効化します。JNDI を有効化するコマンドラインは以下の通り:
java -jar ../start.jar --add-to-startd=jndi- JDBC Driver の.jar ファイルと.lic ファイル（インストールディレクトリのlib フォルダ下）をcontext path のlib フォルダに配置します。
-
リソースおよびスコープを宣言します。リソース宣言で必要な接続プロパティを入力します。この例では、Salesforce Data Cloud のデータソースをWeb アプリケーションのWEB-INF\jetty-env.xml レベルにdeclare しています。
<Configure id='salesforcedcdemo' class="org.eclipse.jetty.webapp.WebAppContext"> <New id="salesforcedcdemo" class="org.eclipse.jetty.plus.jndi.Resource"> <Arg><Ref refid="salesforcedcdemo"/></Arg> <Arg>jdbc/salesforcedcdb</Arg> <Arg> <New class="cdata.jdbc.salesforcedatacloud.SalesforceDataCloudDriver"> <Set name="url">jdbc:salesforcedatacloud:</Set> </New> </Arg> </New> </Configure>Salesforce Data Cloud は、OAuth 標準による認証をサポートしています。
OAuth
AuthScheme をOAuth に設定します。
デスクトップアプリケーション
CData は、デスクトップでの認証を簡略化する埋め込みOAuth アプリケーションを提供します。
また、Salesforce Data Cloud コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することもできます。詳しくは、ヘルプドキュメントのカスタムOAuth アプリの作成を参照してください。
接続する前に、次のプロパティを設定します。
- InitiateOAuth：GETANDREFRESH。InitiateOAuth を使えば、繰り返しOAuth の交換を行ったり、手動でOAuthAccessToken を設定する必要はなくなります。
- OAuthClientId （カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントID。
- OAuthClientSecret （カスタムアプリケーションのみ）：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
接続すると、本製品 はデフォルトブラウザでSalesforce Data Cloud のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。
以下のようにドライバーがOAuth プロセスを完了します。
- コールバックURL からアクセストークンを取得します。
- 古いトークンの期限が切れたときは、新しいアクセストークンを取得します。
- OAuthSettingsLocation にOAuth 値を保存し、接続間で永続化します。
Web アプリケーションやヘッドレスマシンを含むその他のOAuth メソッドについては、ヘルプドキュメントを参照してください。
-
Web xml でリソースを設定します:
jdbc/salesforcedcdb javax.sql.DataSource Container -
これで、java:comp/env/jdbc/salesforcedcdb へのルックアップでSalesforce Data Cloud のデータにアクセスできます:
InitialContext ctx = new InitialContext(); DataSource mysalesforcedc = (DataSource)ctx.lookup("java:comp/env/jdbc/salesforcedcdb");
Jetty にさらに統合
ここでは、シンプルなコネクションプーリングシナリオでのドライバーの接続について説明しました。追加での連携ケースについては、Jetty ドキュメントのWorking with Jetty JNDI 参照してください。
関連コンテンツ
