클라이언트 플러그인

많은 애플리케이션은 애플리케이션 로직 범위를 벗어나는 공통 기능을 필요로 합니다. 예를 들어, 로깅, 직렬화, 또는 인증 등이 있습니다. 이 모든 기능은 Ktor에서 플러그인이라고 부르는 수단을 통해 제공됩니다.

플러그인 의존성 추가

플러그인은 별도의 의존성을 필요로 할 수 있습니다. 예를 들어, 로깅 플러그인은 빌드 스크립트에 ktor-client-logging 아티팩트를 추가해야 합니다:

Gradle (Kotlin)Gradle (Groovy)Maven

필요한 플러그인에 대한 토픽에서 어떤 의존성이 필요한지 확인할 수 있습니다.

플러그인 설치

플러그인을 설치하려면, 클라이언트 구성 블록 내부의 install 함수에 플러그인을 전달해야 합니다. 예를 들어, Logging 플러그인을 설치하는 방법은 다음과 같습니다:

import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.plugins.logging.*

val client = HttpClient(CIO) {
    install(Logging)
}

플러그인 구성

install 블록 내에서 플러그인을 구성할 수 있습니다. 예를 들어, 로깅 플러그인의 경우 로거, 로깅 레벨, 그리고 로그 메시지 필터링 조건을 지정할 수 있습니다:

runBlocking {
    val client = HttpClient(CIO) {
        install(Logging) {
            logger = Logger.DEFAULT
            level = LogLevel.HEADERS
            filter { request ->
                request.url.host.contains("ktor.io")
            }
            sanitizeHeader { header -> header == HttpHeaders.Authorization }

사용자 지정 플러그인 생성

사용자 지정 플러그인을 생성하는 방법을 배우려면, 사용자 지정 클라이언트 플러그인을 참조하세요.