Что означает оператор `::` в Kotlin? Объясните на примерах

Что такое оператор :: в Kotlin?

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

1. Ссылка на функцию (Function Reference)

Когда вы пишете ::handleClick, вы создаете объект типа KFunction1 — ссылку на функцию, которую можно передать как параметр.

// Функция верхнего уровня
fun handleClick(view: View) { /* ... */ }

// Использование :: 
val onClick: (View) -> Unit = ::handleClick

// Эквивалентная лямбда:
val onClick2: (View) -> Unit = { view -> handleClick(view) }

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

2. Ссылка на метод класса (Bound vs Unbound)

Есть два варианта:

• Непривязанная ссылка (unbound) — требует экземпляр класса при вызове:

class User(val name: String) {
    fun isAdult(age: Int): Boolean = age >= 18
}

val ref = User::isAdult  // тип: (User, Int) -> Boolean
val result = ref(User("Alice"), 20) // true

• Привязанная ссылка (bound) — уже содержит экземпляр:

val user = User("Bob")
val boundRef = user::isAdult  // тип: (Int) -> Boolean
val result = boundRef(25)     // true

3. Ссылка на свойство (Property Reference)

Можно ссылаться на свойства, получая их getter/setter как функции:

data class Person(val name: String, var age: Int)

val names = listOf(Person("Alice", 30), Person("Bob", 25))
val nameList = names.map(Person::name) // ["Alice", "Bob"]

// Ссылка на изменяемое свойство (getter + setter)
val ageRef = Person::age
val person = Person("Charlie", 40)
println(ageRef.get(person)) // 40
ageRef.set(person, 41)

В Android это часто используется для binding-свойств в DataBinding или ViewBinding:

// В адаптере RecyclerView
fun bind(person: Person) {
    itemView.nameText.text = person.name
    // Можно передать ссылку на свойство в слушатель
    itemView.button.setOnClickListener { 
        // используем :: для доступа к свойству
        person::age
    }
}

4. Ссылка на конструктор (Constructor Reference)

Самый полезный кейс — создание экземпляров через фабрики:

class Person(val name: String)

// Ссылка на конструктор
val factory: (String) -> Person = ::Person
val person = factory("Alice")

// Реальный пример из Android — создание ViewModel
val viewModel: MyViewModel by viewModels()
// В некоторых DI-фреймворках:
val provider: () -> MyViewModel = ::MyViewModel

Вместо лямбды { name -> Person(name) } можно писать просто ::Person.

5. Когда использовать :: вместо лямбды?

6. Пример из Android-разработки

// Вместо:
button.setOnClickListener { view -> handleClick(view) }

// Пишем:
button.setOnClickListener(::handleClick)

// В Compose:
Button(onClick = ::onSaveClick) { Text("Save") }

// Фильтрация списка:
val nonEmptyStrings = list.filter(String::isNotEmpty)
// вместо:
val nonEmptyStrings2 = list.filter { it.isNotEmpty() }

Итог: :: — это мощный инструмент для передачи функций, свойств и конструкторов как объектов. Он делает код декларативнее и уменьшает шум от лишних фигурных скобок. Начинайте с простых случаев (ссылки на функции верхнего уровня), а затем переходите к более сложным (ссылки на свойства и конструкторы).

// Получение имени свойства через рефлексию
val property = Person::name
println(property.name) // "name"

// Проверка аннотаций
val annotations = property.annotations