Skip to content

開発モード

開発モード

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

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

NOTE

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

開発モードを有効にする

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

設定ファイル

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

yaml

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

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

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

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

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

    Kotlin
  • Gradle CLIフラグを渡して、1回の実行に対して開発モードを有効にします:

    bash

TIP

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

'io.ktor.development' 環境変数

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