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

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

WARNING 사용 중단 수준으로 표시된 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 속성도 추가했습니다. 원본 요청 정보에서 자세히 알아볼 수 있습니다.

구성 병합

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 메모리 모델이 기본적으로 활성화됩니다. 이는 네이티브 서버나 Kotlin/Native를 대상으로 하는 클라이언트 엔진에 대해 명시적으로 활성화할 필요가 없다는 것을 의미합니다.