SuperAPI AI 工具集

vapor-swift

编程与开发

查看项目

更新于 10-15 20:32

技能介绍

用途:以 Vapor 4 构建类型安全、并发的服务端 Swift 后端与 API。新代码优先使用 async/await 与 Fluent 异步 API,除兼容旧库外不使用 EventLoopFuture。

主要能力:覆盖 HTTP 路由、中间件、Content 编解码与错误处理;Fluent ORM 的模型、迁移、查询、事务与关系预加载;JWT 或会话认证及所有权/角色授权;输入校验;XCTVapor 集成测试;Linux/Docker 部署与健康检查。

使用方式:按域组织 Sources/App,configure.swift 负责数据库、全局中间件、迁移与服务,routes.swift 只注册 RouteCollection,Controllers 实现 RouteCollection 并设置前缀与中间件。处理器签名为 async throws -> T(T: AsyncResponseEncodable),用 req.content.decode / req.query.decode 解析输入,边界处校验并以 Abort 返回正确状态码。认证与授权分离,敏感字段用 DTO 而非直接暴露 Fluent Model。迁移需版本化,已上线迁移不可改写,只能新增。

适用场景:需要服务端 Swift 的 API、Web 后端、多客户端版本化接口、实时 WebSocket 推送,以及 Linux/Docker 生产部署。

限制与注意:资料未提供具体安装命令、价格、平台支持范围与性能数据。生产环境建议用 Postgres,SQLite 多实例需谨慎;避免在事件循环中做重同步工作,注意 Sendable 与连接池配置;autoMigrate 仅用于开发/测试;密钥经环境变量注入,不硬编码;不在生产泄露堆栈信息。