静态编程语言顶层函数vs对象函数

Question

我有静态函数，它仅限于一些上下文（例如仅用于文档）。有两种替代方法可以将其定义为顶层函数或对象中的函数。

1.

package com.armsoft.mtrade.data.pref

import com.armsoft.mtrade.App
import com.armsoft.mtrade.domain.model.DocSaveType

object DocPrefManager {
    private const val DOC_PREF = "DOC_PREF"

    private const val KEY_ORDER_SAVE_TYPE = "KEY_ORDER_SAVE_TYPE"

    @JvmStatic
    fun setOrderSaveType(orderSaveType: DocSaveType) {
        val context = App.getContext()
        val sharedPreferences = context.getSharedPreferences(DOC_PREF, 0)
        val editor = sharedPreferences.edit()
        editor.putString(KEY_ORDER_SAVE_TYPE, orderSaveType.getCode())
        editor.commit()
    }
}

2.

package com.armsoft.mtrade.data.pref

import com.armsoft.mtrade.App
import com.armsoft.mtrade.domain.model.DocSaveType

fun setOrderSaveType(orderSaveType: DocSaveType) {
    val context = App.getContext()
    val sharedPreferences = context.getSharedPreferences(DocPrefManager.DOC_PREF, 0)
    val editor = sharedPreferences.edit()
    editor.putString(DocPrefManager.KEY_ORDER_SAVE_TYPE, orderSaveType.getCode())
    editor.commit()
}

顶级函数的优点是它没有被包装在一个对象中，缺点是它可以从任何地方访问，没有类名前缀。这种情况有优点还是缺点或最佳实践？

Answer 1

KotlinConf 2017——你可以，但你应该吗？Mike Gouline建议我们应该谨慎使用顶级函数，因为它可能会导致“自动完成污染”。

但是，顺便说一句，安德烈·布雷斯拉夫（Andrey Breslav）认为顶级功能是他在2018年KotlinConf大会上最喜欢的语言功能——关闭面板。

Answer 2

多模块项目提示：

使用内部可见性修饰符将顶级函数限定为其包含的模块，这样它就不会污染不相关模块中的IDE自动完成。

// module A
internal fun doSomething() {
    // ...
}

// module B
doSomething() // (!) Cannot access 'doSomething': it is internal in module A
              // Does NOT show up in module B's auto-complete

Answer 3

建议的做法是永远不要使用对象来创建名称空间，并且在可能的情况下始终使用顶级声明。我们还没有发现名称冲突是一个问题，如果确实发生冲突，可以使用带别名的导入来解决。