本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for Reckon は、Java アプリケーションとリアルタイムReckon data のデータ連携を実現します。これらの技術を組み合わせることによって、Reckon data へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するReckon data の読み書きのためのコードの作成について説明します。
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyCustomersDAO {
//insert new data into Reckon
@SqlUpdate("INSERT INTO Customers (Type, CustomerBalance) values (:type, :customerBalance)")
void insert(@Bind("type") String type, @Bind("customerBalance") String customerBalance);
//request specific data from Reckon (String type is used for simplicity)
@SqlQuery("SELECT CustomerBalance FROM Customers WHERE Type = :type")
String findCustomerBalanceByType(@Bind("type") String type);
/*
* close with no args is used to close the connection
*/
void close();
}
必要な接続プロパティを収集し、Reckon に接続するための適切なJDBC URL を作成します。
ローカルReckon インスタンスに接続する場合は、接続プロパティを設定する必要はありません。
本製品は、リモートコネクタ経由でReckon にリクエストを作成します。Remote Connector はReckon と同じマシン上で動作し、軽量の組み込みWeb サーバーを介して接続を受け入れます。サーバーはSSL/TLS をサポートし、ユーザーにリモートマシンからのセキュアな接続を可能にします。
初めて組織ファイルに接続するときは、リモートコネクタをReckon で認可する必要があります。詳細はヘルプドキュメントの「はじめに」を参照してください。
JDBC URL の構成については、Reckon JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.reckon.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
Reckon の接続文字列は、通常次のようになります。
jdbc:reckon:User=RCUser;Password=RCUserPassword;URL=http://remotehost:8166;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:reckon:User=RCUser;Password=RCUserPassword;URL=http://remotehost:8166;");
MyCustomersDAO dao = dbi.open(MyCustomersDAO.class);
//do stuff with the DAO
dao.close();
Reckon への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Reckon のCustomers エンティティからデータを取得できます。
//disply the result of our 'find' method
String customerBalance = dao.findCustomerBalanceByType("Commercial");
System.out.println(customerBalance);
以前定義した方法を使用すれば、Reckon にデータを書き込むことも簡単になります。
//add a new entry to the Customers entity
dao.insert(newType, newCustomerBalance);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for Reckon と統合することで、SQL Object API for Reckon を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでライブReckon を操作しましょう。