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