Kotlin函数式接口与类型别名使用场景及API含义解析

首先明确语境中的API含义：这里指的是你设计的对外暴露的代码组件（比如函数、类、方法等），其他代码（调用方）会依赖这些组件实现功能，简单说就是供外部调用的代码接口。

一、使用类型别名的场景：仅需特定签名的函数 #

当你的API只需要接收一个具有固定参数和返回类型的函数，没有额外行为约束或附加操作时，优先使用类型别名简化重复的函数式类型声明，让代码更具语义性。

示例：简化排序比较器的函数式类型 #

假设我们的API需要频繁接收“两个Int比较返回Boolean”的函数，直接写(Int, Int) -> Boolean会冗长且语义模糊，用类型别名优化：

// 定义类型别名，给函数式类型赋予语义化名称
typealias IntComparator = (Int, Int) -> Boolean

// 对外API：接收IntComparator作为排序规则
fun sortIntList(numbers: List<Int>, comparator: IntComparator): List<Int> {
    return numbers.sortedWith { a, b -> comparator(a, b) }
}

// 调用API示例
fun main() {
    val rawList = listOf(5, 2, 9, 1, 5, 6)
    // 传入符合IntComparator签名的lambda
    val ascendingList = sortIntList(rawList) { a, b -> a < b }
    println(ascendingList) // 输出 [1, 2, 5, 5, 6, 9]
    
    val descendingList = sortIntList(rawList) { a, b -> a > b }
    println(descendingList) // 输出 [9, 6, 5, 5, 2, 1]
}

这里的sortIntList作为API，只关心传入的函数能完成Int比较逻辑，没有额外要求，类型别名让参数类型更易读，也避免了重复书写长函数式类型。

二、使用函数式接口的场景：需要复杂契约或附加操作 #

当你的API依赖的实体不只是一个简单函数，而是包含非平凡契约（比如必须遵守的行为规则、文档约定的逻辑），或者需要支持函数调用之外的其他方法/属性时，必须声明独立的函数式接口（带fun修饰的单抽象方法接口）。

示例：带附加契约的输入验证器 #

假设我们的API需要一个输入验证器，不仅要能验证输入内容，还要能返回验证规则描述、生成标准化错误提示，这些是函数式类型无法表达的：

// 函数式接口：包含单抽象方法+附加属性/默认方法
fun interface InputValidator {
    // 核心抽象方法：验证逻辑
    fun validate(input: String): Boolean

    // 附加属性：描述验证规则（契约的一部分）
    val ruleDescription: String

    // 默认方法：提供标准化错误提示（附加操作）
    fun getErrorMsg(input: String): String {
        return "输入无效：不符合「$ruleDescription」规则，输入内容为：$input"
    }
}

// 对外API：接收InputValidator处理输入
fun handleUserInput(input: String, validator: InputValidator) {
    if (validator.validate(input)) {
        println("输入验证通过：$input")
    } else {
        println(validator.getErrorMsg(input))
    }
}

// 调用API示例
fun main() {
    // 实现InputValidator，遵守契约规则
    val phoneValidator = object : InputValidator {
        override val ruleDescription: String = "必须为11位数字"
        override fun validate(input: String): Boolean {
            return input.length == 11 && input.all { it.isDigit() }
        }
    }

    handleUserInput("13800138000", phoneValidator) // 输入验证通过：13800138000
    handleUserInput("123456", phoneValidator) // 输入无效：不符合「必须为11位数字」规则，输入内容为：123456
}

这里的handleUserInput作为API，依赖的InputValidator不仅是一个验证函数，还包含规则描述和错误提示的契约，这些额外内容无法通过函数式类型表达，因此必须用函数式接口定义这个实体的完整约束。

内容的提问来源于stack exchange，提问作者Mohammadreza Khahani