Каким ключевым словом обозначается поле в конструкторе класса которое используется только в блоке init?

Область видимости параметров конструктора в Kotlin

В Kotlin для обозначения параметра конструктора, который используется только в блоке init или при инициализации свойств класса, применяется ключевое слово private в сочетании с объявлением в первичном конструкторе. Однако более точный и современный подход — использование модификатора видимости без val/var.

Ключевой механизм

Параметры первичного конструктора, которые не помечены как val или var, не становятся автоматически свойствами класса. Они существуют только как локальные переменные в области видимости инициализатора (init блоков) и инициализаторов свойств. Если такой параметр нужно использовать исключительно внутри init, его можно оставить без модификатора видимости или явно ограничить, например, сделав private.

Примеры кода

1. Базовый случай — параметр без val/var

class User(nameParam: String, val age: Int) {
    private val userName: String
    
    init {
        userName = nameParam.uppercase() // nameParam используется только здесь
        println("User initialized with name: $userName")
    }
    
    fun display() {
        println("Name: $userName, Age: $age")
    }
}

Здесь nameParam существует только для инициализации свойства userName в блоке init.

2. Явное указание private для параметра

class DatabaseConfig(private val connectionString: String, maxConnections: Int) {
    private val maxPoolSize: Int
    
    init {
        require(maxConnections > 0) { "maxConnections must be positive" }
        maxPoolSize = maxConnections * 2
        println("Configured pool: $maxPoolSize for $connectionString")
    }
}

Параметр maxConnections не является свойством класса — он используется только в init для валидации и вычисления maxPoolSize.

3. Сложная инициализация с несколькими init блоками

class SensorCalibration(rawOffset: Double, calibrationFactor: Double) {
    private val offset: Double
    private val factor: Double
    
    init {
        offset = rawOffset.coerceIn(-100.0, 100.0)
    }
    
    init {
        factor = calibrationFactor.coerceAtLeast(0.01)
        println("Calibration ready: offset=$offset, factor=$factor")
    }
    
    fun calibrate(value: Double) = (value + offset) * factor
}

Оба параметра (rawOffset, calibrationFactor) используются только в блоках инициализации.

Почему это важно?

• Инкапсуляция: Параметры, не объявленные как свойства, скрыты от внешнего доступа.
• Производительность: Уменьшается overhead класса, так как не создаются лишние getter/setter методы.
• Чистота API: Внешний код видит только необходимый публичный интерфейс.
• Безопасность: Чувствительные данные (например, временные пароли) можно обработать в init без сохранения в свойствах.

Распространённые сценарии использования

• Валидация входных данных перед созданием объекта
• Вычисление производных значений на основе параметров конструктора
• Условная инициализация свойств в зависимости от параметров
• Регистрация объектов в фабриках или контейнерах зависимостей
• Отложенная инициализация части свойств с использованием временных параметров

Важное замечание

В Kotlin нет специального ключевого слова только для init. Вместо этого используется комбинация:

1. Объявление параметра без val/var
2. Использование только внутри init блоков или инициализаторов свойств
3. При необходимости — явные модификаторы видимости (private, internal)

Такой подход соответствует философии Kotlin — писать понятный и безопасный код с минимальным количеством избыточных ключевых слов.