Kotlin编程实践-【Java如何调用Kotlin中带默认值参数的函数】

问题

如果你有一个带有默认参数值的 Kotlin 函数，如何从 Java 调用它而无须为每个参数显式指定值？

方案

为函数添加注解@JvmOverloads。

也就是为Java添加重载方法，这样Java调用Kotlin的方法时就不用传递全部的参数了。

示例

在 Kotlin 中定义一个函数，函数指定了多个带默认值的参数，如下：

/**
 * kotlin中模拟定义一个addUser函数
 *
 * 参数 name 必需的，age 和 address有默认值， 其中address可空
 */
fun addUser(
    name: String,
    age: Int = 18,
    address: String? = null,
) {
    println("新增User, 信息如下:")
    println("name is $name, age is $age, address is $address")
    println("==================================")
}

在 Kotlin 中如果调用这个函数，可以指定一个、两个、三个参数来调用它，如下：

fun main() {
    // name必传, age 和 address 使用默认值
    addUser("张三")
    // address使用默认值
    addUser("李四", age = 20)
    // age使用默认值, address可空所以这里可以传递null
    addUser("王五", address = null)
    // 都不使用默认值
    addUser("赵六", 30, "北京")
}

执行结果如下：

新增User, 信息如下:
name is 张三, age is 18, address is null
==================================
新增User, 信息如下:
name is 李四, age is 20, address is null
==================================
新增User, 信息如下:
name is 王五, age is 18, address is null
==================================
新增User, 信息如下:
name is 赵六, age is 30, address is 北京
==================================

然而，Java方法不支持默认参数，所以当在Java中调用这个函数时，必须提供所有的参数，如下：

public static void main(String[] args) {
    // 缺少任何一个参数就会报错
    // KotlinDemoKt.addUser("java", 100);
    // 必须传递三个参数
    KotlinDemoKt.addUser("java", 100, null);
}

打印结果如下：

新增User, 信息如下:
name is java, age is 100, address is null
==================================

在这里插入图片描述
从截图中也可以看出，Java调用的时候，addUser方法需要传递三个参数才行。

如果将注解 @JvmOverloads 添加到函数中，生成的类将支持所有的函数重载。改造如下：
在这里插入图片描述
给 Kotlin 中定义的函数加上注解 @JvmOverloads ，此时再回到 Java 中调用发现：

此时 Java 中调用 Kotlin 的函数 addUser，就有了三个方法可调用了，这就是注解 @JvmOverloads 的作用，让它看起来就像是 Java 中的重载方法。