ノーコードでクラウド上のデータとの連携を実現。
詳細はこちら →CData
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for Salesforce は、Java アプリケーションとリアルタイムSalesforce データ のデータ連携を実現します。これらの技術を組み合わせることによって、Salesforce データ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するSalesforce データ の読み書きのためのコードの作成について説明します。
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyAccountDAO {
//insert new data into Salesforce
@SqlUpdate("INSERT INTO Account (Name, AnnualRevenue) values (:name, :annualRevenue)")
void insert(@Bind("name") String name, @Bind("annualRevenue") String annualRevenue);
//request specific data from Salesforce (String type is used for simplicity)
@SqlQuery("SELECT AnnualRevenue FROM Account WHERE Name = :name")
String findAnnualRevenueByName(@Bind("name") String name);
/*
* close with no args is used to close the connection
*/
void close();
}
必要な接続プロパティを収集し、Salesforce に接続するための適切なJDBC URL を作成します。
Salesforce への接続には通常のログインの他、OAuth やSSO を利用できます。ログイン方式では、ユーザー名、パスワード、セキュリティトークンを使って接続します。Salesforce セキュリティトークンの取得についてはこちらの記事をご確認ください。
ユーザー名、パスワードを使用しない、またはできない場合、OAuth 認証を利用できます。
SSO (シングルサインオン) は、SSOProperties、SSOLoginUrl、TokenUrl プロパティを設定することでID プロバイダー経由で利用できます。詳細はヘルプドキュメントの「はじめに」を参照してください。
JDBC URL の構成については、Salesforce JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.salesforce.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Salesforce の接続文字列は、通常次のようになります。
jdbc:salesforce:User=username;Password=password;SecurityToken=Your_Security_Token;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:salesforce:User=username;Password=password;SecurityToken=Your_Security_Token;");
MyAccountDAO dao = dbi.open(MyAccountDAO.class);
//do stuff with the DAO
dao.close();
Salesforce への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Salesforce のAccount エンティティからデータを取得できます。
//disply the result of our 'find' method
String annualRevenue = dao.findAnnualRevenueByName("GenePoint");
System.out.println(annualRevenue);
以前定義した方法を使用すれば、Salesforce にデータを書き込むことも簡単になります。
//add a new entry to the Account entity
dao.insert(newName, newAnnualRevenue);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for Salesforce と統合することで、SQL Object API for Salesforce を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムSalesforce を操作しましょう。