自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

RestApiHelper

public class RestApiHelper
extends Object implements IRestApiHelper

java.lang.Object
↳	com.android.tradefed.util.RestApiHelper

用于执行 REST API 调用的辅助类。

摘要

常量
`int`	`DEFAULT_NUMBER_OF_RETRIES`

字段
`protected static final JsonFactory`	`JSON_FACTORY`
`protected static final String`	`JSON_MIME`

公共构造函数
`RestApiHelper(HttpRequestFactory requestFactory, String baseUri)` 使用给定信息创建 API 辅助程序实例。

公共方法
`GenericUrl`	`buildQueryUri(String[] uriParts, options)` 使用给定的 URI 部分和选项为 API 调用构建 URI。
`HttpResponse`	`execute(String method, String[] uriParts, options, JSONObject data)` 执行 API 请求。
`HttpRequestFactory`	`getRequestFactory()` 返回 HttpRequestFactory。
`static RestApiHelper`	`newInstanceWithGoogleCredential(String baseUri, File jsonKeyFile, scopes)` 创建一个 API 帮助程序实例，该实例使用 `Credential` 进行身份验证。

protected static final int DEFAULT_NUMBER_OF_RETRIES

常量值： 2 (0x00000002)

protected static final JsonFactory JSON_FACTORY

protected static final String JSON_MIME

public RestApiHelper (HttpRequestFactory requestFactory, 
                String baseUri)

使用给定信息创建 API 辅助程序实例。

参数
`requestFactory`	`HttpRequestFactory`：创建 `HttpRequest` 时要使用的工厂。
`baseUri`	`String`：API 的基本 URI

public GenericUrl buildQueryUri (String[] uriParts, 
                 options)

使用给定的 URI 部分和选项为 API 调用构建 URI。uriParts 应已进行网址编码，而 options 应为未编码的字符串。

参数
`uriParts`	`String`
`options`

返回
`GenericUrl`

public HttpResponse execute (String method, 
                String[] uriParts, 
                 options, 
                JSONObject data)

执行 API 请求。

参数
`method`	`String`：请求的 HTTP 方法
`uriParts`	`String`：用于构建请求 URI 的网址编码 URI 部分。
`options`	：用于构建查询字符串的未编码参数名称和值
`data`	`JSONObject`：要随请求一起发送的数据

返回
`HttpResponse`	HttpResponse 对象

public HttpRequestFactory getRequestFactory ()

返回 HttpRequestFactory。

公开以供测试。

返回
`HttpRequestFactory`

public static RestApiHelper newInstanceWithGoogleCredential (String baseUri, 
                File jsonKeyFile, 
                 scopes)

创建一个 API 帮助程序实例，该实例使用 Credential 进行身份验证。

返回
`RestApiHelper`

抛出
	GeneralSecurityException
	IOException