2.0.x에서 2.2.x로 마이그레이션하기

이 가이드는 Ktor 애플리케이션을 2.0.x 버전에서 2.2.x 버전으로 마이그레이션하는 방법을 안내합니다.

WARNING 수준의 지원 중단(deprecation)이 표시된 API는 3.0.0 출시 전까지 계속 작동합니다. 지원 중단 수준에 대한 자세한 내용은 Deprecated에서 확인할 수 있습니다.

Ktor 서버

쿠키

v2.2.0부터 응답 쿠키 설정과 관련된 다음 API 멤버들이 변경되었습니다.

• append 함수에 전달되는 maxAge 파라미터 타입이 Int에서 Long으로 변경되었습니다.
• appendExpired 함수가 지원 중단되었습니다. 대신 expires 파라미터가 포함된 append 함수를 사용하세요.

요청 주소 정보

2.2.0 버전부터 요청이 발생한 호스트 이름/포트를 가져오는 데 사용되는 RequestConnectionPoint.host 및 RequestConnectionPoint.port 속성이 지원 중단되었습니다.

get("/hello") {
    val originHost = call.request.origin.host
    val originPort = call.request.origin.port
}

대신 RequestConnectionPoint.serverHost와 RequestConnectionPoint.serverPort를 사용하세요. 또한 요청을 받은 호스트 이름/포트를 반환하는 localHost/localPort 속성도 추가되었습니다. 자세한 내용은 원본 요청 정보(Original request information)에서 확인할 수 있습니다.

설정 병합

v2.2.0 이전에는 애플리케이션 설정을 병합하기 위해 List<ApplicationConfig>.merge() 함수를 사용했습니다. 두 설정에 모두 동일한 키가 있는 경우, 결과 설정은 첫 번째 설정의 값을 취합니다. 이번 릴리스에서는 이 동작을 개선하기 위해 다음과 같은 API가 도입되었습니다.

• public fun ApplicationConfig.withFallback(other: ApplicationConfig): ApplicationConfig: 이 함수는 merge()와 동일하게 작동하며 첫 번째 설정의 값을 취합니다.
• public fun ApplicationConfig.mergeWith(other: ApplicationConfig): ApplicationConfig: 결과 설정은 두 번째 설정의 값을 취합니다.

Ktor 클라이언트

캐싱: 영구 스토리지

v2.2.0부터 응답 캐싱과 관련된 다음 API가 지원 중단되었습니다.

• HttpCacheStorage 클래스가 CacheStorage 인터페이스로 대체되었습니다. 이 인터페이스는 필요한 플랫폼에 맞춰 영구 스토리지를 구현하는 데 사용될 수 있습니다.
• publicStorage/privateStorage 속성이 CacheStorage 인스턴스를 받는 해당 함수들로 대체되었습니다.

커스텀 플러그인

2.2.0 릴리스부터 Ktor는 커스텀 클라이언트 플러그인을 만들기 위한 새로운 API를 제공합니다. 자세한 내용은 커스텀 클라이언트 플러그인을 참조하세요.

새로운 메모리 모델

v2.2.0부터 Ktor는 Kotlin 1.7.20 버전을 사용하며, 이 버전에서는 새로운 Kotlin/Native 메모리 모델이 기본적으로 활성화되어 있습니다. 따라서 Native 서버나 Kotlin/Native를 대상으로 하는 클라이언트 엔진에서 이를 명시적으로 활성화할 필요가 없습니다.