如何在30分钟内用Kotlin编写REST API：分步指南

引言：为什么选择Kotlin和REST API？

现代网页开发离不开REST API。如果你已经熟悉Python和Flask或FastAPI等框架，你肯定欣赏其创建服务器应用的简洁和速度。Kotlin作为JVM的现代语言，提供了同样的优雅和简洁，尤其是与Ktor框架结合使用时。

在本文中，我们将在30分钟内创建一个完整的REST API。你将学习如何配置项目、创建路由、处理JSON以及启动服务器。全是干货，只有实践。

如果你想扩展你的技术栈，或者只是想尝试用Kotlin进行后端开发，本指南适合你。

步骤1：项目配置和依赖项

首先，我们需要一个Kotlin项目。我们将使用Gradle（或Maven，任你选择）构建工具。最快的方式是通过Ktor项目生成器创建项目。

选择以下选项：

\n
• 构建系统：Gradle Kotlin DSL
\n
• 引擎：Netty（或其他任意引擎）
\n
• 插件：内容协商（JSON）、路由、状态页面
\n

下载压缩包后，解压并在IntelliJ IDEA或其他编辑器中打开。

如果你手动创建项目，请在build.gradle.kts中添加以下依赖项：

dependencies {\n    implementation("io.ktor:ktor-server-core:2.3.0")\n    implementation("io.ktor:ktor-server-netty:2.3.0")\n    implementation("io.ktor:ktor-server-content-negotiation:2.3.0")\n    implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.0")\n    implementation("ch.qos.logback:logback-classic:1.4.11")\n}

现在，创建文件Application.kt——应用程序的入口点。

import io.ktor.server.engine.*\nimport io.ktor.server.netty.*\nimport io.ktor.server.application.*\nimport io.ktor.server.plugins.contentnegotiation.*\nimport io.ktor.serialization.kotlinx.json.*\nimport kotlinx.serialization.json.Json\n\nfun main() {\n    embeddedServer(Netty, port = 8080, host = "0.0.0.0") {\n        configureSerialization()\n        configureRouting()\n    }.start(wait = true)\n}\n\nfun Application.configureSerialization() {\n    install(ContentNegotiation) {\n        json(Json {\n            prettyPrint = true\n            isLenient = true\n        })\n    }\n}

完成！我们已经有了处理JSON的基本配置和一个运行在8080端口的服务器。

步骤2：创建数据模型和存储

REST API需要数据。让我们创建一个简单的User（用户）模型和一个临时的内存存储。

首先，定义一个带有@Serializable注解的数据类：

import kotlinx.serialization.Serializable\n\n@Serializable\ndata class User(\n    val id: Int,\n    val name: String,\n    val email: String\n)

现在，创建一个用于存储用户的对象仓库：

object UserRepository {\n    private val users = mutableListOf(\n        User(1, "伊万·伊万诺夫", "ivan@example.com"),\n        User(2, "玛丽亚·彼得罗娃", "maria@example.com")\n    )\n\n    fun getAll(): List<User> = users.toList()\n\n    fun getById(id: Int): User? = users.find { it.id == id }\n\n    fun add(user: User): User {\n        users.add(user)\n        return user\n    }\n\n    fun delete(id: Int): Boolean = users.removeIf { it.id == id }\n}

这是一个非常简单的解决方案，但对于30分钟的演示来说非常合适。

步骤3：配置路由（REST端点）

现在是最有趣的部分——为CRUD操作创建端点。添加文件Routing.kt：

import io.ktor.server.routing.*\nimport io.ktor.server.response.*\nimport io.ktor.server.request.*\n\nfun Application.configureRouting() {\n    routing {\n        route("/api/u