测试定制 Api

在 Oracle Mobile Hub 中，您可以使用模拟数据在部署定制 api 之前对其进行测试。您还可以使用支持两种模式的测试页来测试 REST 连接器：标准测试和高级测试。

测试 Oracle Mobile Hub 自定义 API

要直接从 Oracle Mobile Hub 测试您的定制 API，请执行以下操作：

登录到 Oracle Mobile Hub。
单击菜单图标，然后展开开开开开发并单击后端。
选择移动后端并单击打开。
单击左侧导航栏中的设置。
从位于环境 URL 下的 SSO 标记端点复制 URL。
将复制的 URL 粘贴到 Web 浏览器窗口中，但不按 Enter 键。
复制位于“OAuth 使用者”部分下的客户机 ID。
向 Web 浏览器中粘贴的 SSO 标记端点 URL 添加查询字符串参数的格式为 ?clientID=[YourClientID]，然后按 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 的默认实现。

单击实施导航链接以上载实施或查看任何现有实施。您可以在“实施”页上更改默认实施。上载实施之后，将看到包括模拟实施的现有实施的列表。

测试 REST 连接器 API

现在您已定义了 REST 连接器 API 并保存了配置，您需要验证是否能够发送请求并从 Web 服务接收预期结果。测试连接是一个可选步骤，但是可以通过在最终确定连接器 API 之前标识并修复问题来节省时间。使用测试页可以一次测试一个端点。

如果提供了描述符，则可以选择两种测试模式：

标准测试

如果提供了描述符元数据，则会显示标准测试模式，在该模式下，请求和响应正文将从描述性元数据生成，并显示在请求和响应选项卡中。只需选择用于 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”字段显示将传递给测试服务的确切字符串。
根据需要添加一个或多个请求或响应 HTTP 标头。

这些标头仅用于测试目的，不会将其添加到 REST Connector API 配置中。
在 HTTP 正文字段中单击可在源编辑器中创建消息正文（有效负载）。
例如：
```
{
  "status":"ZERO_RESULTS",
  "routes":[ ]
}
```
保留与连接器用途相关的消息正文的内容，即，通过添加外来的数据不博客消息。在消息正文中仅包含相关数据可以简化请求或响应的快速传输。
如果要连接的服务需要验证，请打开“验证 ”部分，然后为测试的每个方法输入移动用户身份证明。如果您使用的是默认测试身份证明，则可以跳过此步骤。

对于基于 Saml 的安全策略，进行调用的用户的标识将传播到外部服务。对于其他安全策略（如 HTTP 基本验证和用户名标记），在策略覆盖中提供用于验证外部服务的身份证明作为 CSF 密钥。根据您定义的操作，您可能需要为每个操作输入特定的身份证明，或者您也许可为所有方法使用一组身份证明来验证服务连接器。
单击另存为当前移动后端默认身份证明可保存您作为默认值提供的用户名和口令。
如果您正处于创建连接器的设计阶段，而您只希望查看端点是否有效，请单击默认 API 设计器测试身份证明，然后选择您已注册到的移动后端及其版本号。
可以选择输入移动用户身份证明（用户名和口令）。
这些默认测试身份证明在您测试的所有方法中都是持久性的。它们在当前移动云会话期间保持有效。
单击测试端点。

测试端点将在单击它时切换到“取消测试”。如果希望由于任何原因停止测试，请单击取消测试。

单击重置以清除字段并修改测试参数。
完成测试端点后，单击完成。