可配置 HTTP 客户端介绍

RAPID SDK 构建在 OkHttpClient 的基础上,不开放供您配置和调整。最近,我们意识到 最近,我们意识到需要根据自己的需要调整和优化 HTTP 客户端。因此,为了让使用 Rapid SDK 的开发人员 底层 HTTP 客户端的更多控制权,我们引入了一个新的构建器,您可以使用它来传递您自己的 自己的 HTTP 客户端供 SDK 内部使用。

使用该构建器,您可以用自己的配置构建 HTTP 客户端并将其传递给 SDK,甚至可以将您应用程序中已经使用的 客户端。

Information

注意

该功能在rapid-sdk v5.2.0 及更高版本中可用。

在配置 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);
您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!