Как extension функция под капотом понимает какой класс она расширяет в Kotlin

Как extension функции работают под капотом в Kotlin

Extension функции — это одна из самых элегантных фич Kotlin, которая позволяет добавлять методы к существующим классам без наследования. Но как компилятор понимает, какой класс расширяется?

Основной механизм

Extension функция — это обычная статическая функция, которая принимает экземпляр класса как первый параметр (получатель).

// Kotlin код
fun String.isEmail(): Boolean {
    return this.contains("@") && this.contains(".")
}

// Использование
val email = "test@example.com"
if (email.isEmail()) {
    println("Valid email")
}

После компиляции в Java bytecode это превращается в:

// Откомпилированный Java код
public static boolean isEmail(String $receiver) {
    return $receiver.contains("@") && $receiver.contains(".");
}

// Использование
String email = "test@example.com";
if (isEmail(email)) {
    System.out.println("Valid email");
}

Видишь? this превращается в параметр $receiver. Это ключевой момент!

Как компилятор определяет тип получателя

Компилятор использует информацию из сигнатуры функции:

fun String.isEmail(): Boolean {
    //  ^^^^^^
    //  Это тип получателя (receiver type)
}

Тип получателя явно указан перед точкой. Компилятор:

1. Парсит исходный код и видит String.
2. Запоминает, что это extension для String
3. При компиляции добавляет String как первый параметр
4. Переименовывает this в $receiver (или аналогичный параметр)

Пример с более сложным типом

// Extension для List
fun <T> List<T>.secondOrNull(): T? {
    return if (this.size > 1) this[1] else null
}

// Компилируется в примерно:
public static <T> T secondOrNull(List<T> $receiver) {
    return $receiver.size() > 1 ? $receiver.get(1) : null;
}

Получатель vs обычный параметр

Основное отличие — receiver функция может вызывать методы неявно через this:

fun String.toUpperCaseWords(): String {
    return this.split(" ")  // this указывает на String
        .joinToString(" ") { word -> word.uppercase() }
}

// vs обычная функция
fun toUpperCaseWords(str: String): String {
    return str.split(" ")
        .joinToString(" ") { word -> word.uppercase() }
}

Оба варианта работают одинаково, но первый синтаксически красивее.

Extension для собственных классов

data class User(val name: String, val age: Int)

fun User.isAdult(): Boolean {
    return this.age >= 18
}

// Компилируется в:
public static boolean isAdult(User $receiver) {
    return $receiver.getAge() >= 18;
}

Область видимости (Scope)

Важное правило: extension функция доступна только в том пакете, где она определена, или если её импортировать.

// В файле com/example/Extensions.kt
fun String.isEmail(): Boolean { ... }

// В другом файле нужно импортировать
import com.example.isEmail

// Или использовать с полным путём
com.example.isEmail("test@example.com")

Это важно, потому что extension функции не добавляют код в сам класс String — они живут отдельно.

Extension properties

Even более интересно — можно создавать extension свойства:

val String.isNumeric: Boolean
    get() = this.all { it.isDigit() }

// Использование
val text = "12345"
if (text.isNumeric) {
    println("Это число")
}

Под капотом это тоже static функция с getter:

public static boolean isNumeric(String $receiver) {
    return /* проверка цифр */;
}

Приоритет вызовов

Если в классе уже есть такой метод, member метод имеет приоритет:

fun String.length(): Int = 100  // Extension

val text = "hello"
println(text.length)  // Вернёт 5 (member), не 100 (extension)

Ключевые моменты

• Extension = static функция со скрытым параметром
• Receiver type указан явно в сигнатуре
• Компилятор превращает this в параметр
• Не добавляет код в класс — это статическая функция в отдельном месте
• Область видимости контролируется импортами
• Member методы приоритетнее extension функций
• Жизненно важно для читаемости — позволяет писать DSL и удобный API без наследования