How to set up Kotlin integration with Java projects?

To integrate Kotlin with an existing Java project:

1. Add Kotlin dependencies to the project: Depending on your build system (Gradle, Maven), add the plugin and the Kotlin standard library.

   Example for Gradle (in build.gradle of the module):

   plugins {
       id 'org.jetbrains.kotlin.jvm' version '<latest kotlin version>'
   }
   
   sourceSets {
       main {
           kotlin {
               srcDirs 'src/main/kotlin' // Add directory for Kotlin sources
           }
       }
   }
   
   dependencies {
       implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:<latest kotlin version>"
       // Other dependencies
   }
   

2. Configure source code directories: Create a directory for Kotlin files, for example, src/main/kotlin, alongside src/main/java. The build system should be configured to look for sources in both directories.

3. Write Kotlin classes: Create new classes in Kotlin. They can call existing Java code without issues.

4. Call Kotlin code from Java: Kotlin classes and functions can be easily called from Java. The Kotlin compiler generates bytecode that is fully compatible with JVM. Top-level functions in Kotlin are compiled into static methods of a Java class with the suffix Kt (by default, the filename). @JvmName and @JvmOverloads can be used to customize visibility and signatures in Java.

   Example (Kotlin):

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

   Example (Java):

   // MyJavaClass.java
   package com.example;
   
   public class MyJavaClass {
       public static void main(String[] args) {
           // Call top-level function from Kotlin
           MyKotlinFileKt.greet("World");
   
           // Call method from Kotlin class
           MyKotlinClass kotlinObject = new MyKotlinClass();
           kotlinObject.sayGoodbye();
       }
   }
   

5. Convert existing Java code: IDEs (like IntelliJ IDEA) provide tools for automatic conversion of Java classes to Kotlin. This is useful for gradual migration.

6. Handle @Nullable and @NotNull: Kotlin distinguishes between nullable and non-nullable types. Annotations @Nullable and @NotNull from Java (e.g., from JSR-305, Android, Guava) are used by the Kotlin compiler to infer nullability information. Kotlin code calling Java should consider potential nullability of returned values from annotated methods.