高效的Kotlin——为可读性设计

为可读性设计(Design for readability)

可读性是一种半玄学的话题，它的评价标准常常取决于上下文环境和你对一门语言的了解程度。来看一个具体的例子：

// Implementation A
if (person != null && person.isAdult) {
    view.showPerson(person)
} else {
    view.showError()
}

// Implementation B
person?.takeIf { it.isAdult }
    ?.let(view::showPerson)
    ?: view.showError()

以上两种实现在表意上是完全等价的，那么你觉得哪种可读性更好呢？显然，不是代码越短可读性就越好，代码越简洁，往往需要我们载入更多的关于这门语言的“方言”，这些方言在特定实现下是提升了可读性还是降低了可读性，这是个玄学问题。仅就上述两种实现而言，作者和我都认为第一种可读性更高，第二种可读性差一下，但是更加“地道”（?. takeIf let ?:）。
命令式编程（A实现）是人们的直觉，也是所有编程语言的基础结构，国际通用语言；面向表达式编程（B实现）是特定编程语言的方言，更偏向于表述做什么而不是怎么做。两种编程方式都有其应用场景，合理使用都能提升代码的可读性。

现在假设需求变了，我们需要修改代码：

// Implementation A
if (person != null && person.isAdult) {
    view.showPerson(person)
    view.hideProgressWithSuccess()
} else {
    view.showError()
    view.hideProgress()
}

// Implementation B
person?.takeIf { it.isAdult }
    ?.let {
        view.showPerson(it)
        view.hideProgressWithSuccess()
    } ?: run {
        view.showError()
        view.hideProgress()
    }

显然A实现更加便于修改，并且表意也更加清晰。B实现不仅不便于修改，而且在此情形下，表意上与A实现也有细微差别（person == null情况下）。

以上例子仅仅是为了说明，在“这种情况”下，命令式编程可读性更强，并不是说命令式编程在任何情况下都优于表达式编程，表达式编程的主要应用场景在于各种“流”的操作上：

students
    .filter { it.pointsInSemester > 15 && it.result >= 50 }
    .sortedWith(compareBy({ it.surname }, { it.name }))
    .joinToString(separator = "\n") {
        "${it.name} ${it.surname}, ${it.result}"
    }
    .let(::print)

var obj = FileInputStream("/file.gz")
    .let(::BufferedInputStream)
    .let(::ZipInputStream)
    .let(::ObjectInputStream)
    .readObject() as SomeObject

典型的“流”就如上述例子给出的那样：集合和各种Stream（肯定还有更多其它类型的流，我暂时也想不起来）。Kotlin标准库定义在集合上的扩展函数的数量我就不必赘述了，它们都为面向表达式编程提供了非常好的条件；而各种Stream的层层包装自然也是面向表达式编程很好的应用场景。
流与表达式的结合可以大大提升代码的可读性，流本身的步骤性与表达式简洁性的结合相得益彰。这种结合可能不利于debug，不利于Kotlin初学者，但是平衡了所得与所失之后，仍然推荐上述编程方式。

最后编辑于：2021.02.22 18:38:05