設定可能なHTTPクライアントの紹介

RAPID SDKはOkHttpClientの上に構築されており、ユーザーが設定やチューニングを行うことはできません。最近、私たちは HTTPクライアントをあなたのニーズに合わせてチューニングし、最適化する必要性に気づいてきました。そこで、Rapid SDKを使用する開発者に、SDKの基礎となるHTTPクライアントをよりコントロールできるようにするために を使用する開発者に、SDKの基礎となるHTTPクライアントをよりコントロールできるようにするため、SDKが内部で使用する独自のHTTPクライアントを渡すために使用できる新しいビルダーを導入します。 を渡すために使用できる新しいビルダーを導入します。

このビルダーを使用すると、独自の設定で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);