Kotlin Academy · 课时

使用 Table DSL 定义表

Q: 「使用 Table DSL 定义表」这节课中我会学到什么？

定义包含列、主键和外键的类型化表结构。 你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

定义包含列、主键和外键的类型化表结构。

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

Exposed 表对象

在 Exposed 中，数据库表表示为 Kotlin 单例 object，这些对象扩展 Table（查询 DSL）或 IntIdTable/LongIdTable/UUIDTable（DAO 层）。列定义则是 Kotlin 属性。

基本表定义

扩展 Table，并使用内置的列工厂函数定义列：

import org.jetbrains.exposed.sql.Table

object Users : Table("users") {
    val id    = long("id").autoIncrement()
    val name  = varchar("name", 100)
    val email = varchar("email", 255).uniqueIndex()
    val age   = integer("age").nullable()

    override val primaryKey = PrimaryKey(id)
}

列类型

Exposed 为常见的 SQL 类型提供了工厂函数：

integer("col")、long("col")、short("col")
varchar("col", length)、text("col")
bool("col")、double("col")、decimal("col", precision, scale)
datetime("col")、date("col")、timestamp("col")
blob("col")、uuid("col")、binary("col", length)

可空列

在任意列上调用 .nullable()，即可允许使用 NULL 值。对应的 Kotlin 类型会变为可空类型（String? 而不是 String）：

object Products : Table("products") {
    val id          = long("id").autoIncrement()
    val name        = varchar("name", 200)
    val description = text("description").nullable()
    override val primaryKey = PrimaryKey(id)
}

默认值

使用 .default(value) 设置 Kotlin 端的默认值（插入前应用），或使用 .defaultExpression(expr) 设置数据库端的 SQL 默认值：

object Orders : Table("orders") {
    val id        = long("id").autoIncrement()
    val status    = varchar("status", 20).default("PENDING")
    val createdAt = datetime("created_at")
        .defaultExpression(CurrentDateTime)
    override val primaryKey = PrimaryKey(id)
}

索引和唯一约束

直接在列上调用 .index() 创建普通索引，或调用 .uniqueIndex() 创建唯一索引。对于复合索引，请在 Table 上使用 index() 函数：

object Articles : Table("articles") {
    val id    = long("id").autoIncrement()
    val title = varchar("title", 300).index()
    val slug  = varchar("slug", 300).uniqueIndex()
    override val primaryKey = PrimaryKey(id)
}

外键

使用 .references() 声明列之间的外键约束。传入被引用的列，还可以选择传入 onDelete 和 onUpdate 操作：

object Posts : Table("posts") {
    val id       = long("id").autoIncrement()
    val authorId = long("author_id").references(Users.id, onDelete = ReferenceOption.CASCADE)
    val title    = varchar("title", 300)
    override val primaryKey = PrimaryKey(id)
}

IdTable 的变体

对于 DAO 层，请使用带类型的 ID 表，而不是普通的 Table：

IntIdTable("name")——Int 类型的自增主键，名称为 id
LongIdTable("name")——Long 类型的自增主键
UUIDTable("name")——UUID 主键

object Users : LongIdTable("users") {
    val name  = varchar("name", 100)
    val email = varchar("email", 255).uniqueIndex()
}

复合主键

将多个列传递给 PrimaryKey()，即可定义复合主键：

object UserRoles : Table("user_roles") {
    val userId = long("user_id").references(Users.id)
    val roleId = long("role_id").references(Roles.id)
    override val primaryKey = PrimaryKey(userId, roleId)
}

枚举列

使用 enumerationByName() 或 enumeration()，将 Kotlin 枚举值存储为字符串或序号：

enum class Status { ACTIVE, INACTIVE, BANNED }

object Users : LongIdTable("users") {
    val name   = varchar("name", 100)
    val status = enumerationByName<Status>("status", 20)
}

应用架构更改

调用 SchemaUtils.createMissingTablesAndColumns()，即可添加缺失的表和列，而不会删除现有数据——这是一种适用于开发环境的安全迁移方式。在生产环境中，请使用 Flyway 或 Liquibase 等迁移工具。

transaction {
    SchemaUtils.createMissingTablesAndColumns(Users, Posts, Orders)
}

快速检查

如何在 Exposed 的表 DSL 中声明从 Posts.authorId 到 Users.id 的外键？

回顾：使用表 DSL 定义表

要点：

表是扩展 Table、LongIdTable 等的 object
列类型包括：varchar、integer、long、bool、datetime、uuid 等
.nullable()、.default()、.uniqueIndex()、.references() 可用于修改列
复合主键：PrimaryKey(col1, col2)
使用 SchemaUtils.create() 或 createMissingTablesAndColumns() 应用架构

常见问题解答

「使用 Table DSL 定义表」课时是免费的吗？

是的 — 「使用 Table DSL 定义表」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Kotlin Academy 课程的其余内容，请升级到 CoddyKit PRO。 Kotlin Academy 课程共包含 4 节课。

「使用 Table DSL 定义表」这节课中我会学到什么？

定义包含列、主键和外键的类型化表结构。你通过在浏览器中直接运行的动手代码来练习 Kotlin Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Kotlin Academy 需要有经验吗？

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

「使用 Table DSL 定义表」课时需要多长时间？

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

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

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

此课程中的所有课时

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

← 返回 Kotlin Academy