구성 가능한 HTTP 클라이언트

개요

Rapid SDK는 기본 HTTP 클라이언트를 사용하여 API 호출을 실행합니다. 개발자에게 더 많은 제어권을 부여하기 위해 HTTP 클라이언트를 더 잘 제어할 수 있도록 SDK에서 사용할 자체 HTTP 클라이언트를 전달하는 데 사용할 수 있는 빌더가 제공됩니다. 이 빌더를 사용하면 자체 구성으로 HTTP 클라이언트를 빌드하여 SDK에 전달하거나 애플리케이션에서 이미 사용 중인 클라이언트를 전달할 수도 있습니다.

HTTP 클라이언트 구성하기와 기본 클라이언트 사용하기

제공된 기본 클라이언트를 사용하는 것이 SDK를 시작하는 가장 쉬운 방법입니다. 하지만 자체 HTTP 클라이언트를 구성하면 다음과 같은 이점이 있습니다:

• 최적화: 연결 풀링, 시간 초과 및 재시도 등 성능 향상을 위해 클라이언트를 미세 조정합니다.
• 통합: 애플리케이션 내에서 이미 구성 및 테스트가 완료된 기존 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()
        .okHttpClient(customClient)
        .key("YOUR_API_KEY")
        .secret("YOUR_API_SECRET")
        .build();

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