在 Kotlin 中创建 DSL

在 Kotlin 中创建 DSL（领域特定语言）的核心，是让代码结构更贴合具体领域（如构建网页、配置项目）的思维逻辑。其基础原理主要依赖 Kotlin 的 带接收者的 Lambda 表达式 和 扩展函数/属性。

🧱 核心概念与技术要点

你可以通过下表快速了解这两种核心技术如何协作来构建DSL：

技术核心	角色与作用	简单示例
带接收者的 Lambda	提供构建上下文。Lambda 内部 (`this`) 指向一个特定对象，使你能够直接在该对象的上下文中调用方法。	`html { }` 中的 Lambda 在 `HtmlBuilder` 的上下文中执行，`this` 就是 `HtmlBuilder` 实例。
扩展函数/属性	提供领域词汇。为特定类型（如 `Tag`）添加函数，使调用像在操作领域内的原生概念。	为 `Tag` 类扩展 `body { }` 函数，让你在DSL中能直接写 `body`。
结合使用	两者结合，便能创造出结构清晰、语义丰富的领域特定语句块。	`html { body { } }`

🛠️ 实战演练：创建 HTML DSL

下面通过一个构建简单 HTML 的 DSL 示例，来具体感受这些技术的应用。代码注释标注了关键部分：

kotlin 复制代码

// 1. 定义 DSL 的入口函数。它接收一个带接收者的 Lambda。
fun html(init: HtmlBuilder.() -> Unit): String {
    val builder = HtmlBuilder()
    builder.init() // 在此执行 Lambda，构建 HTML
    return builder.toString()
}

// 2. 定义构建器类，作为接收者类型，提供构建上下文。
class HtmlBuilder {
    private val buffer = StringBuilder()

    // 用于创建标签的函数，也是带接收者的 Lambda
    fun tag(name: String, init: Tag.() -> Unit) {
        buffer.append("<$name>")
        val tag = Tag(name, buffer)
        tag.init() // 在新的标签上下文中执行
        buffer.append("</$name>")
    }

    // 添加纯文本
    fun text(content: String) {
        buffer.append(content)
    }

    override fun toString() = buffer.toString()
}

// 3. 定义标签类，作为嵌套构建的接收者。
class Tag(val name: String, private val buffer: StringBuilder) {
    // 可以在 Tag 上下文中定义更多领域方法
    fun text(content: String) {
        buffer.append(content)
    }
}

// 4. 使用 DSL 构建 HTML
fun main() {
    val htmlContent = html { // 进入 HtmlBuilder 上下文
        tag("html") {
            tag("body") {
                tag("h1") {
                    text("Hello, DSL!") // 在 H1 标签的上下文中添加文本
                }
                tag("p") {
                    text("This is a paragraph.")
                }
            }
        }
    }
    println(htmlContent)
}

运行上述代码，会输出：

html 复制代码

<html><body><h1>Hello, DSL!</h1><p>This is a paragraph.</p></body></html>