76 lines
2.1 KiB
Go
76 lines
2.1 KiB
Go
package router
|
||
|
||
import (
|
||
"github.com/1024XEngineer/xinfra/server/internal/handler"
|
||
"github.com/1024XEngineer/xinfra/server/internal/middleware"
|
||
"github.com/gin-gonic/gin"
|
||
swaggerFiles "github.com/swaggo/files"
|
||
ginSwagger "github.com/swaggo/gin-swagger"
|
||
)
|
||
|
||
// Setup 初始化路由
|
||
// @title xinfra API
|
||
// @version 1.0
|
||
// @description xinfra 平台后端 API 文档
|
||
// @termsOfService http://swagger.io/terms/
|
||
// @contact.name API Support
|
||
// @contact.url http://www.swagger.io/support
|
||
// @contact.email support@swagger.io
|
||
// @license.name Apache 2.0
|
||
// @license.url http://www.apache.org/licenses/LICENSE-2.0.html
|
||
// @BasePath /api/v1
|
||
// @securityDefinitions.apikey BearerAuth
|
||
// @in header
|
||
// @name Authorization
|
||
// @description 请输入 Bearer Token（例如：Bearer xxx）
|
||
func Setup() *gin.Engine {
|
||
r := gin.Default()
|
||
|
||
// 加载中间件
|
||
r.Use(middleware.Logger())
|
||
r.Use(middleware.Recovery())
|
||
|
||
// Swagger UI
|
||
r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler, ginSwagger.URL("/swagger/doc.json")))
|
||
|
||
// 健康检查
|
||
r.GET("/api/v1/ping", handler.Ping)
|
||
|
||
// 测试路由组 — 用于验证统一响应格式
|
||
setupTestRoutes(r)
|
||
|
||
return r
|
||
}
|
||
|
||
// setupTestRoutes 注册测试路由
|
||
func setupTestRoutes(r *gin.Engine) {
|
||
testGroup := r.Group("/api/v1/test")
|
||
{
|
||
// 成功响应
|
||
testGroup.GET("/success", handler.TestSuccess)
|
||
|
||
// 业务错误 — 传入错误码
|
||
// GET /api/v1/test/error/10001 → LDAP 认证失败
|
||
// GET /api/v1/test/error/10002 → 用户名或密码错误
|
||
// GET /api/v1/test/error/10003 → Token 已过期
|
||
// GET /api/v1/test/error/20001 → 任务创建失败
|
||
// GET /api/v1/test/error/20002 → 任务执行超时
|
||
testGroup.GET("/error/:code", handler.TestError)
|
||
|
||
// HTTP 500 错误
|
||
testGroup.GET("/500", handler.Test500)
|
||
|
||
// HTTP 401 未授权
|
||
testGroup.GET("/401", handler.Test401)
|
||
|
||
// HTTP 403 禁止访问
|
||
testGroup.GET("/403", handler.Test403)
|
||
|
||
// 模拟超时（sleep 超过前端 10s timeout）
|
||
testGroup.GET("/timeout", handler.TestTimeout)
|
||
|
||
// 返回分页数据
|
||
testGroup.GET("/paginated", handler.TestPaginated)
|
||
}
|
||
}
|