可配置 HTTP 客户端介绍
RAPID SDK 构建在 OkHttpClient 的基础上,不开放供您配置和调整。最近,我们意识到 最近,我们意识到需要根据自己的需要调整和优化 HTTP 客户端。因此,为了让使用 Rapid SDK 的开发人员 底层 HTTP 客户端的更多控制权,我们引入了一个新的构建器,您可以使用它来传递您自己的 自己的 HTTP 客户端供 SDK 内部使用。
使用该构建器,您可以用自己的配置构建 HTTP 客户端并将其传递给 SDK,甚至可以将您应用程序中已经使用的 客户端。
在配置 HTTP 客户端和使用默认客户端之间做出选择
使用 SDK 提供的默认客户端是开始使用 SDK 的最简单方法。不过,配置自己的 自己的 HTTP 客户端会有以下好处:
- 优化: Fine-tune 客户端,以提高性能,如连接池、超时和重试。
- 集成: 使用已在应用程序中配置和测试过的现有 HTTP 客户端。
因此,如果您想优化 SDK 以获得更好的性能,或将其与现有 HTTP 客户端集成,那么配置您自己的 HTTP 客户端才是王道。 配置自己的 HTTP 客户端。
如何配置 HTTP 客户端?
要配置 HTTP 客户端,需要创建OkHttpClient
实例并将其传递给RapidClient
生成器。
1.使用您的配置创建OkHttpClient
实例。您可以使用现有实例或创建新实例。例如:
OkHttpClient customClient = new OkHttpClient.Builder()
.connectTimeout(30, TimeUnit.SECONDS)
.readTimeout(30, TimeUnit.SECONDS)
.writeTimeout(30, TimeUnit.SECONDS)
.build();
有关配置OkHttpClient
的详细信息,请参阅OkHttp 文档。
2.将OkHttpClient
实例传递给RapidClient
生成器 builderWithHttpClient
RapidClient rapidClient = RapidClient.builderWithHttpClient()
.key("YOUR_API_KEY")
.secret("YOUR_API_SECRET")
.okHttpClient(customClient)
.build();
3.进行 API 调用:使用配置的 rapidClient 像往常一样进行 API 调用
GetAvailabilityOperationParams getAvailabilityOperationParams = GetAvailabilityOperationParams.builder()
.checkin("YYYY-MM-DD")
.checkout("YYYY-MM-DD")
.currency("USD")
.language("en_US")
/* ... */
.build();
GetAvailabilityOperation operation = new GetAvailabilityOperation(params);
Response<List<Property>> response = rapidClient.execute(operation);