可配置的 HTTP 用戶端
簡介
Rapid SDK 使用底層 HTTP 用戶端來執行 API 呼叫。為了讓開發人員更好地控制 HTTP 用戶端，我們提供了一個建構器，可用於傳遞您自己的 HTTP 用戶端供 SDK 使用。使用此建構器，您可以根據自己的配置建立 HTTP 用戶端並將其傳遞給 SDK，甚至可以傳遞您已經在應用程式中使用的用戶端。
注意
此功能可在 rapid-sdk v5.3.1 及更高版本中使用。
配置 HTTP 用戶端與使用預設客戶端
使用提供的預設客戶端是開始使用 SDK 的最簡單方法。但是，配置您自己的 HTTP 用戶端將在以下方面為您帶來好處：
- **最佳化：**微調客戶端以獲得更好的效能，例如連線池、逾時和重試。
- **整合：**使用已在您的應用程式中設定和測試的現有 HTTP 用戶端。
因此，如果您希望優化 SDK 以獲得更好的效能或將其與現有的 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()
.okHttpClient(customClient)
.key("YOUR_API_KEY")
.secret("YOUR_API_SECRET")
.build();3.使用配置好的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);