구성 가능한 HTTP 클라이언트 소개

RAPID SDK는 사용자가 구성하고 조정할 수 있도록 공개되지 않은 OkHttpClient 위에 구축되었습니다. 최근 저희는 HTTP 클라이언트를 필요에 맞게 조정하고 최적화해야 한다는 사실을 깨닫게 되었습니다. 따라서 Rapid SDK를 사용하는 개발자에게 더 많은 제어권을 제공하기 위해 를 사용하는 개발자가 SDK의 기본 HTTP 클라이언트를 더 잘 제어할 수 있도록, SDK 내부에서 사용할 수 있는 자체 HTTP 클라이언트를 SDK 내부에 전달할 수 있는 새로운 빌더를 도입합니다.

이 빌더를 사용하면 자체 구성으로 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);