Ktor 1.4.0 Help

Quick Start

Ktor logo

Ktor is a framework to easily build connected applications – web applications, HTTP services, mobile and browser applications. Modern connected applications need to be asynchronous to provide the best experience to users, and Kotlin coroutines provide awesome facilities to do it in an easy and straightforward way.

While not yet entirely there, the goal of Ktor is to provide an end-to-end multiplatform application framework for connected applications. Currently, JVM client and server scenarios are supported, as well as JavaScript, iOS and Android clients, and we are working on bringing server facilities to native environments, and client facilities to other native targets.

Set up a Ktor project

You can set up a Ktor project using Maven, Gradle, start.ktor.io and the IntelliJ Plugin.

The plugin allows you to create a Ktor project as well as start.ktor.io, but with the additional convenience of being fully integrated in the IDE.

1) In a first step, you can configure the project to generate and select features to install:

ktor plugin 1 png

2) In a second step, you can configure the project artifacts:

ktor plugin 2 png

And that's it. A new project will be created and opened inside your IDE.

Hello World

A simple hello world in Ktor looks like this:

Ktor Hello World

  1. Here you define a plain callable main method.

  2. Then you create an embedded server using Netty as the back-end that will listen on port 8080.

  3. Installs the routing feature with a block where you can define routes for specific paths and HTTP methods.

  4. Actual routes: In this case, it will handle a GET request for the path /demo, and will reply with a HELLO WORLD! message.

  5. Actually start the server and wait for connections.

import io.ktor.application.* import io.ktor.http.* import io.ktor.response.* import io.ktor.routing.* import io.ktor.server.engine.* import io.ktor.server.netty.* fun main(args: Array<String>) { val server = embeddedServer(Netty, port = 8080) { routing { get("/") { call.respondText("Hello World!", ContentType.Text.Plain) } get("/demo") { call.respondText("HELLO WORLD!") } } } server.start(wait = true) }

Accessing your application

Since you have a main method, you can execute it with your IDE. That will open a HTTP server, listening on http://127.0.0.1:8080, You can try opening it with your favorite web browser.

Ktor Hello World Browser

At this point you should have a very simple Web Back-end running, so you can make changes, and see the results in your browser.

Last modified: 18 September 2020