Skip to content

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 속성이 지원 중단되었습니다.

kotlin
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를 대상으로 하는 클라이언트 엔진에서 이를 명시적으로 활성화할 필요가 없습니다.