Как правильно реализовать паттерн Builder в Kotlin с учетом идиом языка?

Идиоматичный Builder в Kotlin: используем значения по умолчанию и apply

В Kotlin не нужно писать отдельный класс Builder, как в Java. Язык предоставляет встроенные механизмы, которые делают код чище и короче. Рассмотрим два основных подхода.

1. Простой случай: значения по умолчанию и именованные аргументы

Если вам не нужна цепочка вызовов (build-метод), а достаточно однократного создания объекта, используйте конструктор с параметрами по умолчанию:

class User(
    val name: String,
    val age: Int? = null,
    val email: String? = null,
    val phone: String? = null,
    val address: String? = null,
    val isActive: Boolean = true
)

// Использование:
val user = User(
    name = "Иван",
    email = "ivan@example.com"
)

Это самый идиоматичный способ. Он не требует Builder и полностью типобезопасен.

2. Если нужен именно Builder (цепочечный вызов с apply)

Когда вы хотите создавать объект в несколько шагов (например, в разных частях кода), используйте функцию apply. Она позволяет выполнить блок кода в контексте объекта и вернуть его:

class User private constructor(
    val name: String,
    val age: Int?,
    val email: String?,
    val phone: String?,
    val address: String?,
    val isActive: Boolean
) {
    // Вспомогательный класс-строитель
    class Builder(private val name: String) {
        var age: Int? = null
        var email: String? = null
        var phone: String? = null
        var address: String? = null
        var isActive: Boolean = true
        
        fun build() = User(
            name = name,
            age = age,
            email = email,
            phone = phone,
            address = address,
            isActive = isActive
        )
    }
}

// Использование:
val user = User.Builder("Иван")
    .apply {
        email = "ivan@example.com"
        phone = "+7-999-123-45-67"
        isActive = false
    }
    .build()

Обратите внимание: мы сделали конструктор private, чтобы пользователи обязательно шли через Builder. Метод apply делает код лаконичным — не нужно писать set-методы.

3. Продвинутый вариант: type-safe builder с вложенными лямбдами

Для сложных иерархий (например, HTML-генерация) используйте DSL-подход с функциями высшего порядка:

fun user(init: UserBuilder.() -> Unit): User {
    val builder = UserBuilder()
    builder.init()
    return builder.build()
}

class UserBuilder {
    var name: String = ""
    var age: Int? = null
    var email: String? = null
    
    fun build(): User = User(
        name = name,
        age = age,
        email = email
    )
}

// Использование:
val user = user {
    name = "Иван"
    email = "ivan@example.com"
}

Этот метод особенно популярен в библиотеках (например, Ktor, Kotlinx.html).

Почему это лучше Java-подхода?

• Меньше кода: не нужно писать set-методы для каждого поля.
• Типобезопасность: Kotlin проверяет типы на этапе компиляции.
• Читаемость: apply и именованные аргументы делают код самодокументируемым.
• Гибкость: можно комбинировать подходы (например, значения по умолчанию + apply).

Если у вас есть изменяемые поля (var), можно вообще обойтись без Builder — используйте apply прямо на экземпляре класса. Но для неизменяемых объектов (val) Builder или DSL — лучший выбор.

data class User(
    val name: String,
    val age: Int? = null,
    val email: String? = null,
    val phone: String? = null
)

// Создаём объект с частичной инициализацией
val defaultUser = User(name = "Шаблон")

// Затем донастраиваем через copy()
val actualUser = defaultUser.copy(
    email = "test@test.com",
    age = 30
)