製品をチェック

Act-On Driver の30日間無償トライアルをダウンロード

 30日間の無償トライアルへ

製品の詳細

Act-On アイコン Act-On JDBC Driver 相談したい

驚くほど簡単にJDBC でJava アプリケーションにAct-On マーケティングオートメーションのCampaigns、Programs、Reports データを連携!

JDBI からAct-On データ のデータアクセスオブジェクトを作成

JDBI でAct-On データ 用のSQL オブジェクトAPIを作成する方法を概説します。

加藤龍彦
ウェブデベロッパー

最終更新日:2022-05-25
acton ロゴ

CData

jdbc ロゴ画像
JDBI ロゴ

こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for ActOn は、Java アプリケーションとリアルタイムAct-On データ のデータ連携を実現します。これらの技術を組み合わせることによって、Act-On データ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するAct-On データ の読み書きのためのコードの作成について説明します。

Act-On Images Entity のDAO を作成

以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。

public interface MyImagesDAO { //insert new data into Act-On @SqlUpdate("INSERT INTO Images (FolderName, Name) values (:folderName, :name)") void insert(@Bind("folderName") String folderName, @Bind("name") String name); //request specific data from Act-On (String type is used for simplicity) @SqlQuery("SELECT Name FROM Images WHERE FolderName = :folderName") String findNameByFolderName(@Bind("folderName") String folderName); /* * close with no args is used to close the connection */ void close(); }

Act-On への接続を開く

必要な接続プロパティを収集し、Act-On に接続するための適切なJDBC URL を作成します。

ActOn はOAuth 認証標準を利用しています。OAuth を使って認証するには、アプリケーションを作成してOAuthClientIdOAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

認証方法についての詳細は、ヘルプドキュメントの「認証の使用」を参照してください。

ビルトイン接続文字列デザイナー

JDBC URL の構成については、Act-On JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

java -jar cdata.jdbc.acton.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

Using the built-in connection string designer to generate a JDBC URL (Salesforce is shown.)

Act-On の接続文字列は、通常次のようになります。

jdbc:acton:InitiateOAuth=GETANDREFRESH

構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。

DBI dbi = new DBI("jdbc:acton:InitiateOAuth=GETANDREFRESH"); MyImagesDAO dao = dbi.open(MyImagesDAO.class); //do stuff with the DAO dao.close();

Act-On データ について

Act-On への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Act-On のImages エンティティからデータを取得できます。

//disply the result of our 'find' method String name = dao.findNameByFolderName("New Folder"); System.out.println(name);

Act-On データ の書き方

以前定義した方法を使用すれば、Act-On にデータを書き込むことも簡単になります。

//add a new entry to the Images entity dao.insert(newFolderName, newName);

JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for ActOn と統合することで、SQL Object API for ActOn を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムAct-On を操作しましょう。

関連コンテンツ

トライアル・お問い合わせ

30日間無償トライアルで、CData のリアルタイムデータ連携をフルにお試しいただけます。記事や製品についてのご質問があればお気軽にお問い合わせください。