カスタムApiのテスト

Oracle Mobile Hubでは、モック・データを使用してデプロイする前にカスタムapiをテストできます。Standardテストと拡張テストの2つのモードをサポートするテスト・ページを使用して、RESTコネクタをテストすることもできます。

Oracle Mobile HubカスタムAPIのテスト

Oracle Mobile HubからカスタムAPIを直接テストする手順は、次のとおりです。

Oracle Mobile Hubにサインインします。
メニュー・アイコンをクリックし、「開発」を展開して「バックエンド」をクリックします。
モバイル・バックエンドを選択して「Open」をクリックします。
左側のナビゲーション・バーの「設定」をクリックします。
「環境URL」の下にあるSSOトークン・エンドポイントからURLをコピーします。
コピーしたURLをWebブラウザ・ウィンドウに貼り付けますが、[Enter]キーを押しないでください。
「OAuthコンシューマ」セクションにあるクライアントIDをコピーします。
Webブラウザに?clientID=[YourClientID]という形式で貼り付けたSSOトークン・エンドポイントURLに問合せ文字列パラメータを追加して、[Enter]キーを押します。URLの例は、次のとおりです。
```
https://<YourSSOTokenEndpointURL>?clientID=<yourClientID>
```
ブラウザに、シングル・サインオンOAuthトークンが表示されます。
モバイル・バックエンド・ウィンドウで、左側のナビゲーションにある「Api」ページをクリックします。ブラウザが、設定ページからApiページに変わります。
「Apiの選択」をクリックします。
テストするAPI名をクリックします。左側のナビゲーションにAPIエンドポイント、「リクエスト」タブおよび「レスポンス」タブを表示する新しいページが開きます。
テストするエンドポイントをクリックします。
「認証」セクションの下で、「認証メソッド」から「シングル・サインオン・トークン」を選択します。
SSO OAuthトークンをコピーし、「シングル・サインオン・トークン」フィールドに貼り付けます。
「エンドポイントのテスト」をクリックします。すべてが正しい場合、サーバーはステータス200で応答し、応答にJSONデータが表示されます。

モック・データを使用したAPIエンドポイントのテスト

API構成の設計フェーズでは、リクエストおよびレスポンス・メッセージ本文にモック・データを入力できます。これにより、リアルタイムのデータを使用したりリアルタイム・サービスと対話したりすることなく、各コールのコンテキストを確認できます。たとえば、コードが無効なIDを正しく処理するかどうかをテストするには、無効なIDを含むモック・データをリクエスト本文に例を追加します。テストを終了するときに、この例を他のコードと置き換えて、メソッドの他の部分をテストできます。

FixItFastの例では、レスポンス本文のモック・データにより、正しい顧客情報が返されているかどうかを確認できます。次に、サービス開発者がFixItFastの例でcontactリソースのPOST操作のレスポンス本文に対して作成するモック・データの例を示します。

{
 "id": 20934,
 "title": "Lynn's Leaking Water Heater",
       "contact": {
       "name": "Lynn Adams",
       "street": "45 O'Connor Street",
       "city": "Ottawa",
       "postalcode": "ala1a1"
       "username":"johneta"
       }
 "status": "new",
 "driveTime": 30,
 "priority": "high",
 "createdon": "2015-04-23 18:12:03 EDT"
}

カスタムAPIを作成すると、モック実装が自動的に作成されます。モック実装を使用すると、カスタム・コードを実装する前にモバイル・アプリケーションからAPIを起動できます。これにより、モバイル・アプリケーションとカスタム・コードを同時に開発してテストできます。構成に問題がなければ、実際の実装を追加できます。

最初の実装を作成するまで、デフォルトの実装はモック実装です。実際の実装を作成すると、APIのデフォルトの実装になります。

「実装」ナビゲーション・リンクをクリックして、実装をアップロードするか、既存の実装を表示します。Implementationsページで、デフォルト実装を変更できます。実装をアップロードすると、モック実装を含む既存の実装のリストが表示されます。

RESTコネクタAPIのテスト

REST Connector APIを定義し、構成を保存したので、リクエストを送信してWebサービスから予想される結果を受信できることを確認する必要があります。接続のテストはオプションのステップですが、コネクタAPIをファイナライズする前に現在問題を特定して修正することで時間を節約できます。「テスト」ページでは、一度に1つのエンドポイントをテストできます。

