@JvmSynthetic在Kotlin中的预期用途是什么?

@JvmSynthetic在kotlin-stdlib中遇到了注解,我想知道它是做什么用的,但是不幸的是,它没有记录。(UPD:那时)

据我了解,将其应用于程序元素会将synthetic修饰符添加到相应的字节码元素中。结果,该元素在Java中变得不可见:

class MyClass {

@JvmSynthetic

fun f() { }

}

Java代码中的某处:

MyClass c = new MyClass();

c.f() // Error: cannot resolve method f()

但是相同的元素在Kotlin代码中仍然可见:

val c = MyClass()

c.f() // OK

隐藏来自非Kotlin来源的声明是否有效使用@JvmSynthetic?它是预期用途吗?还有哪些其他合适的用例?

由于@JvmSynthetic从Java隐藏函数,因此它们在Java中也不能被覆盖(当涉及到abstract成员时,调用将导致AbstractMethodError)。鉴于此,我@JvmSynthetic可以禁止在Java源代码中禁止重写Kotlin类的成员吗?

回答:

首先,要回答实际上

什么综合方法,让我们看一下Java语言规范:

如果Java编译器发出的构造与源代码中显式或隐式声明的构造不对应,则必须将其标记为 合成

,除非发出的构造是类初始化方法(JVMS§2.9)。

@JvmSynthetic注释正是这么做的:防止源代码的访问。该方法仍会反射显示,然后标记为合成。

更准确地说,从Kotlin文档(重点是我的):

@JvmSynthetic

ACC_SYNTHETIC在Java字节码中带注释的目标上设置标志。

将目标标记为合成是二进制兼容的更改,已经编译的Java代码将能够访问该目标。

此注释适用于 极少数 情况,当API设计人员需要从Java API中隐藏Kotlin特定的目标,同时又将其保留为Kotlin

API的一部分时,因此生成的API都是惯用的。

如上一段所述,这@JvmSynthetic是用于API设计的工具,它使库编写者可以避免自动生成Java等价物。可能最流行的用例是仅Kotlin的功能,例如运算符重载,componentN()方法或属性,在Java中可能具有更惯用的方式。

值得注意的是,此批注的目标是属性设置器/获取器,函数和字段-基本上所有将Java转换为方法的东西。

@Target([

AnnotationTarget.FUNCTION,

AnnotationTarget.PROPERTY_GETTER,

AnnotationTarget.PROPERTY_SETTER,

AnnotationTarget.FIELD])

annotation actual class JvmSynthetic

以上是 @JvmSynthetic在Kotlin中的预期用途是什么? 的全部内容, 来源链接: utcz.com/qa/432078.html

回到顶部