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

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 を使って認証するには、アプリケーションを作成してOAuthClientId、OAuthClientSecret、およびCallbackURL 接続プロパティを取得する必要があります。

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

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

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

java -jar cdata.jdbc.acton.jar

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

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

jdbc:acton:

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

DBI dbi = new DBI("jdbc:acton:");
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 を操作しましょう。