如何在Golang中处理REST API分页查询

答案:Golang中处理REST API分页需定义分页结构体、设置默认值并校验,通过Page和PageSize计算offset和limit构造数据库查询,使用ORM或原生SQL获取数据,同时查询总记录数,封装数据列表、总页数、当前页等信息返回标准化响应,建议限制最大页大小防止深分页,必要时采用游标分页提升性能。

如何在golang中处理rest api分页查询

在Golang中处理REST API分页查询,核心是解析客户端传入的分页参数,构造带限制条件的数据库查询,并返回带有分页元信息的结果。关键点包括:定义分页结构体、校验和设置默认值、与数据库交互、返回标准化响应。

定义分页参数结构体

创建一个结构体来接收客户端传来的分页参数,通常包括页码和每页数量,也可支持偏移量和限制条数模式。

type Pagination struct {
    Page int `json:”page”`
    PageSize int `json:”page_size”`
}

在实际处理中,若未提供参数,应设置默认值,比如 page=1,page_size=10,并限制最大值防止恶意请求。

func (p *Pagination) SetDefaults() {
    if p.Page
        p.Page = 1
    }
    if p.PageSize 100 {
        p.PageSize = 10
    }
}

构建数据库查询语句

使用计算出的 offset 和 limit 来构造 SQL 查询或 ORM 查询。以 OFFSET/LIMIT 模式为例:

立即学习“go语言免费学习笔记(深入)”;

offset := (p.Page – 1) * p.PageSize
query := “SELECT id, name, email FROM users LIMIT ? OFFSET ?”
rows, err := db.Query(query, p.PageSize, offset)

如果使用 GORM 等 ORM,可链式调用:

var users []User
db.Offset(offset).Limit(p.PageSize).Find(&users)

返回分页结果与元信息

除了数据列表,还应返回总记录数、当前页、每页大小等,方便前端控制翻页。

type PaginatedResponse struct {
    Data []User `json:”data”`
    Total int `json:”total”`
    Page int `json:”page”`
    PageSize int `json:”page_size”`
    Pages int `json:”pages”`
}

计算总页数:

var total int64
db.Model(&User{}).Count(&total)
pages := int(total) / p.PageSize
if int(total)%p.PageSize > 0 {
    pages++
}

最终将结果封装返回:

response := PaginatedResponse{
    Data: users,
    Total: int(total),
    Page: p.Page,
    PageSize: p.PageSize,
    Pages: pages,
}
json.NewEncoder(w).Encode(response)

基本上就这些。合理封装分页逻辑,能提升API可用性和性能。注意避免深分页问题,必要时可改用游标分页(cursor-based pagination)。

以上就是如何在Golang中处理REST API分页查询的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1410991.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
Go net/http 模块静态文件服务深度解析与最佳实践
上一篇 2025年12月16日 03:49:07
Go语言在Linux上管理循环设备:利用Cgo集成losetup核心功能
下一篇 2025年12月16日 03:49:15

相关推荐

发表回复

登录后才能评论
关注微信