開發模式
Ktor 提供了一種專為開發而設的特殊模式。此模式啟用以下功能:
- Auto-reload用於在不重新啟動伺服器的情況下重新載入應用程式類別。瞭解如何使用 Auto-reload 在程式碼變更時重新載入應用程式類別。
- 用於偵錯管線的擴展資訊(附帶堆疊追蹤)。
- 當發生 5** 伺服器錯誤時,在回應頁面上提供擴展偵錯資訊。%plugin_name% 允許 Ktor 應用程式根據拋出的異常或狀態碼,對任何失敗狀態做出適當的回應。
NOTE
請注意,開發模式會影響效能,不應在生產環境中使用。
啟用開發模式
您可以透過多種方式啟用開發模式:在應用程式設定檔中、使用專用的系統屬性或環境變數。
「io.ktor.development」系統屬性
io.ktor.development系統屬性 允許您在運行應用程式時啟用開發模式。
若要使用 IntelliJ IDEA 在開發模式下運行應用程式, 請將帶有 -D
標誌的 io.ktor.development
傳遞給 VM 選項:
如果您使用
Gradle
任務運行應用程式, 您可以透過兩種方式啟用開發模式: 瞭解如何將 Ktor 伺服器依賴項新增到現有的 Gradle/Maven 專案中。
在您的 build.gradle.kts 檔案中配置
ktor
區塊:Kotlin透過傳遞 Gradle CLI 標誌來啟用單次運行的開發模式:
bash
TIP
您也可以使用 -ea
標誌啟用開發模式。 請注意,使用 -D
標誌傳遞的 io.ktor.development
系統屬性優先於 -ea
。
「io.ktor.development」環境變數
若要為原生客戶端 (Native client)啟用開發模式, 請使用 io.ktor.development
環境變數。