Kotlin Academy · 课时

Exposed 设置：数据库连接与事务 DSL

Q: 「Exposed 设置：数据库连接与事务 DSL」这节课中我会学到什么？

连接数据库、配置 Exposed，并在事务中执行代码。 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

连接数据库、配置 Exposed，并在事务中执行代码。

Exposed 设置：数据库连接与事务 DSL 是 CoddyKit 上的免费 Kotlin Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Kotlin Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Kotlin Academy 课程共包含 4 节课。

Exposed 是什么

Exposed 是 JetBrains 面向 Kotlin 的轻量级 SQL 框架。它提供两个层级：查询 DSL（类型安全的 SQL 表达式）和 DAO 层（采用 Active Record 风格的实体）。两者都必须在显式事务中运行。

添加 Exposed 依赖项

添加核心库、JDBC 驱动桥接库以及您的数据库驱动程序：

dependencies {
    implementation("org.jetbrains.exposed:exposed-core:0.52.0")
    implementation("org.jetbrains.exposed:exposed-jdbc:0.52.0")
    implementation("org.jetbrains.exposed:exposed-dao:0.52.0")
    implementation("com.h2database:h2:2.2.224") // or postgresql driver
    implementation("com.zaxxer:HikariCP:5.1.0")  // connection pooling
}

连接数据库

在应用启动时调用一次 Database.connect()。在生产环境中，请传入 HikariDataSource；在测试中，使用简单的 JDBC URL 即可：

import org.jetbrains.exposed.sql.Database

// Simple (dev/test)
Database.connect(
    url = "jdbc:h2:mem:test;DB_CLOSE_DELAY=-1",
    driver = "org.h2.Driver"
)

// Production with HikariCP
Database.connect(HikariDataSource(HikariConfig().apply {
    jdbcUrl = "jdbc:postgresql://localhost/mydb"
    username = "user"
    password = "pass"
    maximumPoolSize = 10
}))

transaction { } 块

所有 Exposed 操作都必须在 transaction { } 块中运行。Exposed 会在操作成功时提交，并在发生任何未捕获异常时回滚：

transaction {
    // all DB operations here
    SchemaUtils.create(Users)
}

适用于协程的事务

请使用来自 exposed-r2dbc 的 newSuspendedTransaction { }，或使用 exposed-spring-boot-starter，以支持与协程兼容的事务。在 Ktor 中，请将阻塞式 Exposed 调用包装在 withContext(Dispatchers.IO) { transaction { ... } } 中：

suspend fun findUser(id: Long): User? = withContext(Dispatchers.IO) {
    transaction {
        UserEntity.findById(id)?.toUser()
    }
}

SchemaUtils：创建和删除表

使用 SchemaUtils.create(Table1, Table2) 创建不存在的表，使用 SchemaUtils.drop() 删除表。请在应用启动时的 transaction { } 中调用这些函数：

transaction {
    SchemaUtils.create(Users, Posts, Comments)
}

在 Ktor 中配置数据库连接

在 Application 模块中初始化数据库，以便服务器启动时只运行一次：

fun Application.configureDatabase() {
    val dbUrl = environment.config.property("ktor.database.url").getString()
    Database.connect(dbUrl, driver = "org.postgresql.Driver",
        user = "...", password = "...")
    transaction { SchemaUtils.create(Users) }
}

事务隔离级别

如果需要更强或更弱的一致性保证，请将隔离级别传递给 transaction()：

transaction(Connection.TRANSACTION_SERIALIZABLE) {
    // serializable isolation
}

嵌套事务

默认情况下，嵌套的 transaction { } 调用会加入外层事务。若要获得独立事务，请使用 transaction(db, outerTransactionIsEmpty = false) { } 或保存点。

记录 SQL 日志

启用 SQL 日志记录，即可在开发期间查看生成的查询。请在事务块中设置 StdOutSqlLogger 或自定义日志记录器：

transaction {
    addLogger(StdOutSqlLogger)
    // ...
}

连接池的最佳实践

在生产环境中始终使用 HikariCP（或类似工具）。将 maximumPoolSize 设置为与服务器线程数相匹配，并设置 connectionTimeout，以便在连接池耗尽时快速失败。在生产环境中监控连接池利用率。

快速检查

如果 transaction { } 块中抛出了未捕获异常，Exposed 会发生什么？

回顾：Exposed 设置与事务 DSL

要点：

在应用启动时使用 Database.connect() 连接一次（生产环境使用 HikariCP）
所有数据库操作都在 transaction { } 中运行——成功时提交，发生异常时回滚
在事务中使用 SchemaUtils.create() 创建或删除表
在协程环境中，将阻塞式 Exposed 调用包装在 withContext(Dispatchers.IO) 中
开发期间启用 StdOutSqlLogger，以检查生成的 SQL

常见问题解答

「Exposed 设置：数据库连接与事务 DSL」课时是免费的吗？

是的 — 「Exposed 设置：数据库连接与事务 DSL」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「Exposed 设置：数据库连接与事务 DSL」这节课中我会学到什么？

连接数据库、配置 Exposed，并在事务中执行代码。你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Kotlin Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「Exposed 设置：数据库连接与事务 DSL」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Kotlin Academy 课中编写并运行代码吗？

能。每节 Kotlin Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

Exposed 设置：数据库连接与事务 DSL
使用 Table DSL 定义表
使用查询 DSL 执行 CRUD：insert、select、update、delete
Exposed DAO：实体类与关系

← 返回 Kotlin Academy