Tento článok vychádza z pôvodnej dokumentácie Ktor a má za úlohu stručne zrekapitulovať možnosti frameworku Ktor, ktorý je určený pre tvorbu asynchrónnych aplikácií server a klient.

Pre generovanie projektu Ktor Server a Klient odporúčam využíť web generátor a pre Multiplatform priamo IDE IntelliJ IDEA, prípadne si nainštalovať nástroj Ktor CLI pre generovanie projektu. V Intellij IDEA Ultimate je korektne vygenerovaný Ktor projekt pomocou pluginu Ktor.

generovanie projektu na webe: Ktor Project Generator
generovanie projektu pluginom: plugin Ktor
Vytvorenie, otvorenie a spustenie nového projektu Ktor

brew update
brew install ktor
 
ktor new

KTOR Server je framework na vytváranie backend aplikácií – teda aplikácií, ktoré prijímajú HTTP požiadavky (GET, POST, PUT, DELETE, …), spracujú ich a vrátia odpoveď (JSON, HTML, text, …). Server Ktor čaká, kým ho niekto osloví.

Používa sa napríklad na REST API, mikroservisy, webové aplikácie, autentifikačné služby a podobne.

ktor_version=3.4.0

[libraries]
ktor-server-status-pages = { module = "io.ktor:ktor-server-status-pages", version.ref = "ktor" }

val ktor_version: String by project
 
dependencies {
  implementation(libs.ktor.server.status.pages)
 
}

KTOR Klient je knižnica na posielanie HTTP požiadaviek iným serverom. Používa sa napríklad na volanie REST API, komunikáciu s externými službami, sťahovanie dát a podobne. Klient aktívne oslovuje server.

ktor_version=3.4.0

[libraries]
#...

val ktor_version: String by project
 
dependencies {
  implementation("io.ktor:ktor-client-core:$ktor_version")
  implementation("io.ktor:ktor-client-cio:$ktor_version")}

V praxi je to veľmi časté použitie. Takáto aplikácia môže napríklad prijímať požiadavky od používateľov (funguje ako server) a zároveň volať iné API služby (funguje ako klient), teda spojiť odpovede a vrátiť výsledok.

Ak reálny príklad môže poslúžiť napríklad klientská mobilná appka ktorá zavolá vlastný Ktor Server, ktorý prijme požiadavku. Potom vo vlastnom backende Ktor Klient ju použije na zavolanie externého API (napríklad získanie informácií), ktoré spracuje a vráti klientskej mobilnej aplikácii.

Praktické využitie je napríklad v oblastiach: Mikroservisná architektúra, API Gateway, Backend-for-Frontend (BFF), Proxy server, Autentifikačné servery (napr. overenie tokenu voči inej službe) a podobne.

dependencies {
  implementation("io.ktor:ktor-server-core:...")
  implementation("io.ktor:ktor-client-core:...")
}

val httpClient = HttpClient()
 
// server - routing a get
routing {
    get("/data") {
        // klient - volenie a príjatie
        val externalResponse = httpClient.get("https://api.example.com/data")
        call.respond(externalResponse.bodyAsText())
    }
}

• HTTP
• Security: Authentications, Sessions, …
• Routing: Routing, Request Validation, Static Content, Status Pages, …
• Monitoring
• Serialization: Content Negotiation, kotlinx.serialization, GSON, Jackson
• Templating: Thymeleaf, …
• Databases: Exposed, Postgres, MongoDB, Kafka
• Frameworks: Koin, Dependency Injection, Koog (AI), …
• Sockets: Raw Sockets, Raw Secure SSL/TLS Sockets, WebSockets
• Administration: Shutdown URL, …