Cliente HTTP configurable

Información general

El Rapid SDK usa un cliente HTTP subyacente para realizar llamadas a la API. Para que los desarrolladores tengan Más control sobre el cliente HTTP, se incluye un generador que te permite pasar tu propio cliente HTTP para que lo utilice el SDK. Con este generador, puedes crear un cliente HTTP con tus propias configuraciones y pasárselo al SDK, o incluso pasar un cliente que ya estés utilizando en tu aplicación.

Configurar un cliente HTTP frente a usar el cliente predeterminado

Usar el cliente predeterminado que viene incluido es la forma más fácil de empezar a usar el SDK. Sin embargo, configurar tu propio cliente HTTP te aportará las siguientes ventajas: Te permitirá:

• Optimización: Fine-tune el cliente para mejorar el rendimiento, por ejemplo, mediante el uso de grupos de conexiones, tiempos de espera y reintentos.
• Integración: Usa un cliente HTTP ya existente que esté configurado y probado dentro de tu aplicación.

Así que, si quieres optimizar el SDK para que funcione mejor o integrarlo con un cliente HTTP que ya tengas, lo mejor es que configures Tu propio cliente HTTP.

Cómo configurar tu cliente HTTP

Para configurar tu cliente HTTP, tienes que crear una instancia de OkHttpClient y pasársela al constructor RapidClient .

1. Crea una instancia de OkHttpClient con tus ajustes. Puedes usar una instancia que ya tengas o crear una nueva.

Ejemplo:

OkHttpClient customClient = new OkHttpClient.Builder()
        .connectTimeout(30, TimeUnit.SECONDS)
        .readTimeout(30, TimeUnit.SECONDS)
        .writeTimeout(30, TimeUnit.SECONDS)
        .build();

Para obtener más información sobre cómo configurar el servicio « OkHttpClient », consulta la documentación de OkHttp.

>> Más información sobre OkHttp

2. Pasa la instancia de « OkHttpClient » al constructor « RapidClient » builderWithHttpClient.

Ejemplo:

RapidClient rapidClient = RapidClient.builderWithHttpClient()
        .okHttpClient(customClient)
        .key("YOUR_API_KEY")
        .secret("YOUR_API_SECRET")
        .build();

3. Usa el servicio « rapidClient » que has configurado para hacer llamadas a la API como siempre.

Ejemplo:

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);