Реализация паттерна Builder в Kotlin: эффективные подходы и примеры

Паттерн Builder в Kotlin: идиоматичные подходы

Ваш код на Java вполне рабочий, но в Kotlin есть более элегантные решения. Рассмотрим три основных подхода, начиная от самого простого и заканчивая классическим билдером.

1. Использование именованных аргументов и значений по умолчанию (самый идиоматичный способ)

Kotlin позволяет задавать значения по умолчанию для параметров конструктора и использовать именованные аргументы. Это полностью заменяет паттерн Builder в большинстве случаев:

data class User(
    val name: String = "",
    val age: Int = 0,
    val email: String = ""
)

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

// Можно пропускать необязательные поля:
val user2 = User(name = "Петр", email = "petr@example.com")

Этот подход имеет несколько преимуществ:

• Минимум кода — не нужно писать отдельный класс Builder
• Безопасность типов на уровне компиляции
• Возможность задавать значения в любом порядке
• Автоматическая генерация методов toString(), equals(), hashCode() и copy() благодаря data class
• Неизменяемость (все поля val)

2. Использование функции apply для инициализации

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

class User private constructor(
    val name: String,
    val age: Int,
    val email: String
) {
    companion object {
        inline fun build(block: Builder.() -> Unit): User {
            return Builder().apply(block).build()
        }
    }
    
    class Builder {
        var name: String = ""
        var age: Int = 0
        var email: String = ""
        
        fun build(): User {
            // Здесь можно добавить валидацию
            require(name.isNotBlank()) { "Name must not be blank" }
            require(age >= 0) { "Age must be non-negative" }
            
            return User(name, age, email)
        }
    }
}

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

Этот подход сочетает лаконичность Kotlin с возможностью валидации и контроля над созданием объекта.

3. Классический Builder с типизированными свойствами (для сложных случаев)

Если вам нужен строгий контроль над порядком установки свойств или обязательные поля, можно использовать типизированный Builder:

class User private constructor(
    val name: String,
    val age: Int,
    val email: String?
) {
    class Builder(private val name: String) {
        private var age: Int = 0
        private var email: String? = null
        
        fun age(age: Int): Builder {
            this.age = age
            return this
        }
        
        fun email(email: String): Builder {
            this.email = email
            return this
        }
        
        fun build(): User {
            return User(name, age, email)
        }
    }
    
    companion object {
        fun name(name: String): Builder = Builder(name)
    }
}

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

Здесь имя является обязательным и задаётся в конструкторе Builder, а остальные поля — опциональные.

Рекомендации

• Для 90% случаев используйте data class с именованными аргументами и значениями по умолчанию
• Если нужна валидация — используйте apply с companion object
• Если нужен строгий порядок или обязательные поля — используйте классический Builder с типизированными свойствами

В Kotlin паттерн Builder часто избыточен благодаря встроенным возможностям языка. Всегда начинайте с самого простого решения и усложняйте только при необходимости.

class User private constructor(
    val name: String,
    val age: Int,
    val email: String
) {
    data class Builder(
        var name: String = "",
        var age: Int = 0,
        var email: String = ""
    ) {
        fun build(): User {
            require(name.isNotBlank()) { "Name is required" }
            return User(name, age, email)
        }
    }
    
    companion object {
        inline fun builder(block: Builder.() -> Unit): User {
            return Builder().apply(block).build()
        }
    }
}

// Использование:
val user = User.builder {
    name = "Анна"
    age = 25
    email = "anna@example.com"
}

class Address(val city: String, val street: String) {
    class Builder {
        var city: String = ""
        var street: String = ""
        
        fun build() = Address(city, street)
    }
}

class User(
    val name: String,
    val address: Address
) {
    class Builder {
        var name: String = ""
        var address: Address.Builder = Address.Builder()
        
        fun address(block: Address.Builder.() -> Unit) {
            address.apply(block)
        }
        
        fun build() = User(name, address.build())
    }
}

// Использование:
val user = User.Builder().apply {
    name = "Иван"
    address {
        city = "Москва"
        street = "Тверская"
    }
}.build()