Skip to content

執行 ​

執行 Ktor 伺服器應用程式時,請注意以下幾點特性:

在本主題中,我們將介紹這些配置細節,並向你展示如何在 IntelliJ IDEA 中以及作為已封裝應用程式來執行 Ktor 應用程式。

配置細節 ​

配置:程式碼 vs 設定檔 ​

執行 Ktor 應用程式取決於你用於建立伺服器的方式 —— embeddedServer 或 EngineMain:

  • 對於 embeddedServer,伺服器參數(例如主機位址和連接埠)是在程式碼中配置的,因此你在執行應用程式時無法變更這些參數。
  • 對於 EngineMain,Ktor 會從使用 HOCON 或 YAML 格式的外部檔案載入其配置。使用這種方法,你可以從命令列執行已封裝的應用程式,並透過傳遞相應的命令列引數來覆寫所需的伺服器參數。

啟動 EngineMain:Gradle 與 Maven 細節 ​

如果你使用 EngineMain 來建立伺服器,則需要指定 main 函式,以便使用所需的引擎啟動伺服器。 以下範例示範了用於搭配 Netty 引擎執行伺服器的 main 函式:

kotlin
fun main(args: Array<String>): Unit = io.ktor.server.netty.EngineMain.main(args)

若要在不於 main 函式內配置引擎的情況下使用 Gradle/Maven 執行 Ktor 伺服器,你需要在建置指令碼中指定 main 類別名稱,如下所示:

kotlin
application {
    mainClass.set("io.ktor.server.netty.EngineMain")
}
groovy
mainClassName = "io.ktor.server.netty.EngineMain"
xml
<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 應用程式,請使用相應的外掛程式:

若要了解如何在 IntelliJ IDEA 中執行 Ktor 應用程式,請參閱 IntelliJ IDEA 文件中的執行 Ktor 應用程式章節。

執行已封裝的應用程式 ​

在部署應用程式之前,你需要透過封裝章節中所述的其中一種方式將其封裝。 從產生的套件中執行 Ktor 應用程式取決於套件類型,可能如下所示:

  • 若要執行封裝在 fat JAR 中的 Ktor 伺服器並覆寫已配置的連接埠,請執行以下指令:

    Bash
    java -jar sample-app.jar -port=8080
  • 若要執行使用 Gradle Application 外掛程式封裝的應用程式,請執行對應的可執行檔:

    ./ktor-sample
    ktor-sample.bat
  • 若要執行 servlet Ktor 應用程式,請使用 Gretty 外掛程式的 run 任務。