Как вызвать Kotlin extension functions из Java кода?

Правильный способ вызова Kotlin extension functions из Java

Вы столкнулись с классической проблемой совместимости Kotlin и Java. Extension functions в Kotlin — это синтаксический сахар, который на уровне байт-кода превращается в обычные статические методы. Java не знает о концепции "расширений", поэтому вам нужно вызывать их как статические методы вспомогательного класса.

Вот как это работает на практике. Для вашей функции addExclamation(), объявленной в файле StringExtensions.kt, Kotlin компилятор создаст Java-класс с именем StringExtensionsKt. Сам метод будет статическим и первым аргументом будет принимать объект, к которому вы применяете расширение (в вашем случае — String).

Правильный вызов из Java будет выглядеть так:

// Java
import com.example.utils.StringExtensionsKt;

public class Main {
    public static void main(String[] args) {
        String myString = "Hello";
        String result = StringExtensionsKt.addExclamation(myString);
        System.out.println(result); // Выведет: Hello!
    }
}

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

• Имя класса: По умолчанию это имя вашего Kotlin файла + суффикс Kt (например, StringExtensionsKt).
• Первый аргумент: Receiver (объект, на котором вызывается расширение) передаётся как первый параметр статического метода.
• Импорт: Вам нужно импортировать именно этот сгенерированный класс, а не исходный Kotlin-файл.

Улучшаем код с помощью аннотаций

Чтобы сделать код более читаемым и приблизить его к "нативному" виду, вы можете использовать аннотацию @JvmName. Она позволяет переименовать Java-класс или метод. А если вы хотите, чтобы функция была доступна как статический метод другого класса (например, StringUtils), используйте @JvmStatic внутри companion object.

Пример с @JvmName:

// Kotlin
@file:JvmName("StringUtils")
package com.example.utils

fun String.addExclamation(): String = "$this!"

// Java
import com.example.utils.StringUtils;

public class Main {
    public static void main(String[] args) {
        String result = StringUtils.addExclamation("Hi");
    }
}

Или вариант с companion object (удобно, если у вас есть класс с утилитами):

// Kotlin
class MyUtils {
    companion object {
        @JvmStatic
        fun String.addExclamation(): String = "$this!"
    }
}

// Java
String result = MyUtils.addExclamation("Test");

Важно: Не забывайте, что extension functions не являются частью класса, который они расширяют. Вы не сможете переопределить их в подклассах. С точки зрения Java это просто статические хелперы.

// Kotlin (расширение)
fun String.reverseWords(): String = this.split(" ").reversed().joinToString(" ")

// Java (обёртка)
public class StringHelper {
    public static String reverseWords(String input) {
        // Вызываем Kotlin extension
        return StringExtensionsKt.reverseWords(input);
    }
}

// Использование в Java
String result = StringHelper.reverseWords("Hello World");