記述子を指定した場合、次の中から選択する2つのテスト・モードがあります。

Standardテスト

記述子メタデータを指定した場合は、標準テスト・モードが表示されます。このモードでは、リクエストとレスポンスの本文が記述メタデータから生成され、「リクエスト」および「レスポンス」タブに表示されます。実行する必要があるのは、GETメソッドを使用してテストするパラメータを選択し、テストするHTTPヘッダーを含めます。
拡張テスト

詳細モードでのテスト(リモート・サービスURLを指定した場合に入力するテスト・モード )を選択して、テストを絞り込むことができます。記述メタデータを使用しない場合、テストするメソッドおよびリソースを選択し、含めるHTTPヘッダーを含め、JSON本体を手動で作成します。

拡張モードでのテスト

拡張テスト・ページでは、パス・パラメータ、ヘッダー、リクエストおよびレスポンス・ペイロードを手動で設定できます。

コネクタ・テストを手動で構成する手順は、次のとおりです。

「テスト」ナビゲーション・リンクをクリックします。
ディスクリプタを指定した場合、「拡張モードでテスト」をOnに設定します。

リモート・サービスUrlを指定すると、「詳細テスト」ページが自動的に表示されます。
ドロップダウン・リストから、テストするHTTPメソッドを選択します。
テストの目的で必要に応じて「ローカルURI」フィールドにリソース・パスのパラメータを指定します。次に例を示します。
```
directions/json?origin=los+angeles&destination=seattle
```
API名を入力すると、フィールドには、定義したローカルURIが自動的に接頭辞として付加されます。次の例では、フィールドのすべての内容は次のようになります。
```
myMapAPI /directions/json?origin=los+angeles&destination=seattle
```
定義したルールがある場合、「適用されたルール」フィールド(「本文」フィールドの下)には、選択した操作に適用可能なルールに対応する数字が表示されます。「リモートURL」フィールドには、テストのためにサービスに渡される正確な文字列が表示されます。
必要に応じて、1つまたは複数のリクエスト/レスポンスHTTPヘッダーを追加します。

これらのヘッダーはテスト目的専用で、RESTコネクタAPI構成には追加されません。
「HTTP本文」フィールドをクリックして、ソース・エディタでメッセージ本文(ペイロード)を作成します。
次に例を示します。
```
{
  "status":"ZERO_RESULTS",
  "routes":[ ]
}
```
コネクタの目的に関連するメッセージ本文の内容を保持します。つまり、無関係なデータを追加してメッセージを無視しないでください。メッセージ本文に関連するデータのみを含めると、リクエストまたはレスポンスを迅速に送信できます。
接続しているサービスが認証を必要とする場合は、「認証」セクションを開き、テストする方法ごとにモバイル・ユーザー資格証明を入力します。デフォルトのテスト資格証明を使用している場合は、このステップをスキップできます。

Samlベースのセキュリティ・ポリシーでは、コール元のユーザーのアイデンティティが外部サービスに伝播されます。HTTP Basic認証やユーザー名トークンなど、他のセキュリティ・ポリシーの場合、外部サービスで認証するために使用される資格証明が、CSFキーとしてポリシー・オーバーライドで提供されます。定義した操作によっては、操作ごとに特定の資格証明を入力する必要がある場合や、すべてのメソッドに対して1セットの資格証明を使用して、コネクタをサービスとともに認証できる場合もあります。
現在のモバイル・バックエンドのデフォルトの資格証明として保存をクリックして、デフォルトとして指定するユーザー名とパスワードを保存します。
コネクタの作成の設計フェーズにいるときに、エンドポイントが有効かどうかを確認するだけの場合は、デフォルトAPIデザイナのテスト資格証明をクリックし、登録しているモバイル・バックエンドとそのバージョン番号を選択します。
必要に応じて、モバイル・ユーザー資格証明(ユーザー名およびパスワード)を入力できます。
これらのデフォルトのテスト資格証明は、テスト対象のすべてのメソッドで永続的です。これらは、現在のモバイル・クラウド・セッション中も有効です。
「エンドポイントのテスト」をクリックします。

テスト・エンドポイントは、クリックすると「テストの取消」に切り替わります。なんらかの理由でテストを停止する場合は、「テストの取消」をクリックします。

フィールドをクリアし、テスト・パラメータを変更するには、「リセット」をクリックします。
エンドポイントのテストが完了したら、「完了」をクリックします。