Как настроить интеграцию Kotlin с Java проектами?

Для интеграции Kotlin с существующим Java-проектом необходимо:

1. Добавить зависимости Kotlin в проект: В зависимости от системы сборки (Gradle, Maven), добавить плагин и стандартную библиотеку Kotlin.

   Пример для Gradle (в build.gradle модуля):

   plugins {
       id 'org.jetbrains.kotlin.jvm' version '<последняя версия kotlin>'
   }
   
   sourceSets {
       main {
           kotlin {
               srcDirs 'src/main/kotlin' // Добавить каталог для Kotlin исходников
           }
       }
   }
   
   dependencies {
       implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:<последняя версия kotlin>"
       // Другие зависимости
   }
   

2. Настроить каталоги с исходным кодом: Создать каталог для Kotlin-файлов, например, src/main/kotlin, рядом с src/main/java. Система сборки должна быть настроена на поиск исходников в обоих каталогах.

3. Писать Kotlin-классы: Создавать новые классы на Kotlin. Они смогут без проблем вызывать существующий Java-код.

4. Вызывать Kotlin-код из Java: Kotlin-классы и функции могут быть легко вызваны из Java. Компилятор Kotlin генерирует байткод, который полностью совместим с JVM. Функции верхнего уровня в Kotlin компилируются в статические методы Java-класса с постфиксом Kt (по умолчанию имя файла). @JvmName и @JvmOverloads можно использовать для настройки видимости и сигнатур в Java.

   Пример (Kotlin):

   // MyKotlinFile.kt
   package com.example
   
   fun greet(name: String) {
       println("Hello, $name!")
   }
   
   class MyKotlinClass {
       fun sayGoodbye() {
           println("Goodbye!")
       }
   }
   

   Пример (Java):

   // MyJavaClass.java
   package com.example;
   
   public class MyJavaClass {
       public static void main(String[] args) {
           // Вызов функции верхнего уровня из Kotlin
           MyKotlinFileKt.greet("World");
   
           // Вызов метода из Kotlin-класса
           MyKotlinClass kotlinObject = new MyKotlinClass();
           kotlinObject.sayGoodbye();
       }
   }
   

5. Конвертировать существующий Java-код: IDE (например, IntelliJ IDEA) предоставляют средства для автоматической конвертации Java-классов в Kotlin. Это полезно для постепенного перехода.

6. Обработать @Nullable и @NotNull: Kotlin различает nullable и non-nullable типы. Аннотации @Nullable и @NotNull из Java (например, из JSR-305, Android, Guava) используются компилятором Kotlin для вывода информации о nullability. Код Kotlin, вызывающий Java, должен учитывать потенциальную nullability возвращаемых значений аннотированных методов.