Kotlin之@JvmOverloads、@JvmStatic、@JvmField、@JvmInline等注解使用总结

写在前面

Kotlin代码可以经过编译器转换成VM虚拟机能识别的字节码，所以Java与Kotlin可以互相进行调用。而由于Java与Kotlin语言特性的差异，当Java调用Kotlin代码时，可以在Kotlin代码中适当增加一些注解，从而更方便的调用Kotlin代码。

@JvmOverloads

在Kotlin的方法里有多个默认参数时，如果在Java中直接调用，只能调用一个包含完整参数的方法，如果想暴露更多的重载函数给Java，可以使用@JvmOverloads 用于生成重载。对于每一个有默认值的参数，生成的重载会把当前有默认值的参数及其右边的参数都去掉，所以如果方法中所有的参数都有默认值，生成的重载函数中还会有一个无参的重载函数。

@JvmOverloads 主要用于构造函数、方法中，同时不能用于抽象方法、接口中的方法等。

• 应用在方法中

 @JvmOverloads
 fun method(a: Int, b: Boolean = true, c: String = "c") {
 }

转换成Java后：

   //1
   @JvmOverloads
   public final void method(int a, boolean b, @NotNull String c) {
      Intrinsics.checkNotNullParameter(c, "c");
   }

  //2
   @JvmOverloads
   public final void method(int a, boolean b) {
      method$default(this, a, b, (String)null, 4, (Object)null);
   }

  //3
   @JvmOverloads
   public final void method(int a) {
      method$default(this, a, false, (String)null, 6, (Object)null);
   }

   //4: synthetic method
   public static void method$default(KtAnnotation var0, int var1, boolean var2, String var3, int var4, Object var5) {
      if ((var4 & 2) != 0) {
         var2 = true;
      }
      if ((var4 & 4) != 0) {
         var3 = "c";
      }
      var0.method(var1, var2, var3);
   }

• 应用在自定义View构造函数中

class VpLoadMoreView @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null,
    defStyle: Int = 0,
) : LinearLayout(context, attrs, defStyle) {}

转换成Java代码后：

public final class VpLoadMoreView extends LinearLayout {
   
   //1
   @JvmOverloads
   public VpLoadMoreView(@NotNull Context context) {
      this(context, (AttributeSet)null, 0, 6, (DefaultConstructorMarker)null);
   }

   //2
   @JvmOverloads
   public VpLoadMoreView(@NotNull Context context, @Nullable AttributeSet attrs) {
      this(context, attrs, 0, 4, (DefaultConstructorMarker)null);
   }
 
   //3
   @JvmOverloads 
   public VpLoadMoreView(@NotNull Context context, @Nullable AttributeSet attrs, int defStyle) {
      Intrinsics.checkNotNullParameter(context, "context");
      super(context, attrs, defStyle);
   }

   //4: synthetic method
   public VpLoadMoreView(Context var1, AttributeSet var2, int var3, int var4, DefaultConstructorMarker var5) {
      if ((var4 & 2) != 0) {
         var2 = (AttributeSet)null;
      }
      if ((var4 & 4) != 0) {
         var3 = 0;
      }
      this(var1, var2, var3);
   }
}

如果将注解去掉，转换成Java后：

public final class VpLoadMoreView extends LinearLayout {

   //1
   public VpLoadMoreView(@NotNull Context context, @Nullable AttributeSet attrs, int defStyle) {
      Intrinsics.checkNotNullParameter(context, "context");
      super(context, attrs, defStyle);
   }

   //2: synthetic method
   public VpLoadMoreView(Context var1, AttributeSet var2, int var3, int var4, DefaultConstructorMarker var5) {
      if ((var4 & 2) != 0) {
         var2 = (AttributeSet)null;
      }
      if ((var4 & 4) != 0) {
         var3 = 0;
      }
      this(var1, var2, var3);
   }
}

可以看到去掉了@JvmOverloads 注解，少了1个、2个参数的构造函数了，那么在Java中也不能初始化1个、2个参数的构造函数了。

@JvmStatic

@JvmStatic用于声明静态方法。在具名对象及伴生对象中使用时，既会在相应对象的类中生成静态方法，也会在对象自身中生成实例方法，如：

class KtA {
    companion object {
        @JvmStatic
        fun invokeStatic() {}

        fun invokeNoStatic() {}
    }
}

在Java中调用：

 public void invokeKt() {
     KtA.invokeStatic(); //正确，可以直接调用
     //KtA.invokeNoStatic(); //错误，这里调用不到
     KtA.Companion.invokeStatic(); //正确
     KtA.Companion.invokeNoStatic(); //正确
 }

@JvmField

@JvmField使得编译器不再对该字段生成getter/setter并将其作为公开字段，如：

 val id1 = 100 //1
 
 @JvmField 
 val id2 = 200 //2

 var id3 = 300 //3
 
 @JvmField 
 var id4 = 400 //4

编译成Java后：

 private final int id1 = 100;
 @JvmField
 public final int id2 = 200;
 private int id3 = 300;
 @JvmField
 public int id4 = 400;

 public final int getId1() {
    return this.id1;
 }

 public final int getId3() {
    return this.id3;
 }

 public final void setId3(int var1) {
    this.id3 = var1;
 }

@JvmSynthetic

@JvmSynthetic可以修饰于方法上，控制只能在Kotlin中调用，如：

//kt代码
class KtA {
    @JvmSynthetic
    fun visit() {}
}

Java中调用：

 public void invokeKt() {
     KtA clz = new KtA();
     clz.visit(); //错误，这里在Java中调用不到。
 }

如果想在Java中调用到Kotlin类中的方法，将@JvmSynthetic去掉即可。

@JvmName 、@JvmMultifileClass

@JvmName 注解可以生成类名；如果类名已存在，可以修改已生成的 Java 类的类名。
包名相同并且类名相同或者有相同的 @JvmName 注解有会错误，可以通过@JvmMultifileClass把他们合并到一起，如：

//A.kt
@file:JvmName("generate")
@file:JvmMultifileClass
package org.ninetripods
fun getA() {}

//B.kt
@file:JvmName("generate")
@file:JvmMultifileClass
package org.ninetripods
fun getB() {}

Java中调用：

org.ninetripods.generate.getA();
org.ninetripods.generate.getB();

@JvmInline

@Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.RUNTIME)
@MustBeDocumented
@SinceKotlin("1.5")
public actual annotation class JvmInline

@JvmInline在1.5.0版本引入，可以指定一个类为内联类，需结合value一起使用；在1.5.0之前使用inline关键字。

//1.5.0之前，inline标记内联类
inline class Person(private val name: String = "")

//1.5.0之后，@JvmInline + value 标记内联类
@JvmInline
value class Person(private val name: String = "")

内联类构造参数中有且只能有一个成员变量，最终被内联到字节码中的value。，上述代码经过内联优化会在字节码中将Person对象转换为String值，从而由堆分配优化为栈分配。