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