@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