JDBI でQuickBase data 用のSQL オブジェクトAPIを作成する方法を概説します。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for QuickBase は、Java アプリケーションとリアルタイムQuickBase data のデータ連携を実現します。これらの技術を組み合わせることによって、QuickBase data へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するQuickBase data の読み書きのためのコードの作成について説明します。
QuickBase SampleTable_1 Entity のDAO を作成
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MySampleTable_1DAO {
//insert new data into QuickBase
@SqlUpdate("INSERT INTO SampleTable_1 (Column2, Column1) values (:column2, :column1)")
void insert(@Bind("column2") String column2, @Bind("column1") String column1);
//request specific data from QuickBase (String type is used for simplicity)
@SqlQuery("SELECT Column1 FROM SampleTable_1 WHERE Column2 = :column2")
String findColumn1ByColumn2(@Bind("column2") String column2);
/*
* close with no args is used to close the connection
*/
void close();
}
QuickBase への接続を開く
必要な接続プロパティを収集し、QuickBase に接続するための適切なJDBC URL を作成します。
User Authentication Method
To authenticate with user credentials, specify the following connection properties:
- Set the User and Password.
- If your application requires an ApplicationToken;, you must provide it otherwise an error will be thrown. You can find the ApplicationToken under SpecificApp > Settings > App management > App properties > Advanced settings > Security options > Manage Application Token.
User Token Authentication
To authenticate with a user token, specify the following connection properties:
- Set UserToken and you are ready to connect. You can find the UserToken under Quick Base > My Preferences > My User Information > Manage User Tokens.
ビルトイン接続文字列デザイナー
JDBC URL の構成については、QuickBase JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.quickbase.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。

QuickBase の接続文字列は、通常次のようになります。
jdbc:quickbase:User=user@domain.com;Password=password;Domain=myinstance.quickbase.com;ApplicationToken=bwkxrb5da2wn57bzfh9xn24
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:quickbase:User=user@domain.com;Password=password;Domain=myinstance.quickbase.com;ApplicationToken=bwkxrb5da2wn57bzfh9xn24");
MySampleTable_1DAO dao = dbi.open(MySampleTable_1DAO.class);
//do stuff with the DAO
dao.close();
QuickBase Data について
QuickBase への接続を開いた状態で以前定義したメソッドを呼び出すだけで、QuickBase のSampleTable_1 エンティティからデータを取得できます。
//disply the result of our 'find' method
String column1 = dao.findColumn1ByColumn2("100");
System.out.println(column1);
QuickBase Data の書き方
以前定義した方法を使用すれば、QuickBase にデータを書き込むことも簡単になります。
//add a new entry to the SampleTable_1 entity
dao.insert(newColumn2, newColumn1);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for QuickBase と統合することで、SQL Object API for QuickBase を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでライブQuickBase を操作しましょう。