教你一文搞懂Kotlin中的Jvm注解

时间:2020-10-10 vivo祁同伟人气:3

JvmOverloads

创建一个kotlin的类

class Student(val name: String, val sex: Int = 1, val age: Int = 18)

可以看出来这个构造函数的参数是有默认值的，kotlin的特性对吧，我们在使用的时候可以方便的使用，比如：

 val student = Student("wuyue")
 val student2 = Student("wuyue", age = 18)

但是这个特性如果你用java来调用你就是失败的了。

注意看下面的方法调用是报错的，不能调，只能选择3个构造函数的方法。

那我一定要让java也可以调用怎么办？加上注解即可：

class Student @JvmOverloads constructor(val name: String, val sex: Int = 1, val age: Int = 18)

这个对于android程序员来说还是很重要的，比如我们自定义view中就需要这个注解，否则运行起来会因为找不到方法而报错的。

所以大家只要谨记一点： 当你的kotlin代码中的某个方法使用了默认参数值这个kotlin语言的特性并且这个方法还要给java代码调用的时候那你最好加上JvmOverloads 注解

JvmName

我们给String 增加一个扩展函数 StringsHelper.kt 文件

package com.test
fun String.appendUserName():String{
  return this+"wuyue"
}

在java的世界里怎么调用他呢？

StringsHelperKt.appendUserName("hello");

很好理解对吧，但是很多人都习惯于在java的世界中使用什么xxxUtils 去处理类似的情况。这个时候就要利用到这个JvmName了

@file:JvmName("StringsHelperUtils")
package com.test
fun String.appendUserName():String{
  return this+"wuyue"
}

如此一来我们在java的世界中调用他的方法就变成了

StringsHelperUtils.appendUserName("hello");

JvmMultifileClass

关于这个注解网上的说法是可以将2个kt文件里面的代码合并到一个java的class文件中。

FunA.kt

@file:JvmName("Utils")
@file:JvmMultifileClass

package com.test

fun one(){

}

FunB.kt

@file:JvmName("Utils")
@file:JvmMultifileClass

package com.test

fun two(){

}

这样在java世界中调用Utils这个类就有one和two 2个方法了，但是我自己的实验结果我就算去掉这个JvmMultifileClass 这个注解也一样可以达到效果。似乎这个注解并没有什么用？可能是1.3之后的kotlin版本优化了 JvmName的实现吧。这里有知道原因的大佬可以指点一下。

JvmField

还是前面这个Student的例子

class Student( val name: String, val sex: Int = 1, val age: Int = 18)

如果在java代码里你要调用他里面的属性只能通过get和set 来调用。但是如果你加上注解

class Student(@JvmField val name: String, val sex: Int = 1, val age: Int = 18)

那他在java的世界中就可以直接调用了

student.name="hello";

另外还有一个重要的作用是：在kotlin中， val 并不意味着是常量，只不过val 声明的变量是没有set方法的，只有get方法。所以给了你一个常量的错觉。你要真正的在kotlin中定义一个常量，只有两种方法：

在top-level或者object中使用 const val
或者使用 @JvmField val（这种方式定义的就是常量了，讲白了你也无法重写val的get方法了）

JvmStatic

class StaticTest{
  companion object{

    const val field1="111"
    
    val field2="222"
    
    @JvmField val field3="333"

    fun callNonStatic(){

    }
    @JvmStatic
    fun callStatic(){

    }
  }
}

我们看一下在java代码中怎么调用他们就知道这个注解的实际作用了

  StaticTest.callStatic();
    StaticTest.Companion.callNonStatic();
    String t1 = StaticTest.field1;
    String t2=StaticTest.Companion.getField2();
    String t3=StaticTest.field3;

JvmSynthetic

这个注解用的不多，但是kotlin的许多官方库会用到他讲白了如果你写的一个函数你只想给kotlin代码调用而不想给java的代码调用那你就在你的函数上面加上这个注解即可

例如：

@file:JvmName("StringsHelperUtils")
package com.test
@JvmSynthetic
fun String.appendUserName():String{
  return this+"wuyue"
}

这样你就会发现这个函数你用kotlin正常使用而java代码里StringsHelperUtils 这个类是没有这个方法的

加载全部内容