学习：Kotlin中的JvmStatic注解

JvmStatic 是 Kotlin 中的一个注解（Annotation），专门用于标注在 Kotlin 对象（包括单例对象和伴生对象）中的方法或属性上，使其能够以类似 Java 静态成员的方式被 JVM 访问。

它的核心作用是消除 Kotlin 对象成员与 Java 静态成员之间的语法差异，让 Kotlin 代码在 Java 中调用时更符合 Java 的开发习惯。

基本定义与使用场景

Kotlin 的对象（object）和伴生对象（companion object）本质上是单例实例，其成员在 Kotlin 中通过对象实例访问（如 MyObject.method()）。

但在 Java 中，静态成员直接通过类名访问（如 MyClass.staticMethod()）。为了让 Kotlin 对象中的成员在 Java 中表现为静态成员，JvmStatic 注解被引入。

具体用法与效果

标注在伴生对象（companion object）的成员上

伴生对象是 Kotlin 中为类提供“静态-like”功能的机制（如工厂方法、常量）。

默认情况下，伴生对象的成员在 Java 中需要通过 Companion 接口访问（如 MyClass.Companion.create()）。

使用 @JvmStatic 后，这些成员可以直接通过类名访问，如同 Java 静态方法。

示例：

class MyClass {
    companion object {
        // 未使用 @JvmStatic：Java 中需通过 MyClass.Companion.getVersion()
        val version = "1.0"
        
        // 使用 @JvmStatic：Java 中可直接通过 MyClass.getVersion()
        @JvmStatic
        fun getVersion(): String = version
        
        // 未使用 @JvmStatic：Java 中需通过 MyClass.Companion.create()
        fun create(): MyClass = MyClass()
        
        // 使用 @JvmStatic：Java 中可直接通过 MyClass.create()
        @JvmStatic
        fun createInstance(): MyClass = MyClass()
    }
}

Java 调用效果：

// 未使用 @JvmStatic 的版本（需通过 Companion）
String version = MyClass.Companion.getVersion(); 
MyClass obj = MyClass.Companion.create();

// 使用 @JvmStatic 的版本（直接通过类名，类似 Java 静态方法）
String version = MyClass.getVersion(); 
MyClass obj = MyClass.createInstance(); 

标注在单例对象（object）的成员上

Kotlin 的单例对象（非伴生对象的独立对象）默认在 Java 中表现为一个单例实例（如 MySingleton.INSTANCE），其成员需通过该实例访问。

使用 @JvmStatic 后，成员可直接通过对象名访问，如同 Java 静态成员。

示例：

object MySingleton {
    private var count = 0
    
    // 未使用 @JvmStatic：Java 中需通过 MySingleton.INSTANCE.increment()
    fun increment() { count++ }
    
    // 使用 @JvmStatic：Java 中可直接通过 MySingleton.increment()
    @JvmStatic
    fun incrementCount() { count++ }
    
    // 未使用 @JvmStatic：Java 中需通过 MySingleton.INSTANCE.getCount()
    fun getCount(): Int = count
    
    // 使用 @JvmStatic：Java 中可直接通过 MySingleton.getCount()
    @JvmStatic
    fun getTotalCount(): Int = count
}

Java 调用效果：

// 未使用 @JvmStatic 的版本（需通过 INSTANCE）
MySingleton.INSTANCE.increment(); 
int count = MySingleton.INSTANCE.getCount();

// 使用 @JvmStatic 的版本（直接通过对象名，类似 Java 静态方法）
MySingleton.incrementCount(); 
int total = MySingleton.getTotalCount(); 

关键注意事项

• 仅对对象/伴生对象的成员有效：@JvmStatic 只能用于 object 或 companion object 内部的方法或属性，不能用于普通类（class）的成员。

• 属性与方法的差异：

• 对于方法：@JvmStatic 会让方法在 Java 中表现为静态方法（直接通过类名调用）。  

• 对于属性：@JvmStatic 会让属性的 getter/setter 方法在 Java 中表现为静态方法（如 Kotlin 的 val version 生成的 getVersion() 会变成静态方法）。

• 与 @JvmField 的区别：@JvmField 用于将对象中的属性暴露为 Java 静态字段（直接访问字段值），而 @JvmStatic 是将属性的访问器（getter/setter）暴露为静态方法。两者可配合使用，但场景不同。

总结

@JvmStatic 的核心价值是桥接 Kotlin 对象成员与 Java 静态成员的访问方式，提升跨语言调用的兼容性。

它让 Kotlin 的单例或伴生对象中的方法/属性在 Java 中调用时更符合 Java 开发者的直觉，避免了繁琐的 Companion 或 INSTANCE 中间层。