可预测性

默认完整正确的功能

val client = HttpClient(CIO)
val response: HttpResponse = client.get("https://ktor.io/")

提供扩展能力

val client = HttpClient(CIO) {
    install(ContentNegotiation) {
        json(Json {
            prettyPrint = true
            isLenient = true
        })
    }
}

防止不期望的和不正确的扩展

例如, 在将数据与 JSON 进行相互转换时, 输出格式只支持 6 种类型: object, array, number, string, boolean, 和 null.

如果你创建一个 open 的类或接口, 名为 JsonElement, 使用者就可以创建不正确的派生类型, 例如 JsonDate. 相反, 你可以将 JsonElement 定义为封闭接口, 并为每种类型提供一个实现:

sealed interface JsonElement

class JsonNumber(val value: Number) : JsonElement
class JsonObject(val values: Map<String, JsonElement>) : JsonElement
class JsonArray(val values: List<JsonElement>) : JsonElement
class JsonBoolean(val value: Boolean) : JsonElement
class JsonString(val value: String) : JsonElement
object JsonNull : JsonElement

封闭类型还能够让编译器确保你的 when 表达式穷尽了所有的可能分支, 因此不需要提供 else 语句, 这样就提高了可读性和一致性.

不要暴露可变的状态

编译器会对 vararg 参数自动执行这种制造防御性的 copy 的策略. 如果使用展开(spread)操作符, 在需要 vararg 参数的地方传递一个已有的数组, 会对你的数组自动创建一个 copy.

fun main() {
    fun demo(vararg input: String): Array<out String> = input

    val originalArray = arrayOf("one", "two", "three", "four")
    val newArray = demo(*originalArray)

    originalArray[1] = "ten"

    // 输出结果为 "one, ten, three, four"
    println(originalArray.joinToString())

    // 输出结果为 "one, two, three, four"
    println(newArray.joinToString())
}

校验输入和状态

如果条件的判断结果为 false, require 函数会抛出 IllegalArgumentException 异常, 导致函数立即失败, 并显示适当的错误消息:

fun saveUser(username: String, password: String) {
    require(username.isNotBlank()) { "Username should not be blank" }
    require(username.all { it.isLetterOrDigit() }) {
        "Username can only contain letters and digits, was: $username"
    }
    require(password.isNotBlank()) { "Password should not be blank" }
    require(password.length >= 7) {
        "Password must contain at least 7 characters"
    }

    /* 校验完成, 实现代码可以继续执行 */
}

类似的, 如果条件的判断结果为 false, check 函数抛出 IllegalStateException 异常. 请使用这个函数来校验一个实例的状态, 如下面的示例所示:

class ShoppingCart {
    private val contents = mutableListOf<Item>()

    fun addItem(item: Item) {
        contents.add(item)
    }

    fun purchase(): Amount {
        check(contents.isNotEmpty()) {
            "Cannot purchase an empty cart"
        }
        // 计算并返回金额
    }
}

可预测性﻿

默认完整正确的功能﻿

提供扩展能力﻿

防止不期望的和不正确的扩展﻿

不要暴露可变的状态﻿

校验输入和状态﻿

下一步﻿

默认完整正确的功能

提供扩展能力

防止不期望的和不正确的扩展

不要暴露可变的状态

校验输入和状态

下一步