JDBI からMicrosoft Exchange データのデータアクセスオブジェクトを作成

JDBI は、Fluent スタイルとSQL オブジェクトスタイルという2つの異なるスタイルAPI を公開する、Java 用のSQL コンビニエンスライブラリです。CData JDBC Driver for Exchange は、Java アプリケーションとリアルタイムMicrosoft Exchange のデータ のデータ連携を実現します。これらの技術を組み合わせることによって、Microsoft Exchange のデータ へのシンプルなコードアクセスが可能になります。ここでは、基本的なDAO（Data Access Object ）とそれに付随するMicrosoft Exchange のデータ の読み書きのためのコードの作成について説明します。

Microsoft Exchange Contacts Entity のDAO を作成

以下のインターフェースは、実装されるSQL ステートメントごとに単一のメソッドを作成するためのSQL オブジェクトの正しい動作を宣言します。

public interface MyContactsDAO {
  //insert new data into Microsoft Exchange
  @SqlUpdate("INSERT INTO Contacts (BusinnessAddress_City, Size) values (:businnessAddress_City, :size)")
  void insert(@Bind("businnessAddress_City") String businnessAddress_City, @Bind("size") String size);

  //request specific data from Microsoft Exchange (String type is used for simplicity)
  @SqlQuery("SELECT Size FROM Contacts WHERE BusinnessAddress_City = :businnessAddress_City")
  String findSizeByBusinnessAddress_City(@Bind("businnessAddress_City") String businnessAddress_City);

  /*
   * close with no args is used to close the connection
   */
  void close();
}

Microsoft Exchange への接続を開く

必要な接続プロパティを収集し、Microsoft Exchange に接続するための適切なJDBC URL を作成します。

Microsoft Exchange への接続

Exchange への接続には2つのスキーマがあります。

• Microsoft Graph
• Exchange Web Services（EWS）（非推奨）
  Note：Microsoft は、Exchange Online ユーザーに対してMicrosoft Graph への切り替えを推奨しています。

Microsoft Graph とEWS を切り替えるには、Schema をMSGraph またはEWS（非推奨）に設定します。

Microsoft Exchange OnPremises への認証

Microsoft Exchange OnPremises は、Basic（デフォルト）、Digest、Negotiate、NTLM 認証をサポートします。

Basic（デフォルト）

Microsoft Exchange OnPremises では、Basic がデフォルトの認証として設定されます。 Basic 認証を使用するには、以下のプロパティを設定します。

• AuthScheme：Basic。
• User：ユーザーのログインID。
• Password：ユーザーのログインパスワード。

他の認証方法については、ヘルプドキュメントの「はじめに」を参照してください。

Microsoft Exchange Online への認証

Microsoft Exchange Online は、複数のOAuth ベースの認証をサポートしています。 Microsoft Graph を介してExchange Online に接続する場合は、Schema をMSGraph に設定します。

認証方法の詳細は、ヘルプドキュメントの「はじめに」を参照してください。

ビルトイン接続文字列デザイナー

JDBC URL の構成については、Microsoft Exchange JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

java -jar cdata.jdbc.exchange.jar

接続プロパティを入力し、接続文字列をクリップボードにコピーします。

Microsoft Exchange の接続文字列は、通常次のようになります。

jdbc:exchange:User='myUser@mydomain.onmicrosoft.com';Password='myPassword';Server='https://outlook.office365.com/EWS/Exchange.asmx';Platform='Exchange_Online';

構成済みのJDBC URL を使用して、DAO インターフェースのインスタンスを取得します。以下に示す特定のメソッドはインスタンスにバインドされたハンドルを開くため、ハンドルとバインドされたJDBC 接続を開放するには、インスタンスを明示的に閉じる必要があります。

DBI dbi = new DBI("jdbc:exchange:User='myUser@mydomain.onmicrosoft.com';Password='myPassword';Server='https://outlook.office365.com/EWS/Exchange.asmx';Platform='Exchange_Online';");
MyContactsDAO dao = dbi.open(MyContactsDAO.class);

//do stuff with the DAO

dao.close();

Microsoft Exchange データについて

Microsoft Exchange への接続を開いた状態で以前定義したメソッドを呼び出すだけで、Microsoft Exchange のContacts エンティティからデータを取得できます。

//disply the result of our 'find' method
String size = dao.findSizeByBusinnessAddress_City("Raleigh");
System.out.println(size);

Microsoft Exchange データの書き方

以前定義した方法を使用すれば、Microsoft Exchange にデータを書き込むことも簡単になります。

//add a new entry to the Contacts entity
dao.insert(newBusinnessAddress_City, newSize);

JDBI ライブラリはJDBC 接続を処理できるため、CData JDBC Driver for Exchange と統合することで、SQL Object API for Exchange を簡単に作成できます。今すぐ無料トライアルをダウンロードし、Java アプリケーションでリアルタイムMicrosoft Exchange を操作しましょう。