Hogyan állítható be a Kotlin és a Java projektek integrációja?

A Kotlin és egy meglévő Java-projekt integrálásához szükséges:

1. Kotlin függőségek hozzáadása a projekthez: A build rendszer (Gradle, Maven) szerint adjuk hozzá a plugint és a Kotlin alapkönyvtárat.

   Példa Gradle esetén (a build.gradle modulban):

   plugins {
       id 'org.jetbrains.kotlin.jvm' version '<legújabb Kotlin verzió>'
   }
   
   sourceSets {
       main {
           kotlin {
               srcDirs 'src/main/kotlin' // Katalógus hozzáadása Kotlin forrásoknak
           }
       }
   }
   
   dependencies {
       implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:<legújabb Kotlin verzió>"
       // Egyéb függőségek
   }
   

2. Forráskatalógusok konfigurálása: Hozzon létre egy Kotlin fájlokat tartalmazó könyvtárat, például src/main/kotlin, a src/main/java mellett. A build rendszernek mindkét könyvtárban keresnie kell a forrásokat.

3. Kotlin osztályok írása: Új Kotlin osztályokat hozzon létre. Ezek problémamentesen hívhatják a meglévő Java kódot.

4. Kotlin kód hívása Java-ból: A Kotlin osztályokat és függvényeket könnyen lehet Java-ból hívni. A Kotlin fordító generál olyan bytecode-ot, ami teljesen kompatibilis a JVM-mel. A Kotlin felső szintű függvényei a Kt suffix-szel (alapértelmezett) fordulnak Java statikus metódusokká (fájl név alapján). A @JvmName és @JvmOverloads annotációk segítségével beállítható a láthatóság és a szignatúrák.

   Példa (Kotlin):

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

   Példa (Java):

   // MyJavaClass.java
   package com.example;
   
   public class MyJavaClass {
       public static void main(String[] args) {
           // Felső szintű függvény hívása Kotlin-ból
           MyKotlinFileKt.greet("World");
   
           // Kotlin osztály metódusának hívása
           MyKotlinClass kotlinObject = new MyKotlinClass();
           kotlinObject.sayGoodbye();
       }
   }
   

5. Meglévő Java kód konvertálása: Az IDE-k (például IntelliJ IDEA) kínálnak eszközöket a Java osztályok automatikus Kotlin-re való konvertálására. Ez hasznos a fokozatos átálláshoz.

6. @Nullable és @NotNull kezelése: A Kotlin megkülönbözteti a nullable és nem-nullable típusokat. A Java-ból származó @Nullable és @NotNull annotációk (pl. JSR-305, Android, Guava) a Kotlin fordítójától származó nullability információk kinyerésére szolgálnak. A Kotlin kód, ami Java-t hív, figyelembe kell vegye az annotált metódusok visszatérési értékeinek potenciális nullability-ját.