Skip to content

클라이언트 플러그인 ​

많은 애플리케이션은 로깅, 직렬화, 또는 권한 부여와 같이 핵심 애플리케이션 로직의 일부가 아닌 공통 기능을 필요로 합니다. Ktor에서는 이러한 기능이 클라이언트 _플러그인_을 통해 제공됩니다.

플러그인 의존성 추가 ​

일부 플러그인은 추가 의존성이 필요합니다. 예를 들어 Logging 플러그인을 사용하려면 빌드 스크립트에 ktor-client-logging 아티팩트를 추가해야 합니다:

kotlin
implementation(ktorLibs.client.logging)
위의 코드 스니펫은 Ktor 버전 카탈로그를 사용하여 Ktor 의존성을 지정합니다.
groovy
implementation ktorLibs.client.logging
위의 코드 스니펫은 Ktor 버전 카탈로그를 사용하여 Ktor 의존성을 지정합니다.
xml
<dependency>
    <groupId>io.ktor</groupId>
    <artifactId>ktor-client-logging-jvm</artifactId>
    <version>${ktor_version}</version>
</dependency>

필요한 의존성은 각 플러그인 문서에 명시되어 있습니다.

플러그인 설치 ​

플러그인을 설치하려면 클라이언트 구성 블록 내부의 install() 함수에 플러그인을 전달합니다.

예를 들어 Logging 플러그인을 설치하는 코드는 다음과 같습니다:

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

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

플러그인 설치 또는 교체 ​

공유 클라이언트 구성 코드 등에 의해 플러그인이 이미 설치되어 있는 경우도 있습니다. 이러한 경우에는 installOrReplace() 함수를 사용하여 구성을 교체할 수 있습니다:

kotlin
import io.ktor.client.*
import io.ktor.client.engine.cio.*

val client = HttpClient(CIO) {
    installOrReplace(ContentNegotiation) {
        // ...
    }
}

이 함수는 플러그인이 설치되어 있지 않으면 새로 설치하고, 이미 설치되어 있는 경우에는 기존 구성을 교체합니다.

플러그인 구성 ​

대부분의 플러그인은 install 블록 내부에서 설정할 수 있는 구성 옵션을 제공합니다.

예를 들어 Logging 플러그인을 사용하면 로거, 로깅 레벨, 로그 메시지 필터링 조건을 지정할 수 있습니다:

kotlin
package com.example

import io.ktor.client.*
import io.ktor.client.engine.cio.*
import io.ktor.client.plugins.logging.*
import io.ktor.client.request.*
import io.ktor.client.statement.*
import io.ktor.http.*
import kotlinx.coroutines.runBlocking

fun main() {
    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 }
            }
        }

        val response1: HttpResponse = client.get("https://ktor.io/")
        val response2: HttpResponse = client.get("https://jetbrains.com/")
    }
}

커스텀 플러그인 생성 ​

기존 플러그인이 요구 사항을 충족하지 못하는 경우, 자신만의 커스텀 클라이언트 플러그인을 만들 수 있습니다. 커스텀 플러그인을 사용하면 요청과 응답을 가로채고(intercept) 재사용 가능한 동작을 구현할 수 있습니다.

자세한 내용은 커스텀 클라이언트 플러그인을 참조하세요.