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