Конфигурация приложений Kotlin: библиотеки, подходы и инструменты

Конфигурация приложений Kotlin: обзор библиотек и инструментов

Конфигурация — одна из ключевых задач при разработке современных приложений. Правильно организованное управление настройками позволяет легко адаптировать приложение под разные окружения (разработка, тестирование, продакшн), упрощает деплой и повышает безопасность (например, исключая хранение секретов в коде). В экосистеме Kotlin существует несколько популярных подходов и библиотек для решения этой задачи. В этой статье мы рассмотрим основные инструменты, их преимущества и примеры использования.

1. Typesafe Config (HOCON)

HOCON (Human-Optimized Config Object Notation) — это формат конфигурационных файлов и библиотека, разработанная для платформы JVM. Она широко используется в проектах на Kotlin, особенно в связке с фреймворками вроде Akka, Play Framework или Lagom. Основные преимущества: лаконичный синтаксис, поддержка наследования, ссылок на другие значения и включение файлов.

Установка

// build.gradle.kts
implementation("com.typesafe:config:1.4.3")

Пример конфигурационного файла (application.conf)

app {
  name = "MyKotlinApp"
  version = "1.0.0"
  server {
    host = "localhost"
    port = 8080
  }
  database {
    url = "jdbc:postgresql://${app.server.host}:5432/mydb"
    user = "admin"
    password = ${?DB_PASSWORD} // подстановка из переменной окружения
  }
}

Чтение конфигурации в Kotlin

import com.typesafe.config.ConfigFactory

fun main() {
    val config = ConfigFactory.load()
    val appName = config.getString("app.name")
    val port = config.getInt("app.server.port")
    val dbUrl = config.getString("app.database.url")
    println("App: $appName, Port: $port, DB URL: $dbUrl")
}

Библиотека автоматически подгружает application.conf из classpath и поддерживает переопределение настроек через переменные окружения или JVM-параметры.

2. Koin — конфигурация через Dependency Injection

Koin — это легковесный DI-фреймворк для Kotlin, который также может использоваться для управления конфигурацией. Он позволяет объявлять настройки как синглтоны или фабрики и внедрять их в компоненты приложения.

Пример с Koin

// Определение модуля с конфигурацией
val appModule = module {
    single {
        AppConfig(
            name = "KoinApp",
            version = "2.0",
            port = 9090
        )
    }
}

// Запуск Koin
startKoin {
    modules(appModule)
}

// Использование
class MyService(private val config: AppConfig) {
    fun start() = println("Starting ${config.name} on port ${config.port}")
}

Koin удобен для небольших и средних проектов, где не хочется подключать тяжелые фреймворки. Конфигурация остаётся в коде, но может быть вынесена в отдельные файлы или загружена из переменных окружения.

3. Spring Boot и @ConfigurationProperties

Для проектов, использующих Spring Boot, конфигурация интегрирована на уровне фреймворка. Классы-конфигурации аннотируются @ConfigurationProperties, а значения подгружаются из application.yml или application.properties.

Пример

// application.yml
app:
  name: SpringKotlinApp
  server:
    port: 8080
  database:
    url: jdbc:postgresql://localhost:5432/mydb

// Kotlin-класс
@ConfigurationProperties(prefix = "app")
data class AppProperties(
    val name: String,
    val server: ServerConfig,
    val database: DatabaseConfig
) {
    data class ServerConfig(val port: Int)
    data class DatabaseConfig(val url: String)
}

// Использование в сервисе
@Service
class MyService(private val props: AppProperties) {
    fun info() = "App: ${props.name}, Port: ${props.server.port}"
}

Spring Boot поддерживает профили (dev, prod), шифрование секретов и работу с Vault. Это стандарт для корпоративных приложений.

4. dotenv-kotlin

Для простых проектов или микросервисов часто удобно хранить настройки в файле .env. Библиотека dotenv-kotlin позволяет загружать переменные окружения из этого файла.

Установка

// build.gradle.kts
implementation("io.github.cdimascio:dotenv-kotlin:6.4.1")

Пример использования

import io.github.cdimascio.dotenv.dotenv

fun main() {
    val dotenv = dotenv()
    val dbUrl = dotenv["DATABASE_URL"] ?: "jdbc