Ktor 1.5.4 Help

Features

A typical request/response pipeline in Ktor looks like the following:

Request Response Pipeline

It starts with a request, which is routed to a specific handler, processed by our application logic, and finally responded to.

Adding functionality with Features

Many applications require common functionality that is out of scope of the application logic. This could be things like serialization and content encoding, compression, headers, cookie support, etc. All of these are provided in Ktor by means of what we call Features.

If we look at the previous pipeline diagram, Features sit between the request/response and the application logic:

Feature pipeline

As a request comes in:

  • It is routed to the correct handler via the routing mechanism

  • before being handed off to the handler, it goes through one or more Features

  • the handler (application logic) handles the request

  • before the response is sent to the client, it goes through one or more Features

Routing is a Feature

Features have been designed in a way to offer maximum flexibility, and allow them to be present in any segment of the request/response pipeline. In fact, what we've been calling routing until now, is nothing more than a Feature.

Routing as a Feature

Installing Features

Features are generally configured during the initialization phase of the server using the install function which takes a Feature as a parameter. Depending on the way you used to create a server, you can install a feature inside the main function ...

import io.ktor.features.* // ... fun Application.main() { install(Routing) install(Encoding) // ... }

... or a specified module:

import io.ktor.features.* // ... fun Application.module() { install(Routing) install(Encoding) // ... }

In addition to intercepting requests and responses, Features can have an option configuration section which is configured during this step.

For instance, when installing Cookies we can set certain parameters such as where we want Cookies to be stored, or their name:

install(Sessions) { cookie<MyCookie>("MY_COOKIE") }

Default, available, and custom Features

By default, Ktor does not activate any Feature, and it's up to us as developers to install the functionality our application need.

Ktor does however provide a variety of Features that ship out of the box. We can see a complete list of these either on the Project Generator Site or in the IntelliJ IDEA Wizard. In addition we can also create our own custom Features

For more information about sequencing of Features and how they intercept the request/response pipeline, see Pipeline in the Advanced section of the documentation.

Last modified: 19 April 2021