사용자정의 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을 웹 브라우저 창에 붙여넣지만 Enter 키를 누르지 마십시오.
  7. OAuth 소비자 섹션 아래에 있는 클라이언트 ID를 복사합니다.
  8. 웹 브라우저에서 ?clientID=[YourClientID] 형식으로 붙여넣은 SSO 토큰 끝점 URL에 질의 문자열 매개변수를 추가한 다음 Enter 키를 누릅니다. URL의 예는 다음과 같습니다.
    https://<YourSSOTokenEndpointURL>?clientID=<yourClientID>
    브라우저에 Single Sign-On OAuth 토큰이 표시됩니다.
  9. 모바일 백엔드 창에서 왼쪽 탐색에 있는 Api 페이지를 누릅니다. 브라우저는 [설정 ] 페이지에서 Api 페이지로 변경됩니다.
  10. Api 선택 을 누릅니다.
  11. 테스트할 API 이름을 누릅니다. 왼쪽 탐색 및 [요청 ] 및 [응답 ] 탭에 API 끝점을 표시하는 새 페이지가 열립니다.
  12. 테스트할 끝점을 누릅니다.
  13. 인증 섹션의 인증 방식 에서 Single Sign-On 토큰 을 선택합니다.
  14. SSO OAuth 토큰을 복사하여 Single Sign-On 토큰 필드에 붙여 넣습니다.
  15. 끝점 테스트 를 누릅니다. 모든 항목이 올바르면 서버가 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에 대한 기본 구현이 됩니다.

구현 탐색 링크를 눌러 구현을 업로드하거나 기존 구현을 확인합니다. [구현] 페이지에서 기본 구현을 변경할 수 있습니다. 구현을 업로드한 후에는 모의 구현을 포함하는 기존 구현 목록이 표시됩니다.

REST 커넥터 API 테스트

이제 REST 커넥터 API를 정의하고 구성을 저장했으므로 요청을 전송하고 웹 서비스에서 예상한 결과를 수신할 수 있는지 확인할 수 있습니다. 접속 테스트는 선택적 단계이지만 커넥터 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 커넥터 API 구성에 추가되지 않습니다.

  6. 소스 편집기에서 메시지 본문(페이로드) 을 생성하려면 HTTP 본문 필드를 누릅니다.
    예를 들어, 다음과 같습니다.
    {
      "status":"ZERO_RESULTS",
      "routes":[ ]
    }

    커넥터 목적과 관련된 메시지 본문 내용을 유지합니다. 즉, 불필요한 데이터를 추가하여 메시지를 중단하지 마십시오. 메시지 본문에 관련 데이터만 포함되면 요청 또는 응답을 빠르게 전송할 수 있습니다.

  7. 접속 중인 서비스에 인증이 필요한 경우 인증 섹션을 열고 테스트하는 각 방법에 대한 모바일 사용자 인증서를 입력합니다. 기본 테스트 인증서를 사용 중인 경우 이 단계를 건너뛸 수 있습니다.

    Saml 기반 보안 정책을 사용하면 호출을 수행하는 사용자의 id가 외부 서비스로 전달됩니다. HTTP 기본 인증 및 사용자 이름 토큰과 같은 기타 보안 정책의 경우 외부 서비스로 인증에 사용되는 인증서가 CSF 키로 정책에서 무효화됩니다. 정의한 작업에 따라 각 작업에 대해 특정 인증서를 입력해야 할 수도 있고, 모든 메소드에 대해 하나의 인증서 집합을 사용하여 서비스로 커넥터를 인증할 수도 있습니다.

  8. 기본값으로 제공하는 사용자 이름 및 비밀번호를 저장하려면 현재 모바일 백엔드 기본 인증서로 저장 을 누릅니다.
  9. 커넥터 생성의 디자인 단계에 있으며 끝점이 적합한지 보려면 기본 API 디자이너 테스트 인증서 를 누르고 등록된 모바일 백엔드와 해당 버전 번호를 선택하십시오.
    선택적으로 모바일 사용자 인증서(사용자 이름 및 비밀번호) 를 입력할 수 있습니다.

    이러한 기본 테스트 인증서는 테스트하는 모든 방법에 걸쳐 지속됩니다. 현재 모바일 클라우드 세션 동안 유효합니다.

  10. 끝점 테스트 를 누릅니다.

    [테스트 끝점 ] 토글은 누르면 [테스트 취소 ] 로 전환됩니다. 어떤 이유로 테스트를 정지하려면 테스트 취소 를 누릅니다.

    필드를 지우고 테스트 매개변수를 수정하려면 재설정 을 누릅니다.

  11. 끝점 테스트가 완료되면 완료 를 누릅니다.