初始化

utils/response.go

@@ -0,0 +1,87 @@
+// Package utils 提供通用工具函数
+// 包括统一的 JSON 响应格式化、错误处理等
+package utils
+
+import (
+	"net/http"
+
+	"github.com/gin-gonic/gin"
+)
+
+// Response 统一API响应结构体
+type Response struct {
+	Code    int         `json:"code"`    // 业务状态码：0=成功，非0=失败
+	Message string      `json:"message"` // 提示信息
+	Data    interface{} `json:"data"`    // 响应数据，可以是任意类型
+}
+
+// Success 返回成功响应
+// c: Gin上下文
+// data: 响应数据
+func Success(c *gin.Context, data interface{}) {
+	c.JSON(http.StatusOK, Response{
+		Code:    0,
+		Message: "success",
+		Data:    data,
+	})
+}
+
+// SuccessWithMessage 返回带自定义消息的成功响应
+// c: Gin上下文
+// message: 自定义提示信息
+// data: 响应数据
+func SuccessWithMessage(c *gin.Context, message string, data interface{}) {
+	c.JSON(http.StatusOK, Response{
+		Code:    0,
+		Message: message,
+		Data:    data,
+	})
+}
+
+// Error 返回错误响应
+// c: Gin上下文
+// code: 业务错误码（非0）
+// message: 错误提示信息
+func Error(c *gin.Context, code int, message string) {
+	c.JSON(http.StatusOK, Response{
+		Code:    code,
+		Message: message,
+		Data:    nil,
+	})
+}
+
+// ErrorWithHTTP 返回带HTTP状态码的错误响应
+// c: Gin上下文
+// httpCode: HTTP状态码
+// code: 业务错误码
+// message: 错误提示信息
+func ErrorWithHTTP(c *gin.Context, httpCode int, code int, message string) {
+	c.JSON(httpCode, Response{
+		Code:    code,
+		Message: message,
+		Data:    nil,
+	})
+}
+
+// PageResult 分页查询结果结构体
+type PageResult struct {
+	List     interface{} `json:"list"`     // 数据列表
+	Total    int64       `json:"total"`    // 总记录数
+	Page     int         `json:"page"`     // 当前页码
+	PageSize int         `json:"pageSize"` // 每页条数
+}
+
+// SuccessPage 返回分页查询成功响应
+// c: Gin上下文
+// list: 数据列表
+// total: 总记录数
+// page: 当前页码
+// pageSize: 每页条数
+func SuccessPage(c *gin.Context, list interface{}, total int64, page, pageSize int) {
+	Success(c, PageResult{
+		List:     list,
+		Total:    total,
+		Page:     page,
+		PageSize: pageSize,
+	})
+}