執行
執行 Ktor 伺服器應用程式時,請注意以下幾點特性:
- 用於建立伺服器的方式會影響你在執行已封裝的 Ktor 應用程式時,是否能透過傳遞命令列引數來覆寫伺服器參數。
- 當使用 EngineMain 啟動伺服器時,Gradle/Maven 建置指令碼應指定 main 類別名稱。
- 在 servlet 容器內部執行應用程式時,需要特定的 servlet 配置。
在本主題中,我們將介紹這些配置細節,並向你展示如何在 IntelliJ IDEA 中以及作為已封裝應用程式來執行 Ktor 應用程式。
配置細節
配置:程式碼 vs 設定檔
執行 Ktor 應用程式取決於你用於建立伺服器的方式 —— embeddedServer 或 EngineMain:
- 對於
embeddedServer,伺服器參數(例如主機位址和連接埠)是在程式碼中配置的,因此你在執行應用程式時無法變更這些參數。 - 對於
EngineMain,Ktor 會從使用HOCON或YAML格式的外部檔案載入其配置。使用這種方法,你可以從命令列執行已封裝的應用程式,並透過傳遞相應的命令列引數來覆寫所需的伺服器參數。
啟動 EngineMain:Gradle 與 Maven 細節
如果你使用 EngineMain 來建立伺服器,則需要指定 main 函式,以便使用所需的引擎啟動伺服器。 以下範例示範了用於搭配 Netty 引擎執行伺服器的 main 函式:
fun main(args: Array<String>): Unit = io.ktor.server.netty.EngineMain.main(args)若要在不於 main 函式內配置引擎的情況下使用 Gradle/Maven 執行 Ktor 伺服器,你需要在建置指令碼中指定 main 類別名稱,如下所示:
application {
mainClass.set("io.ktor.server.netty.EngineMain")
}mainClassName = "io.ktor.server.netty.EngineMain"<properties>
<main.class>io.ktor.server.netty.EngineMain</main.class>
</properties>WAR 細節
Ktor 允許你直接在應用程式中建立並啟動伺服器,並使用所需的引擎(例如 Netty、Jetty 或 Tomcat)。在此情況下,你的應用程式可以控制引擎設定、連線以及 SSL 選項。
與此方式相反,servlet 容器應該控制應用程式生命週期和連線設定。Ktor 提供了一個特殊的 ServletApplicationEngine 引擎,將對應用程式的控制權委託給 servlet 容器。你可以從配置 War 外掛程式中了解如何配置你的應用程式。
執行應用程式
在開發過程中重新啟動伺服器可能需要一些時間。Ktor 允許你使用自動重載來克服這項限制,該功能會在程式碼變更時重新載入應用程式類別,並提供快速的回饋循環。
使用 Gradle/Maven 執行應用程式
若要使用 Gradle 或 Maven 執行 Ktor 應用程式,請使用相應的外掛程式:
- 適用於 Gradle 的 Application 外掛程式。對於 Native 伺服器,請使用 Kotlin Multiplatform 外掛程式。
- 適用於 Maven 的 Exec 外掛程式。
若要了解如何在 IntelliJ IDEA 中執行 Ktor 應用程式,請參閱 IntelliJ IDEA 文件中的執行 Ktor 應用程式章節。
執行已封裝的應用程式
在部署應用程式之前,你需要透過封裝章節中所述的其中一種方式將其封裝。 從產生的套件中執行 Ktor 應用程式取決於套件類型,可能如下所示:
若要執行封裝在 fat JAR 中的 Ktor 伺服器並覆寫已配置的連接埠,請執行以下指令:
Bashjava -jar sample-app.jar -port=8080若要執行使用 Gradle Application 外掛程式封裝的應用程式,請執行對應的可執行檔:
./ktor-samplektor-sample.bat若要執行 servlet Ktor 應用程式,請使用 Gretty 外掛程式的
run任務。
