新增伺服器相依性
在本主題中,我們將向您展示如何將 Ktor Server 所需的相依性新增至現有的 Gradle/Maven 專案。
設定存儲庫
在新增 Ktor 相依性之前,您需要為此專案設定存儲庫:
生產版本
Ktor 的生產版本可在 Maven 中央存儲庫中取得。 您可以在建置指令碼中宣告此存儲庫,如下所示:
kotlinrepositories { mavenCentral() }groovyrepositories { mavenCentral() }您不需要在 pom.xml 檔案中新增 Maven 中央存儲庫,因為您的專案會從 Super POM 繼承中央存儲庫。
早期體驗體計劃 (EAP)
要存取 Ktor 的 EAP 版本,您需要參照 Space 存儲庫:
kotlinrepositories { maven { url = uri("https://redirector.kotlinlang.org/maven/ktor-eap") } }groovyrepositories { maven { url "https://redirector.kotlinlang.org/maven/ktor-eap" } }xml<repositories> <repository> <id>ktor-eap</id> <url>https://redirector.kotlinlang.org/maven/ktor-eap</url> </repository> </repositories>請注意,Ktor EAP 可能需要 Kotlin 開發存儲庫:
kotlinrepositories { maven { url = uri("https://redirector.kotlinlang.org/maven/dev") } }groovyrepositories { maven { url "https://redirector.kotlinlang.org/maven/dev" } }xml<repositories> <repository> <id>ktor-eap</id> <url>https://redirector.kotlinlang.org/maven/dev</url> </repository> </repositories>
新增相依性
核心相依性
每個 Ktor 應用程式至少需要以下相依性:
ktor-server-core:包含核心 Ktor 功能。一個引擎了解處理網路請求的引擎。的相依性(例如
ktor-server-netty)。
對於不同的平台,Ktor 提供特定平台的成品 (artifacts),並帶有 -jvm 等後綴,例如 ktor-server-core-jvm 或 ktor-server-netty-jvm。 請注意,Gradle 會解析適合特定平台的成品,而 Maven 不支援此功能。 這意味著對於 Maven,您需要手動新增特定平台的後綴。 一個基礎 Ktor 應用程式的 dependencies 區塊可能如下所示:
dependencies {
implementation("io.ktor:ktor-server-core:3.6.1")
implementation("io.ktor:ktor-server-netty:3.6.1")
}dependencies {
implementation "io.ktor:ktor-server-core:3.6.1"
implementation "io.ktor:ktor-server-netty:3.6.1"
}<dependencies>
<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-server-core-jvm</artifactId>
<version>3.6.1</version>
</dependency>
<dependency>
<groupId>io.ktor</groupId>
<artifactId>ktor-server-netty-jvm</artifactId>
<version>3.6.1</version>
</dependency>
</dependencies>記錄相依性
Ktor 使用 SLF4J API 作為各種記錄架構(例如 Logback 或 Log4j)的介面,並允許您記錄應用程式事件。 要了解如何新增所需的成品,請參閱新增記錄器相依性。
外掛程式相依性
擴充 Ktor 功能的外掛程式外掛程式提供常見的功能性,例如序列化、內容編碼、壓縮等。可能需要額外的相依性。 您可以從相應的主題中了解更多資訊。
確保 Ktor 版本一致性
使用 Ktor Gradle 外掛程式
套用 Ktor Gradle 外掛程式 會隱含地新增 Ktor BOM 相依性,並允許您確保所有 Ktor 相依性都處於 相同版本。在這種情況下,當相依於 Ktor 成品時,您不再需要指定版本:
plugins {
// ...
id("io.ktor.plugin") version "3.6.1"
}
dependencies {
implementation("io.ktor:ktor-server-core")
// ...
}plugins {
// ...
id "io.ktor.plugin" version "3.6.1"
}
dependencies {
implementation "io.ktor:ktor-server-core"
// ...
}使用發佈的版本目錄
您也可以透過使用發佈的版本目錄 (version catalog) 來集中 Ktor 相依性宣告。 此方法具有以下優點:
- 消除在您自己的目錄中手動宣告 Ktor 版本的需求。
- 在單一命名空間下公開每個 Ktor 模組。
要宣告目錄,請在 settings.gradle.kts 建立一個具有您所選名稱的版本目錄:
dependencyResolutionManagement {
versionCatalogs {
create("ktorLibs") {
from("io.ktor:ktor-version-catalog:3.6.1")
}
}
}然後,您可以透過參照目錄名稱,在模組的 build.gradle.kts 中新增相依性:
dependencies {
implementation(ktorLibs.server.core)
// ...
}為執行應用程式建立進入點
使用 Gradle/Maven 執行了解如何執行 Ktor 伺服器應用程式。 Ktor 伺服器取決於建立伺服器了解如何根據您的應用程式部署需求建立伺服器。的方式。 您可以透過以下方式之一指定應用程式主類別 (main class):
如果您使用 embeddedServer,請按如下方式指定主類別:
kotlinapplication { mainClass.set("com.example.ApplicationKt") }groovyapplication { mainClass = "com.example.ApplicationKt" }xml<properties> <main.class>com.example.ApplicationKt</main.class> </properties>如果您使用 EngineMain,您需要將其配置為主類別。 對於 Netty,它將如下所示:
kotlinapplication { mainClass.set("io.ktor.server.netty.EngineMain") }groovyapplication { mainClass = "io.ktor.server.netty.EngineMain" }xml<properties> <main.class>io.ktor.server.netty.EngineMain</main.class> </properties>
如果您打算將應用程式封裝為 Fat JAR,則在配置相應的外掛程式時,還需要考慮建立伺服器的方式。 請從以下主題中了解更多資訊:
使用 Ktor Gradle 外掛程式建立 fat JAR了解如何使用 Ktor Gradle 外掛程式建立並執行可執行的 fat JAR。
使用 Maven Assembly 外掛程式建立 fat JAR範例專案:tutorial-server-get-started-maven
