Ako nakonfigurovať integráciu Kotlin s Java projektmi?

Pre integrácie Kotlinu s existujúcim Java projektom je potrebné:

1. Pridať závislosti Kotlin do projektu: V závislosti od systému zostavovania (Gradle, Maven) pridať plugin a štandardnú knižnicu Kotlin.

   Príklad pre Gradle (v build.gradle modulu):

   plugins {
       id 'org.jetbrains.kotlin.jvm' version '<posledná verzia kotlin>'
   }
   
   sourceSets {
       main {
           kotlin {
               srcDirs 'src/main/kotlin' // Pridať adresár pre Kotlin zdrojové kódy
           }
       }
   }
   
   dependencies {
       implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:<posledná verzia kotlin>"
       // Iné závislosti
   }
   

2. Nastaviť adresáre so zdrojovým kódom: Vytvoriť adresár pre Kotlin súbory, napríklad src/main/kotlin, vedľa src/main/java. Systém zostavovania by mal byť nakonfigurovaný na vyhľadávanie zdrojových kódov v oboch adresároch.

3. Písať Kotlin triedy: Vytvárať nové triedy v Kotlin. Môžu bez problémov volať existujúci Java kód.

4. Volanie Kotlin kódu z Java: Kotlin triedy a funkcie môžu byť ľahko volané z Java. Kotlin kompilátor generuje bytecode, ktorý je úplne kompatibilný s JVM. Funkcie na úrovni vrchu v Kotlin sa kompilujú do statických metód Java triedy s príponou Kt (predvolené meno súboru). @JvmName a @JvmOverloads možno použiť na nastavenie viditeľnosti a signatúr v Java.

   Príklad (Kotlin):

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

   Príklad (Java):

   // MyJavaClass.java
   package com.example;
   
   public class MyJavaClass {
       public static void main(String[] args) {
           // Volanie funkcie na úrovni vrchu z Kotlinu
           MyKotlinFileKt.greet("World");
   
           // Volanie metódy z Kotlin triedy
           MyKotlinClass kotlinObject = new MyKotlinClass();
           kotlinObject.sayGoodbye();
       }
   }
   

5. Konvertovať existujúci Java kód: IDE (napríklad IntelliJ IDEA) poskytujú nástroje na automatickú konverziu Java tried do Kotlinu. Je to užitočné pre postupný prechod.

6. Spracovať @Nullable a @NotNull: Kotlin rozlišuje nullable a non-nullable typy. Anotácie @Nullable a @NotNull z Java (napríklad z JSR-305, Android, Guava) sú používané Kotlin kompilátorom na odvodenie informácií o nullability. Kotlin kód volajúci Java by mal brať do úvahy potenciálnu nullability vracaných hodnôt anotovaných metód.