问题
如果你有一个带有默认参数值的 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可空所以这里可以传递nulladdUser("王五", 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 中的重载方法。
同样可以对 Kotlin 中的构造函数做出这样的操作,如下,在 Person 类中生成三个构造方法:
Kotlin 中的类此时没有添加注解 @JvmOverloads , 所以 Java 创建类对象的时候,还是必须要传递三个参数的初始值。
加上注解之后,如下:
如上,Java 中实例化类可以使用不同参数完成了。
注意:Kotlin 中的主构造函数,没有注解和修饰符的时候,可以省略关键字 constructor,但因为此时有注解 @JvmOverloads,所以需要加上关键字 constructor。