java - 标记一个 fun/property 仅在 Kotlin/Java 中使用

Question

我目前正在编写一个 KOTLIN 类，我喜欢使用 DSL 的可能性，但要向后兼容 JAVA 开发人员。使用 var 时，编译器会自动为 JAVA 创建 getter 和 setter，但不能使用 Builder 样式，因为它们不会返回 this。

基本上我喜欢做的是这样的:

class MyClass {
    // for use in KOTLIN only DSL style e.g. MyClass() { offset = 1 }
    var offset: Int? = null

    // for use in JAVA only BUILDER style e.g. new MyClass().withOffset(1)
    fun withOffset(value: Int) = apply { offset = value }
}

在 Kotlin 中我喜欢使用，但不想访问 withOffset 的乐趣:

val myClass = MyClass() { offset = 1 }

在 JAVA 中我喜欢使用，但不想访问自动创建的 setOffset 和 getOffset:

MyClass myClass = new MyClass().withOffset(1)

已经可以通过 @JvmName 注释重命名 getter 和 setter，但是是否有注释可以完全隐藏 JAVA 的公共(public)属性，当然反之亦然？

Answer 1

您不能隐藏构造函数，但可以使用 operator fun invoke 创建一个所谓的伪构造函数，您可以在其中使用 @JvmSyntheic注释以将其隐藏在 java 中。

要对 kotlin 隐藏函数，您可以使用 @Deprecated与 DeprecationLevel.HIDDEN .

注意:@JvmField将指示编译器不要为您的 var 生成默认的 getter 和 setter

class MyClass {
    @JvmField
    var offset: Int? = null

    @kotlin.Deprecated(message = "JUST FOR JAVA", level = DeprecationLevel.HIDDEN)
    fun withOffset(value: Int) = apply { offset = value }

    companion object {
        @JvmSynthetic
        operator fun invoke(init: MyClass.() -> Unit) = MyClass().apply(init)
    }
}

在 Kotlin 中的用法:

MyClass() { offset = 1 }
// or
MyClass { offset = 1 }

Java 中的用法:

MyClass().withOffset(1)

资源:

• Hide static Java methods from Kotlin
• What's the intended use of @JvmSynthetic in Kotlin?