各製品の資料を入手。
詳細はこちら →
製品をチェック
JDBI からOData Services のデータアクセスオブジェクトを作成
JDBI でOData のデータ 用のSQL オブジェクトAPIを作成する方法を概説します。
最終更新日：2022-05-25
この記事で実現できるOData 連携のシナリオ
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for OData は、Java アプリケーションとリアルタイムOData のデータ のデータ連携を実現します。これらの技術を組み合わせることによって、OData のデータ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO（Data Access Object ）とそれに付随するOData のデータ の読み書きのためのコードの作成について説明します。
OData Orders Entity のDAO を作成
以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。
public interface MyOrdersDAO {
//insert new data into OData
@SqlUpdate("INSERT INTO Orders (ShipCity, Freight) values (:shipCity, :freight)")
void insert(@Bind("shipCity") String shipCity, @Bind("freight") String freight);
//request specific data from OData (String type is used for simplicity)
@SqlQuery("SELECT Freight FROM Orders WHERE ShipCity = :shipCity")
String findFreightByShipCity(@Bind("shipCity") String shipCity);
/*
* close with no args is used to close the connection
*/
void close();
}
OData への接続を開く
必要な接続プロパティを収集し、OData に接続するための適切なJDBC URL を作成します。
OData への接続
OData に接続するには、Url を有効なOData サービスルートURI に設定する必要があります。 OData サービスにルートドキュメントがない場合、テーブルとして公開したい特定のエンティティをFeedURL に指定してください。
OData への認証
OData は、以下を経由する認証をサポートします。
- HTTP
- Kerberos
- SharePoint Online
- OAuth
- Azure AD
HTTP 認証スキーム
HTTP で認証する場合は、次の表に従ってAuthScheme を設定します。
| Scheme | AuthScheme | その他の設定 |
| None | None | 認証を必要としない場合に使用。 |
| Basic | Basic | User、Password |
| NTLM | NTLM | User、Password |
| Digest（サポートされている場合） | Digest | User、Password |
その他の認証方法の詳細は、ヘルプドキュメントの「接続の確立」セクションを参照してください。
ビルトイン接続文字列デザイナー
JDBC URL の構成については、OData JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。
java -jar cdata.jdbc.odata.jar
接続プロパティを入力し、接続文字列をクリップボードにコピーします。
OData の接続文字列は、通常次のようになります。
jdbc:odata:URL=http://services.odata.org/V4/Northwind/Northwind.svc;UseIdUrl=True;OData Version=4.0;Data Format=ATOM;
構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。
DBI dbi = new DBI("jdbc:odata:URL=http://services.odata.org/V4/Northwind/Northwind.svc;UseIdUrl=True;OData Version=4.0;Data Format=ATOM;");
MyOrdersDAO dao = dbi.open(MyOrdersDAO.class);
//do stuff with the DAO
dao.close();
OData Services について
OData への接続を開いた状態で以前定義したメソッドを呼び出すだけで、OData のOrders エンティティからデータを取得できます。
//disply the result of our 'find' method
String freight = dao.findFreightByShipCity("New York");
System.out.println(freight);
OData Services の書き方
以前定義した方法を使用すれば、OData にデータを書き込むことも簡単になります。
//add a new entry to the Orders entity
dao.insert(newShipCity, newFreight);
JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for OData と統合することで、SQL Object API for OData を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムOData を操作しましょう。
関連コンテンツ
