各製品の資料を入手。
詳細はこちら →製品をチェック
Tomcat Connection Pool にCData JDBC Driver を設定してSalesforce のデータに連携
Tomcat Connection Pool からSalesforce に連携接続。
古川えりかコンテンツスペシャリスト
最終更新日:2022-09-12
この記事で実現できるSalesforce 連携のシナリオ
こんにちは!ドライバー周りのヘルプドキュメントを担当している古川です。
CData JDBC Drivers は標準JDBC インターフェースをサポートし、JVM 上で実行されるWeb アプリケーションに統合します。この記事では、Tomcat のConnection Pool からSalesforce に接続する方法について詳しく説明します。
Tomcat のConnection Pool 経由でSalesforce のデータに接続
- CData JAR およびCData .lic ファイルを$CATALINA_HOME/lib にコピーします。CData JAR はインストールディレクトリの[lib]サブフォルダ内にあります。
- コンテキストにリソースの定義を追加します:
Salesforce 接続プロパティの設定方法
標準認証の設定
Salesforce への接続には、以下の3つの認証方式が利用可能です。標準的な認証方式では、以下の情報が必要となります。
- ユーザー名
- パスワード
- セキュリティトークン
セキュリティトークンの取得方法については、セキュリティトークン取得手順をご参照ください。
OAuth 認証の設定
ユーザー名とパスワードによる認証が利用できない(避けたい)場合は、OAuth 認証を使用することができます。
SSO(シングルサインオン)の設定
IDプロバイダー経由でのシングルサインオンを利用する場合は、以下のプロパティを設定してください。
- SSOProperties
- SSOLoginUrl
- TokenUrl
詳細な設定手順については、ヘルプドキュメントの「はじめに」セクションをご確認ください。
<Resource name="jdbc/salesforce" auth="Container" type="javax.sql.DataSource" driverClassName="cdata.jdbc.salesforce.SalesforceDriver" factory="org.apache.tomcat.jdbc.pool.DataSourceFactory" url="jdbc:salesforce:User=username;Password=password;SecurityToken=Your_Security_Token;" maxActive="20" maxIdle="10" maxWait="-1" />
一つのアプリケーションからSalesforce へのアクセスを許可するには、上のコードをアプリケーションのMETA-INF ディレクトリにあるcontext.xml に追加します。
共有リソースの設定には、上のコードを$CATALINA_BASE/conf 内にあるcontext.xml に追加します。共有リソースの設定は、すべてのアプリケーションにSalesforce への接続を提供します。
- アプリケーションのweb.xml にリソースへの参照を追加します。
Salesforce のデータ JSP jdbc/Salesforce javax.sql.DataSource コンテナ -
Connection pool からの接続の初期化:
Context initContext = new InitialContext(); Context envContext = (Context)initContext.lookup("java:/comp/env"); DataSource ds = (DataSource)envContext.lookup("jdbc/Salesforce"); Connection conn = ds.getConnection();
そのほかのTomcat へのデータ連携ドライバーの統合
上記の手順では、簡単なコネクションプーリングのシナリオでSalesforce に接続する方法を説明しました。ほかの使用例や情報については、 Tomcat 製品ドキュメントの 「JNDI Datasource How-To」をご覧ください。