개발 모드

개발 모드

Ktor는 개발을 위해 특화된 특별한 모드를 제공합니다. 이 모드를 사용하면 다음과 같은 기능들을 활용할 수 있습니다.

• 서버를 재시작하지 않고 애플리케이션 클래스를 다시 로드하기 위한
  자동 리로드(Auto-reload)

  Learn how to use Auto-reload to reload application classes on code changes.
  .
• 파이프라인(pipelines) 디버깅을 위한 확장 정보(스택 트레이스 포함).
• 5** 서버 오류가 발생한 경우
  응답 페이지(response page)

  %plugin_name% allows Ktor applications to respond appropriately to any failure state based on a thrown exception or status code.
  에 표시되는 확장 디버깅 정보.

NOTE

개발 모드는 성능에 영향을 미치므로 운영 환경(production)에서는 사용해서는 안 됩니다.

개발 모드 활성화하기

애플리케이션 설정 파일, 전용 시스템 속성 또는 환경 변수를 사용하는 등 다양한 방법으로 개발 모드를 활성화할 수 있습니다.

설정 파일

설정 파일

Learn how to configure various server parameters in a configuration file.

에서 개발 모드를 활성화하려면 development 옵션을 true로 설정하세요.

application.confapplication.yaml

'io.ktor.development' 시스템 속성

io.ktor.development 시스템 속성을 사용하면 애플리케이션을 실행할 때 개발 모드를 활성화할 수 있습니다.

IntelliJ IDEA를 사용하여 애플리케이션을 개발 모드로 실행하려면, -D 플래그와 함께 io.ktor.development를 VM 옵션에 전달하세요.

Gradle

Learn how to add Ktor Server dependencies to an existing Gradle/Maven project.

태스크를 사용하여 애플리케이션을 실행하는 경우, 다음 두 가지 방법 중 하나로 개발 모드를 활성화할 수 있습니다.

• build.gradle.kts 파일의 ktor 블록을 구성합니다.

• Gradle CLI 플래그를 전달하여 단일 실행에 대해 개발 모드를 활성화합니다.

TIP

-ea 플래그를 사용하여 개발 모드를 활성화할 수도 있습니다. 단, -D 플래그로 전달된 io.ktor.development 시스템 속성이 -ea보다 우선순위를 가집니다.

'io.ktor.development' 환경 변수

네이티브 클라이언트(Native client)의 개발 모드를 활성화하려면 io.ktor.development 환경 변수를 사용하세요.