73 lines
2.0 KiB
Go
73 lines
2.0 KiB
Go
package v1
|
|
|
|
// ============================== 公共基础模块 ==============================
|
|
|
|
// PageReq 分页公共参数
|
|
// 对应前端分页契约：pageNo/pageSize
|
|
type PageReq struct {
|
|
PageNo int `json:"pageNo" dc:"页码，从1开始，默认1"` // 页码，从1开始
|
|
PageSize int `json:"pageSize" dc:"每页条数，默认10，最大500"` // 每页条数
|
|
}
|
|
|
|
// GetPageNo 获取页码
|
|
// 页码小于等于0时返回默认值1
|
|
func (p *PageReq) GetPageNo() int {
|
|
if p.PageNo <= 0 {
|
|
return 1
|
|
}
|
|
return p.PageNo
|
|
}
|
|
|
|
// GetPageSize 获取每页条数
|
|
// 每页条数小于等于0时返回默认值10，超过500时按500截断
|
|
func (p *PageReq) GetPageSize() int {
|
|
if p.PageSize <= 0 {
|
|
return 10
|
|
}
|
|
if p.PageSize > 500 {
|
|
return 500
|
|
}
|
|
return p.PageSize
|
|
}
|
|
|
|
// Offset 计算SQL LIMIT偏移量
|
|
// 偏移量 = (页码 - 1) × 每页条数
|
|
func (p *PageReq) Offset() int {
|
|
return (p.GetPageNo() - 1) * p.GetPageSize()
|
|
}
|
|
|
|
// IdsReq 批量删除入参
|
|
// 通用批量操作请求体，携带待操作的ID列表
|
|
type IdsReq struct {
|
|
Ids []int64 `json:"ids" v:"required#请选择要操作的记录" dc:"ID列表"` // ID列表
|
|
}
|
|
|
|
// IdRes 通用返回ID结构
|
|
// 各模块新增等接口共用的返回结果
|
|
type IdRes struct {
|
|
Id int64 `json:"id"` // 主键ID
|
|
}
|
|
|
|
// PageData 统一分页壳
|
|
// 对应前端分页契约：records/total/size/current/pages
|
|
type PageData[T any] struct {
|
|
Records []T `json:"records"` // 当前页记录列表
|
|
Total int `json:"total"` // 总记录数
|
|
Size int `json:"size"` // 请求的每页条数
|
|
Current int `json:"current"` // 请求页码
|
|
Pages int `json:"pages"` // 总页数
|
|
}
|
|
|
|
// NewPageData 构造分页壳
|
|
// records 为空时输出空数组而非 null，pages 按总记录数与每页条数计算得出
|
|
func NewPageData[T any](pageNo, pageSize, total int, records []T) *PageData[T] {
|
|
if records == nil {
|
|
records = []T{}
|
|
}
|
|
pages := 0
|
|
if pageSize > 0 {
|
|
pages = (total + pageSize - 1) / pageSize
|
|
}
|
|
return &PageData[T]{Records: records, Total: total, Size: pageSize, Current: pageNo, Pages: pages}
|
|
}
|