JDBI からSAP Netweaver Gateway データのデータアクセスオブジェクトを作成

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

SAP Netweaver Gateway SalesOrderLineItems Entity のDAO を作成

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

public interface MySalesOrderLineItemsDAO {
  //insert new data into SAP Netweaver Gateway
  @SqlUpdate("INSERT INTO SalesOrderLineItems (Quantity, Quantity) values (:quantity, :quantity)")
  void insert(@Bind("quantity") String quantity, @Bind("quantity") String quantity);

  //request specific data from SAP Netweaver Gateway (String type is used for simplicity)
  @SqlQuery("SELECT Quantity FROM SalesOrderLineItems WHERE Quantity = :quantity")
  String findQuantityByQuantity(@Bind("quantity") String quantity);

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

SAP Netweaver Gateway への接続を開く

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

SAP Gateway 接続プロパティの取得・設定方法

SAP Gateway のテーブルにアクセスするには、次の接続プロパティを設定します。

• URL = お使いの環境のURL、またはサービスの完全URL。例えば、完全URL は次のようになります：https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/。この例では、環境URL は次のようになります：https://sapes5.sapdevcenter.com。CustomUrlParams プロパティを使用して、追加プロパティを追加します。
• Namespace = 適切なService Namespace。先ほどの例では、IWBEP が名前空間です。サービスへの完全URL が指定されている場合は任意です。
• Service = データを取得するサービス。先ほどの例では、サービスはGWSAMPLE_BASIC です。完全URL が指定されている場合は必須ではありません。
• CustomUrlParams = HTTP リクエストに含まれる必要のある追加プロパティ；例えばsap-client=001&sap-language=EN。

SAP Gateway への認証

SAP Gateway はBasic 認証、OAuth 2.0 認証、SAP BTP Destination 認証を許可します。

Basic 認証

Basic 認証を有効にするには、以下のプロパティを設定します。

• AuthScheme = Basic。
• User = SAP Gateway へのログインに使用するユーザー名。
• Password = SAP Gateway へのログインに使用するパスワード。

上記のプロパティを設定したら、接続の準備は完了です。ローカルデータにアクセスするには、個人の認証情報を使用します。

他の認証方法については、ヘルプドキュメントの「接続の確立」セクションを参照してください。

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

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

java -jar cdata.jdbc.sapgateway.jar

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

SAP Netweaver Gateway の接続文字列は、通常次のようになります。

jdbc:sapgateway:User=user;Password=password;URL=https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/;

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

DBI dbi = new DBI("jdbc:sapgateway:User=user;Password=password;URL=https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/;");
MySalesOrderLineItemsDAO dao = dbi.open(MySalesOrderLineItemsDAO.class);

//do stuff with the DAO

dao.close();

SAP Netweaver Gateway データについて

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

//disply the result of our 'find' method
String quantity = dao.findQuantityByQuantity("15");
System.out.println(quantity);

SAP Netweaver Gateway データの書き方

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

//add a new entry to the SalesOrderLineItems entity
dao.insert(newQuantity, newQuantity);

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