JavaからKotlinのデフォルト値を持つクラス、または関数を呼び出せるようにするアノテーション。

Javaでデフォルト値はサポートされていないため、以下のGreeting#sayHelloを呼び出すとコンパイルエラーになります。

NG

class Greeting {

    fun sayHello(prefix: String = "Mr.", name: String) {
        println("Hello, $prefix $name")
    }
}

public class JavaClass {
    public static void main(String[] args) {
        Greeting greeting = new Greeting();
    // prefixを引数に渡していないのでエラーになる。
        greeting.sayHello("Bob");
    }
}

Greeting#sayHelloに@JvmOverloadsを付与することで、Javaからデフォルト値を持つ関数を呼び出せるようになります。

OK

class Greeting {
    @JvmOverloads
    fun sayHello(prefix: String = "Mr.", name: String) {
        println("Hello, $prefix $name")
    }
}

public class JavaClass {
    public static void main(String[] args) {
        Greeting greeting = new Greeting();
        greeting.sayHello("Bob");
    }
}

NG

OK

参考