0Pricing
Kotlin Academy · Lektion

Ktor-Projekt einrichten: embeddedServer und Application-Module

Starten Sie eine Ktor-Anwendung, konfigurieren Sie Netty und definieren Sie Application-Module.

Ktor-Projekt einrichten: embeddedServer und Application-Module ist eine kostenlose Kotlin Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Kotlin Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Kotlin Academy-Kurs umfasst insgesamt 4 Lektionen.

Was ist Ktor?

Ktor ist ein asynchrones Kotlin-Framework von JetBrains zum Erstellen von Servern und Clients. Es ist Coroutine-basiert, Plugin-basiert und verzichtet auf Magie: Jede benötigte Funktion wird explizit installiert. Ktor-Anwendungen sind einfache Kotlin-Programme – ein DI-Container ist nicht erforderlich.

Ktor-Abhängigkeiten hinzufügen

Fügen Sie Ihrer build.gradle.kts die zentrale Server-Engine (Netty ist am weitesten verbreitet) und die zentrale Ktor-Serverbibliothek hinzu:

dependencies {
    implementation("io.ktor:ktor-server-core:2.3.12")
    implementation("io.ktor:ktor-server-netty:2.3.12")
    implementation("ch.qos.logback:logback-classic:1.5.6") // logging
}

embeddedServer: Minimaler Einstiegspunkt

Die einfachste Möglichkeit, einen Ktor-Server zu starten, ist embeddedServer. Übergeben Sie die Engine-Factory, den Port und einen Konfigurationsblock:

import io.ktor.server.engine.*
import io.ktor.server.netty.*
import io.ktor.server.routing.*
import io.ktor.server.response.*

fun main() {
    embeddedServer(Netty, port = 8080) {
        routing {
            get("/") { call.respondText("Hello, Ktor!") }
        }
    }.start(wait = true)
}

Anwendungsmodule

Teilen Sie die Konfiguration in größeren Projekten auf mehrere Module auf – Erweiterungsfunktionen für Application. Ein Modul installiert Plugins und registriert Routen. Dadurch lässt sich die Codebasis besser testen und zusammensetzen:

fun Application.configureRouting() {
    routing {
        get("/health") { call.respondText("OK") }
    }
}

fun Application.configureSerialization() {
    install(ContentNegotiation) { json() }
}

Module aus main aufrufen

Rufen Sie Ihre Modulfunktionen innerhalb des embeddedServer-Blocks auf, um sie zusammenzusetzen:

fun main() {
    embeddedServer(Netty, port = 8080) {
        configureRouting()
        configureSerialization()
        configureSecurity()
    }.start(wait = true)
}

application.conf (HOCON-Konfiguration)

Eine Alternative zu embeddedServer ist die Verwendung einer Datei application.conf (im HOCON-Format) und die Ausführung über EngineMain. Die Konfigurationsdatei legt das Einstiegsmodul und den Port fest:

# application.conf
ktor {
    deployment { port = 8080 }
    application {
        modules = [ com.example.ApplicationKt.module ]
    }
}

EngineMain im Vergleich zu embeddedServer

Verwenden Sie embeddedServer, wenn Sie die vollständige Kontrolle im Code benötigen (ideal für Tests und einfache Anwendungen). Verwenden Sie EngineMain zusammen mit application.conf, wenn Sie umgebungsspezifische Konfigurationen ohne Neukompilierung benötigen.

Das ApplicationCall-Objekt

Jeder Request-Handler empfängt ein ApplicationCall. Es bietet Zugriff auf den Request (call.request), die Response (call.response) und Hilfsfunktionen wie call.respondText() und call.respond().

Umgebung und Logging

Greifen Sie innerhalb eines Moduls über environment.config auf die Umgebungskonfiguration zu. Für das Logging wird SLF4J verwendet. Fügen Sie eine logback.xml zu src/main/resources/ hinzu, um Log-Level und Ausgabeformat zu konfigurieren.

Hot Reload in der Entwicklung

Ktor unterstützt Hot Reload während der Entwicklung über das Flag development. Aktivieren Sie es in application.conf oder programmgesteuert: embeddedServer(Netty, port = 8080, developmentMode = true) { ... }.

Konvention für die Projektstruktur

Ein typischer Aufbau eines Ktor-Projekts:

  • Application.kt – Einstiegspunkt mit main()
  • plugins/ – eine Datei pro Application-Erweiterungsfunktion (Routing, Serialization, Auth usw.)
  • routes/ – nach Domäne gruppierte Routendefinitionen
  • models/ – Datenklassen

Schnelltest

Welchen Zweck hat eine Application-Modulfunktion in Ktor?

Rückblick: Ktor-Projekt einrichten

Die wichtigsten Erkenntnisse:

  • embeddedServer(Engine, port) { ... }.start(wait=true) ist der einfachste Einstiegspunkt
  • Teilen Sie die Konfiguration in Modulerweiterungsfunktionen für Application auf
  • Verwenden Sie EngineMain zusammen mit application.conf für eine externe Konfiguration
  • Jeder Request-Handler arbeitet mit ApplicationCall, um auf Request und Response zuzugreifen
  • Gruppieren Sie Routen zur besseren Wartbarkeit in einem routes/-Package

Häufig gestellte Fragen

Ist die Lektion „Ktor-Projekt einrichten: embeddedServer und Application-Module“ kostenlos?

Ja — der vollständige Text von „Ktor-Projekt einrichten: embeddedServer und Application-Module“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Kotlin Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Kotlin Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Ktor-Projekt einrichten: embeddedServer und Application-Module“?

Starten Sie eine Ktor-Anwendung, konfigurieren Sie Netty und definieren Sie Application-Module. Du übst Kotlin Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Kotlin Academy zu starten?

Keine Vorkenntnisse erforderlich. Kotlin Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.

Wie lange dauert die Lektion „Ktor-Projekt einrichten: embeddedServer und Application-Module“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Kotlin Academy-Lektion Code schreiben und ausführen?

Ja. Jede Kotlin Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Ktor-Projekt einrichten: embeddedServer und Application-Module
  2. Routing und typisierte Parameter
  3. Content Negotiation und kotlinx.serialization
  4. Authentifizierungs-Plugins: JWT und Session
← Zurück zu Kotlin Academy