首先,要回答实际上 是
什么综合方法,让我们看一下Java语言规范:
11. 如果Java编译器发出的构造与源代码中显式或隐式声明的构造不对应,则必须将其标记为 合成
,除非发出的构造是类初始化方法(JVMS§2.9)。
该
@JvmSynthetic注释正是这么做的:防止源代码的访问。该方法仍会反射显示,然后标记为合成。
更准确地说,从Kotlin文档(重点是我的):
@JvmSyntheticACC_SYNTHETIC在Java字节码中带注释的目标上设置标志。合成目标在编译时对于Java源变得不可访问,而对于Kotlin源仍可访问。
将目标标记为合成是二进制兼容的更改,已经编译的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



