标记一个乐趣/财产仅用于 Kotlin / Java

Question

我目前正在写一个 KOTLIN class 我喜欢使用 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 的公共属性，当然反之亦然？

Answer 1

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

要从 kotlin 中隐藏 function，您可以将@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)

资源：

• 从 Kotlin 隐藏 static Java 方法
• @JvmSynthetic 在 Kotlin 中的预期用途是什么？

Answer 2

在 Kotlin 中不可能做这样的事情

val myClass = MyClass() { offset = 1 }

但我建议你改为这样做，在我看来它看起来好多了。

// It's a inline function so there's no runtime overhead.
inline fun buildMyClass(builder: MyClass.() -> Unit): MyClass {
    return MyClass().apply(builder)
}

class MyClass {

    @JvmSynthetic
    var offset: Int? = null
        private set

    fun withOffset(value: Int) = apply { offset = value }
}

所以你可以像下面这样称呼它

val myClass = buildMyClass {
   withOffset(0)
}

在 Java 中，它看起来像这样：

final MyClass myClass = new MyClass().withOffset(0);