서버 종속성 추가

이 토픽에서는 기존 Gradle/Maven 프로젝트에 Ktor 서버에 필요한 종속성을 추가하는 방법을 보여드립니다.

저장소 구성

Ktor 종속성을 추가하기 전에 이 프로젝트의 저장소를 구성해야 합니다:

• 프로덕션

  Ktor의 프로덕션 릴리스는 Maven 중앙 저장소에서 사용할 수 있습니다. 이 저장소는 빌드 스크립트에서 다음과 같이 선언할 수 있습니다:

  Gradle (Kotlin)Gradle (Groovy)Maven

  NOTE

  프로젝트가 Super POM에서 중앙 저장소를 상속하므로 pom.xml 파일에 Maven 중앙 저장소를 추가할 필요가 없습니다.

• 얼리 액세스 프로그램 (EAP)

  Ktor의 EAP 버전에 액세스하려면 Space 저장소를 참조해야 합니다:

  Gradle (Kotlin)Gradle (Groovy)Maven

  Ktor EAP는 Kotlin 개발 저장소를 필요로 할 수 있습니다:

  Gradle (Kotlin)Gradle (Groovy)Maven

종속성 추가

코어 종속성

모든 Ktor 애플리케이션은 최소한 다음 종속성을 필요로 합니다:

• ktor-server-core: Ktor의 핵심 기능을 포함합니다.

• 엔진

  네트워크 요청을 처리하는 엔진에 대해 알아봅니다.
  에 대한 종속성 (예: ktor-server-netty).

다양한 플랫폼을 위해 Ktor는 -jvm과 같은 접미사가 붙은 플랫폼별 아티팩트를 제공합니다 (예: ktor-server-core-jvm 또는 ktor-server-netty-jvm). Gradle은 주어진 플랫폼에 적합한 아티팩트를 자동으로 해결하지만 Maven은 이 기능을 지원하지 않습니다. 이는 Maven의 경우 플랫폼별 접미사를 수동으로 추가해야 함을 의미합니다. 기본적인 Ktor 애플리케이션의 dependencies 블록은 다음과 같을 수 있습니다:

Gradle (Kotlin)Gradle (Groovy)Maven

로깅 종속성

Ktor는 다양한 로깅 프레임워크(예: Logback 또는 Log4j)의 퍼사드(facade)로 SLF4J API를 사용하며 애플리케이션 이벤트를 로깅할 수 있도록 합니다. 필요한 아티팩트를 추가하는 방법을 알아보려면 로거 종속성 추가를 참조하세요.

플러그인 종속성

플러그인

플러그인은 직렬화, 콘텐츠 인코딩, 압축 등과 같은 공통 기능을 제공합니다.

은 Ktor 기능을 확장하며 추가 종속성을 필요로 할 수 있습니다. 해당 토픽에서 더 자세히 알아볼 수 있습니다.

Ktor 버전 일관성 보장

Ktor Gradle 플러그인 사용

Ktor Gradle 플러그인을 적용하면 Ktor BOM 종속성이 암시적으로 추가되어 모든 Ktor 종속성이 동일한 버전을 사용하도록 보장할 수 있습니다. 이 경우 Ktor 아티팩트에 종속될 때 버전을 지정할 필요가 없습니다:

Gradle (Kotlin)Gradle (Groovy)

게시된 버전 카탈로그 사용

게시된 버전 카탈로그를 사용하여 Ktor 종속성 선언을 중앙 집중화할 수도 있습니다. 이 접근 방식은 다음과 같은 이점을 제공합니다:

• 자체 카탈로그에서 Ktor 버전을 수동으로 선언할 필요가 없습니다.
• 모든 Ktor 모듈을 단일 네임스페이스 아래에 노출합니다.

카탈로그를 선언하려면 settings.gradle.kts에서 원하는 이름으로 버전 카탈로그를 생성하세요:

그런 다음 모듈의 build.gradle.kts에 카탈로그 이름을 참조하여 종속성을 추가할 수 있습니다:

애플리케이션 실행을 위한 진입점 생성

Ktor 서버를 Gradle/Maven을 사용하여 실행하는 것

서버 Ktor 애플리케이션을 실행하는 방법을 알아봅니다.

은

서버를 생성하는

애플리케이션 배포 요구 사항에 따라 서버를 생성하는 방법을 알아봅니다.

방식에 따라 달라집니다. 애플리케이션의 메인 클래스를 다음 방법 중 하나로 지정할 수 있습니다:

• embeddedServer를 사용하는 경우 메인 클래스를 다음과 같이 지정합니다:

  Gradle (Kotlin)Gradle (Groovy)Maven

• EngineMain을 사용하는 경우 이를 메인 클래스로 구성해야 합니다. Netty의 경우 다음과 같이 보일 것입니다:

  Gradle (Kotlin)Gradle (Groovy)Maven

NOTE

애플리케이션을 Fat JAR로 패키징할 경우, 해당 플러그인을 구성할 때 서버를 생성하는 방식도 고려해야 합니다. 다음 토픽에서 더 자세히 알아보세요:

• Ktor Gradle 플러그인을 사용하여 Fat JAR 생성하기

  Ktor Gradle 플러그인을 사용하여 실행 가능한 Fat JAR를 생성하고 실행하는 방법을 알아봅니다.

• Maven Assembly 플러그인을 사용하여 Fat JAR 생성하기

  샘플 프로젝트: tutorial-server-get-started-maven