Skip to content

開発モード

Ktorは、開発向けに特化した特別なモードを提供しています。このモードでは、以下の機能が有効になります:

  • サーバーを再起動せずにアプリケーションクラスをリロードするためのオートリロードオートリロードを使用して、コードの変更時にアプリケーションクラスをリロードする方法を学びます。。
  • パイプラインをデバッグするための拡張情報(スタックトレースを含む)。
  • 5**サーバーエラーが発生した場合のレスポンスページStatusPages により、Ktor アプリケーションはスローされた例外やステータスコードに基づいて、あらゆる障害状態に適切に応答できるようになります。における拡張デバッグ情報。

開発モードはパフォーマンスに影響を与えるため、本番環境では使用しないでください。

開発モードを有効にする

開発モードは、アプリケーションの設定ファイル、専用のシステムプロパティ、または環境変数を使用して、さまざまな方法で有効にできます。

設定ファイル

設定ファイル構成ファイルでさまざまなサーバーパラメータを設定する方法について説明します。で開発モードを有効にするには、developmentオプションをtrueに設定します:

ktor {
    development = true
}
yaml
ktor:
    development: true

'io.ktor.development' システムプロパティ

io.ktor.developmentシステムプロパティを使用すると、アプリケーションの実行時に開発モードを有効にできます。

IntelliJ IDEAを使用して開発モードでアプリケーションを実行するには、-Dフラグを付けてio.ktor.developmentをVMオプションに渡します:

-Dio.ktor.development=true

Gradle既存のGradle/MavenプロジェクトにKtorサーバーの依存関係を追加する方法を学びます。タスクを使用してアプリケーションを実行する場合、次の2つのいずれかの方法で開発モードを有効にできます:

  • build.gradle.ktsファイルのktorブロックを設定します:

    kotlin
    ktor {
        development = true
    }
  • Gradle CLIフラグを渡して、1回の実行に対して開発モードを有効にします:

    bash
    ./gradlew run -Pio.ktor.development=true

-eaフラグを使用して開発モードを有効にすることもできます。 -Dフラグで渡されるio.ktor.developmentシステムプロパティは、-eaよりも優先されることに注意してください。

'io.ktor.development' 環境変数

Nativeクライアントで開発モードを有効にするには、io.ktor.development環境変数を使用します。