merge: sync origin main into auth-login
This commit is contained in:
mac
@@ -0,0 +1,127 @@
|
||||
package handler
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"net/http"
|
||||
"strconv"
|
||||
"time"
|
||||
|
||||
"github.com/1024XEngineer/xinfra/server/internal/response"
|
||||
|
||||
"github.com/gin-gonic/gin"
|
||||
)
|
||||
|
||||
// Ping 健康检查
|
||||
// @Summary 健康检查
|
||||
// @Description 检查服务器是否正常运行
|
||||
// @Tags 系统
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 200 {object} Response{data=object{time=string}}
|
||||
// @Router /ping [get]
|
||||
func Ping(c *gin.Context) {
|
||||
response.Success(c, gin.H{"time": time.Now().Format(time.RFC3339)})
|
||||
}
|
||||
|
||||
// TestSuccess 测试成功响应
|
||||
// @Summary 测试成功响应
|
||||
// @Description 测试返回成功的统一响应格式
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 200 {object} Response{data=object{username=string,role=string}}
|
||||
// @Router /test/success [get]
|
||||
func TestSuccess(c *gin.Context) {
|
||||
response.Success(c, gin.H{
|
||||
"username": "testuser",
|
||||
"role": "admin",
|
||||
})
|
||||
}
|
||||
|
||||
// TestError 测试业务错误响应
|
||||
// @Summary 测试业务错误响应
|
||||
// @Description 根据错误码返回对应的业务错误响应
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Param code path int true "业务错误码 (10001-10099: 认证相关, 20001-20099: 任务相关)"
|
||||
// @Success 200 {object} Response{details=string}
|
||||
// @Failure 400 {object} Response
|
||||
// @Router /test/error/{code} [get]
|
||||
func TestError(c *gin.Context) {
|
||||
codeStr := c.Param("code")
|
||||
code, err := strconv.Atoi(codeStr)
|
||||
if err != nil {
|
||||
response.BadRequest(c, "错误码必须是数字")
|
||||
return
|
||||
}
|
||||
details := fmt.Sprintf("这是错误码 %d 的测试响应", code)
|
||||
response.Error(c, http.StatusOK, code, details)
|
||||
}
|
||||
|
||||
// Test500 测试 500 错误
|
||||
// @Summary 测试 500 错误
|
||||
// @Description 模拟返回 HTTP 500 服务器内部错误
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 500 {object} Response
|
||||
// @Router /test/500 [get]
|
||||
func Test500(c *gin.Context) {
|
||||
response.InternalError(c, "模拟服务器内部错误")
|
||||
}
|
||||
|
||||
// Test401 测试 401 错误
|
||||
// @Summary 测试 401 错误
|
||||
// @Description 模拟返回 HTTP 401 未授权错误
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 401 {object} Response
|
||||
// @Router /test/401 [get]
|
||||
func Test401(c *gin.Context) {
|
||||
response.Unauthorized(c, "模拟 Token 过期")
|
||||
}
|
||||
|
||||
// Test403 测试 403 错误
|
||||
// @Summary 测试 403 错误
|
||||
// @Description 模拟返回 HTTP 403 禁止访问错误
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 403 {object} Response
|
||||
// @Router /test/403 [get]
|
||||
func Test403(c *gin.Context) {
|
||||
response.Forbidden(c, "模拟无权限")
|
||||
}
|
||||
|
||||
// TestTimeout 测试超时响应
|
||||
// @Summary 测试超时响应
|
||||
// @Description 模拟请求超时（15秒延迟，超过前端 10s timeout）
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 200 {object} Response
|
||||
// @Failure 408 {object} Response
|
||||
// @Router /test/timeout [get]
|
||||
func TestTimeout(c *gin.Context) {
|
||||
time.Sleep(15 * time.Second)
|
||||
response.Success(c, "这条消息不应该出现")
|
||||
}
|
||||
|
||||
// TestPaginated 测试分页响应
|
||||
// @Summary 测试分页响应
|
||||
// @Description 测试返回分页数据的统一响应格式
|
||||
// @Tags 测试
|
||||
// @Accept json
|
||||
// @Produce json
|
||||
// @Success 200 {object} Response{data=PaginatedData{items=[]object}}
|
||||
// @Router /test/paginated [get]
|
||||
func TestPaginated(c *gin.Context) {
|
||||
items := []gin.H{
|
||||
{"id": 1, "name": "item-1"},
|
||||
{"id": 2, "name": "item-2"},
|
||||
{"id": 3, "name": "item-3"},
|
||||
}
|
||||
response.SuccessWithPaginated(c, 100, items)
|
||||
}
|
||||
@@ -6,6 +6,8 @@ import (
|
||||
"github.com/1024XEngineer/xinfra/server/internal/service"
|
||||
|
||||
"github.com/gin-gonic/gin"
|
||||
swaggerFiles "github.com/swaggo/files"
|
||||
ginSwagger "github.com/swaggo/gin-swagger"
|
||||
"gorm.io/gorm"
|
||||
)
|
||||
|
||||
@@ -14,6 +16,21 @@ type Dependencies struct {
|
||||
DB *gorm.DB
|
||||
}
|
||||
|
||||
// New 初始化路由。
|
||||
// @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 New(deps Dependencies) *gin.Engine {
|
||||
if deps.Config.AppEnv == "prod" {
|
||||
gin.SetMode(gin.ReleaseMode)
|
||||
@@ -22,6 +39,33 @@ func New(deps Dependencies) *gin.Engine {
|
||||
r := gin.New()
|
||||
r.Use(gin.Logger(), gin.Recovery())
|
||||
|
||||
registerSwaggerRoutes(r)
|
||||
registerTestRoutes(r)
|
||||
registerAuthServerRoutes(r, deps)
|
||||
|
||||
return r
|
||||
}
|
||||
|
||||
func registerSwaggerRoutes(r *gin.Engine) {
|
||||
r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler, ginSwagger.URL("/swagger/doc.json")))
|
||||
}
|
||||
|
||||
func registerTestRoutes(r *gin.Engine) {
|
||||
r.GET("/api/v1/ping", handler.Ping)
|
||||
|
||||
testGroup := r.Group("/api/v1/test")
|
||||
{
|
||||
testGroup.GET("/success", handler.TestSuccess)
|
||||
testGroup.GET("/error/:code", handler.TestError)
|
||||
testGroup.GET("/500", handler.Test500)
|
||||
testGroup.GET("/401", handler.Test401)
|
||||
testGroup.GET("/403", handler.Test403)
|
||||
testGroup.GET("/timeout", handler.TestTimeout)
|
||||
testGroup.GET("/paginated", handler.TestPaginated)
|
||||
}
|
||||
}
|
||||
|
||||
func registerAuthServerRoutes(r *gin.Engine, deps Dependencies) {
|
||||
auditService := service.NewAuditService(deps.DB)
|
||||
authService := service.NewAuthService(deps.Config, deps.DB, auditService)
|
||||
wayenService := service.NewWayenService(deps.Config, deps.DB)
|
||||
@@ -55,6 +99,4 @@ func New(deps Dependencies) *gin.Engine {
|
||||
protected.PUT("/wayen/credential", wayenHandler.SaveCredential)
|
||||
protected.GET("/clouddm/login", clouddmHandler.Login)
|
||||
}
|
||||
|
||||
return r
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user