affaan-m/kotlin-ktor-patterns

Ktor 服务器模式，包括路由 DSL、插件、身份认证、Koin DI、kotlinx.serialization、WebSocket 以及 testApplication 测试。在构建 Ktor 服务器（路由、插件、身份认证、依赖注入、序列化或测试）时使用。

研究分析开发 Agent Agent 技能写测试调研 Ktor 路由配置 Kotlin 认证插件 Koin 依赖注入 WebSocket 通信集成服务端接口测试 REST 接口开发

技术栈: cursor25万+许可证: MIT开发者: affaan-m

Skill 介绍Skill 文件

重要提示：本站仅作 Skill 资源导航与收录，正文以 GitHub 原仓库为准，版权归原项目所有。

在 GitHub 查看 ↗

原文译文

以下为摘要预览，完整内容请查看 GitHub 原文。

Ktor Server Patterns

Comprehensive Ktor patterns for building robust, maintainable HTTP servers with Kotlin coroutines.

When to Activate

Building Ktor HTTP servers
Configuring Ktor plugins (Auth, CORS, ContentNegotiation, StatusPages)
Implementing REST APIs with Ktor
Setting up dependency injection with Koin
Writing Ktor integration tests with testApplication
Working with WebSockets in Ktor

Application Structure

Standard Ktor Project Layout

src/main/kotlin/
├── com/example/
│   ├── Application.kt           # Entry point, module configuration
│   ├── plugins/
│   │   ├── Routing.kt           # Route definitions
│   │   ├── Serialization.kt     # Content negotiation setup
│   │   ├── Authentication.kt    # Auth configuration
│   │   ├── StatusPages.kt       # Error handling
│   │   └── CORS.kt              # CORS configuration
│   ├── routes/
│   │   ├── UserRoutes.kt        # /users endpoints
│   │   ├── AuthRoutes.kt        # /auth endpoints
│   │   └── HealthRoutes.kt      # /health endpoints
│   ├── models/
│   │   ├── User.kt              # Domain models
│   │   └── ApiResponse.kt       # Response envelopes
│   ├── services/
│   │   ├── User…

以下为摘要预览，完整内容请查看 GitHub 原文。

Ktor 服务器模式

使用 Kotlin 协程构建健壮、可维护的 HTTP 服务器的综合性 Ktor 模式。

何时启用

构建 Ktor HTTP 服务器
配置 Ktor 插件（Auth、CORS、ContentNegotiation、StatusPages）
使用 Ktor 实现 REST API
通过 Koin 设置依赖注入
使用 testApplication 编写 Ktor 集成测试
在 Ktor 中使用 WebSocket

应用结构

标准的 Ktor 项目布局

src/main/kotlin/
├── com/example/
│   ├── Application.kt           # 入口点，模块配置
│   ├── plugins/
│   │   ├── Routing.kt           # 路由定义
│   │   ├── Serialization.kt     # 内容协商配置
│   │   ├── Authentication.kt    # 身份认证配置
│   │   ├── StatusPages.kt       # 错误处理
│   │   └── CORS.kt              # CORS 配置
│   ├── routes/
│   │   ├── UserRoutes.kt        # /users 端点
│   │   ├── AuthRoutes.kt        # /auth 端点
│   │   └── HealthRoutes.kt      # /health 端点
│   ├── models/
│   │   ├── User.kt              # 领域模型
│   │   └── ApiResponse.kt       # 响应包装
│   ├── services/
│   │   ├── UserService.kt       # 业务逻辑
│   │   └── AuthService.kt       # 身份认证逻辑
│   ├── repositories/
│   │   ├── UserRepository.kt    # 数据访问接口
│   │   └── ExposedUserRepository.kt
│   └── di/
│       └── AppModule.kt         # Koin 模块
src/test/kotlin/
├── com/example/
│   ├── routes/
│   │   └── UserRoutesTest.kt
│   └── services/
│       └── UserServic…

重要提示：源文件不在本站托管，请通过 GitHub 查看与下载。

索引更新于 8/25/2026, 9:18:05 PMGitHub ↗

SKILL.md19.1 KB在 GitHub 查看 ↗