測試自訂 Api

Oracle Mobile Hub 中,您可以使用模擬資料來測試自訂 api,然後再進行部署。您也可以使用支援兩種模式的測試頁面來測試您的 REST 連線器:「標準測試」以及「進階測試」。

測試 Oracle Mobile Hub 自訂 API

直接從 Oracle Mobile Hub 測試您的自訂 API:

  1. 登入 Oracle Mobile Hub
  2. 按一下功能表圖示,然後展開開開開,再按一下後端
  3. 選取您的行動後端,然後按一下「開啟」。
  4. 按一左邊導覽列中的設定值。
  5. 從「環境 URL」底下的「SSO 權杖端點」複製 URL
  6. 將複製的 URL 貼到 Web 瀏覽器視窗,但不要按 Enter 鍵。
  7. 複製您在「OAuth 用戶」段落下的從屬端 ID。
  8. 查詢字串參數新增至您在Web瀏覽器中貼上之SSO記號端點URL的格式? clientID = [YourClientID] ,然後按Enter鍵。URL 的範例如下:
    https://<YourSSOTokenEndpointURL>?clientID=<yourClientID>
    瀏覽器將會顯示單一登入 OAuth Token。
  9. 在您的行動後端視窗中,按一下位於左側導覽中的 Api 頁面。瀏覽器會從「設定值」頁面變更為 Api 頁面。
  10. 按一下選取 Api
  11. 按一下您要測試的 API 名稱。就會開啟一個新頁面,在左邊的導覽以及「要求」和「回應」頁籤中顯示 API 端點。
  12. 按一下要測試的端點。
  13. 在「認證」段落下,從認證方法選取單一登入記號
  14. 複製您的 SSO OAuth Token,然後貼到 Single Sign-On 記號欄位。
  15. 按一下測試端點。如果一切正確,伺服器會回應狀態 200,而且回應中應會有 JSON 資料。

使用 Mock 資料測試 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 的預設實行。

按一下實導覽連結即可上傳實行,或查看任何現有的實行。您可以在實行頁面上變更預設實行。上傳實行之後,您會看到包含模擬實行的現有實行清單。

測試 REST 連線器 API

現在您已經定義 REST Connector API 並儲存組態,您將會想要驗證是否可以傳送要求,並從 Web 服務收到預期的結果。測試連線是選擇性步驟,但是在您完成連線器 API 之前,現在可以識別並修正問題來節省時間。測試頁可讓您一次測試一個端點。

如果您提供描述區,可以選擇兩個測試模式:

  • 標準測試

    如果您提供描述區描述資料,則會顯示標準測試模式,而要求和回應主體會從描述資料產生並顯示在「要求」和「回應」頁籤中。您只要選取參數,即可使用 GET 方法進行測試,並包括所有要測試的 HTTP 標頭。

  • 進階測試

    您可以選取進階模式測試 (如果提供遠端服務 URL,您所輸入的測試模式) 來重新定義測試。如果沒有描述性描述資料,您可以選取要測試的方法和資源,包括要包括的所有 HTTP 標頭,然後手動建立 JSON 主體。

進階模式測試

進階測試頁面可讓您手動設定路徑參數、新增標頭以及要求和回應有效負載。

手動設定連線器測試:

  1. 按一下測試導覽連結。
  2. 如果提供描述區,請將「進階模式」中的測試切換為 On

    如果您提供遠端服務 Url,會自動顯示進階測試頁面。

  3. 從下拉式清單中選取您要測試的 HTTP 方法。
  4. 請視需要在「本機 URI」欄位中指定任何資源路徑參數,以進行測試。例如:
    directions/json?origin=los+angeles&destination=seattle

    此欄位會自動加上您在輸入 API 名稱時所定義之本機 URI 的前置碼。依照我們的範例,欄位的完整內容看起來如下:

    myMapAPI /directions/json?origin=los+angeles&destination=seattle

    請注意,如果您已定義任何規則,套用的規則欄位 (位於「主體」欄位下方) 會顯示對應至所選作業適用之規則的數字。「遠端 URL」欄位會顯示要傳遞給用於測試之服務的確切字串。

  5. 視需要新增一或多個要求或回應 HTTP 標頭。

    這些標頭僅供測試之用,不會新增至您的 REST Connector API 組態。

  6. 按一下「HTTP 主體」欄位即可在來源編輯器中建立訊息主體 (有效負載)。
    例如:
    {
      "status":"ZERO_RESULTS",
      "routes":[ ]
    }

    保留與連線器用途相關的訊息主體內容,亦即不會新增無關資料來部分訊息。在訊息正文中只加入相關資料可快速傳輸要求或回應。

  7. 如果您所連線的服務需要認證,請開啟認證段落,然後為您測試的每個方法輸入您的行動使用者證明資料。如果您使用預設的測試證明資料,可以略過此步驟。

    使用以 Saml 為基礎的安全原則時,會將進行呼叫之使用者的識別傳輸到外部服務。對於其他安全原則 (例如 HTTP 基本認證和使用者名稱記號),在原則覆寫中會提供用於對外部服務進行認證的證明資料,作為 CSF 金鑰。視您定義的作業而定,您可能需要為每項作業輸入特定的證明資料,或是所有方法都可以使用一組證明資料來向服務認證連線器。

  8. 按一下另存為目前的行動後端預設證明資料,即可儲存您提供作為預設值的使用者名稱和密碼。
  9. 如果您位於建立連線器的設計階段,而您只想要查看端點是否有效,請按一下預設 API 設計工具測試證明資料,然後選取您已註冊且其版本號碼的行動後端。
    您也可以視情況輸入您的行動使用者證明資料 (使用者名稱和密碼)。

    這些預設的測試證明資料是您測試之所有方法的持續性證明資料。它們在目前的行動雲端階段作業期間仍然有效。

  10. 按一下測試端點

    當您按一下測試時,「測試端點」就會切換為取消測試。如果您想停止測試原因,請按一下取消測試

    按一下重設可清除欄位並修改測試參數。

  11. 完成測試您的端點之後,請按一下完成。