mac
c421be3ae9
Add Swagger annotations to all 7 delivery handlers. Fix existing test.go type references (Response -> response.Response). Add swaggo dependencies to go.mod. Regenerate swagger.json/yaml/docs.go with delivery endpoints visible in /swagger/index.html. Relates-to: #97
128 lines
3.8 KiB
Go
128 lines
3.8 KiB
Go
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.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.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.Response{details=string}
|
||
// @Failure 400 {object} response.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.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.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.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.Response
|
||
// @Failure 408 {object} response.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.Response{data=response.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)
|
||
}
|