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 mejorar el rendimiento o integrarlo con un cliente HTTP ya existente, lo mejor es configurar 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();

Si quieres más información sobre cómo configurar el servicio « OkHttpClient », echa un vistazo a la documentación de OkHttp.

>> Más información sobre OkHttp

2. Pasa la instancia de OkHttpClient al constructor de 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);