ノーコードでクラウド上のデータとの連携を実現。
詳細はこちら →CData
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for HubDB は、Java アプリケーションとリアルタイムHubDB データ のデータ連携を実現します。これらの技術を組み合わせることによって、HubDB データ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO(Data Access Object )とそれに付随するHubDB データ の読み書きのためのコードの作成について説明します。
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyNorthwindProductsDAO {
//insert new data into HubDB
@SqlUpdate("INSERT INTO NorthwindProducts (Id, Name) values (:id, :name)")
void insert(@Bind("id") String id, @Bind("name") String name);
//request specific data from HubDB (String type is used for simplicity)
@SqlQuery("SELECT Name FROM NorthwindProducts WHERE Id = :id")
String findNameById(@Bind("id") String id);
/*
* close with no args is used to close the connection
*/
void close();
}
必要な接続プロパティを収集し、HubDB に接続するための適切なJDBC URL を作成します。
HubDBデータソースへの接続には、パブリックHubSpotアプリケーションを使用したOAuth認証とプライベートアプリケーショントークンを使用した認証の2つの方法があります。
すべてのOAuthフローでAuthSchemeを"OAuth"に設定する必要があります。特定の認証ニーズ(デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン)に必要な接続プロパティについては、ヘルプドキュメントを確認してください。
アプリケーションを登録し、OAuthクライアント認証情報を取得するには、以下の手順を実行してください。
スコープの下で、アプリケーションの意図する機能に必要なスコープを選択します。
テーブルにアクセスするには、最低限以下のスコープが必要です:
HubSpotプライベートアプリケーショントークンを使用して接続するには、AuthSchemeプロパティを"PrivateApp"に設定します。
以下の手順に従ってプライベートアプリケーショントークンを生成できます:
接続するには、PrivateAppTokenを取得したプライベートアプリケーショントークンに設定します。
JDBC URL の構成については、HubDB JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.hubdb.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
HubDB の接続文字列は、通常次のようになります。
jdbc:hubdb:AuthScheme=OAuth;OAuthClientID=MyOAuthClientID;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;InitiateOAuth=GETANDREFRESH
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:hubdb:AuthScheme=OAuth;OAuthClientID=MyOAuthClientID;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;InitiateOAuth=GETANDREFRESH");
MyNorthwindProductsDAO dao = dbi.open(MyNorthwindProductsDAO.class);
//do stuff with the DAO
dao.close();
HubDB への接続を開いた状態で以前定義したメソッドを呼び出すだけで、HubDB のNorthwindProducts エンティティからデータを取得できます。
//disply the result of our 'find' method
String name = dao.findNameById("1");
System.out.println(name);
以前定義した方法を使用すれば、HubDB にデータを書き込むことも簡単になります。
//add a new entry to the NorthwindProducts entity
dao.insert(newId, newName);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for HubDB と統合することで、SQL Object API for HubDB を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムHubDB を操作しましょう。