@JvmOverloads 介绍
Kotlin
@Target([AnnotationTarget.FUNCTION, AnnotationTarget.CONSTRUCTOR]) annotation class JvmOverloads
kotlin官方对于kotlin @JvmOverloads 作用的解释, 中文翻译如下:
指示Kotlin编译器为该函数生成替代默认参数值的重载。
如果一个方法有N个参数,其中M个参数有默认值,那么就会生成M个重载。:第一个方法有N-1个参数,第二个方法有N-2个参数,依此类推(除了最后一个方法都有默认值)。
为什么用@JvmOverloads
通过以上代码我们明白了 @JvmOverloads
的作用,但是我们在使用kotlin编写代码时候。似乎@JvmOverloads
对我们的编码毫无影响,我们为什么要加上它呢?这其实主要是为了在java中调用kotlin代码的时候能够使用,如果不加 @JvmOverloads
, 当我们想要在Java中调用kotlin的方法时,是必须输入所有参数的值得,kotlin中默认参数我们无法使用。而当加上 @JvmOverloads
,kotlin编译器生成的字节码中有对应的重载方法,我们就可以通过Java的重载方式来使用kotlin的代码了,不必要输入所有的参数。
@JvmOverloads 使用范围
kotlin中 构造函数、顶级函数、类中方法,静态方法(@Jvmstatic修饰) 均可以采用@JvmOverloads
生成对应重载方法。
在主构造函数使用重载函数,效果如下
koltin:
Kotlin
class People @JvmOverloads constructor(age:Int=0,name:String,sex:String="男"){
}
java:
java
public final class People {
@JvmOverloads
public People(int age, @NotNull String name, @NotNull String sex) {
Intrinsics.checkParameterIsNotNull(name, "name");
Intrinsics.checkParameterIsNotNull(sex, "sex");
super();
}
// $FF: synthetic method
public People(int var1, String var2, String var3, int var4, DefaultConstructorMarker var5) {
if ((var4 & 1) != 0) {
var1 = 0;
}
if ((var4 & 4) != 0) {
var3 = "男";
}
this(var1, var2, var3);
}
@JvmOverloads
public People(int age, @NotNull String name) {
this(age, name, (String)null, 4, (DefaultConstructorMarker)null);
}
@JvmOverloads
public People(@NotNull String name) {
this(0, name, (String)null, 5, (DefaultConstructorMarker)null);
}
}
总结
就是koltin为了给java 重载。