Go 中使用接口与嵌入实现泛型式分页响应处理-Golang-PHP中文网

Go 中使用接口与嵌入实现泛型式分页响应处理

本文介绍如何在 go 语言中不依赖泛型（go 1.18 前）或反射，通过接口定义 + 匿名字段嵌入，优雅复用分页逻辑，避免为每种资源类型（如 loan、lender）重复编写几乎相同的分页请求与解析代码。

本文介绍如何在 go 语言中不依赖泛型（go 1.18 前）或反射，通过接口定义 + 匿名字段嵌入，优雅复用分页逻辑，避免为每种资源类型（如 loan、lender）重复编写几乎相同的分页请求与解析代码。

在构建 REST API 客户端（例如 Kiva API 封装）时，常见模式是多个端点返回结构高度相似的分页响应：均含统一的 paging 元信息（总条数、当前页、页大小、总页数）和一个泛型化的 items 数组（如 []Loan 或 []Lender）。若为每个类型单独实现分页拉取逻辑，将导致大量重复代码——这不仅违背 DRY 原则，也显著增加维护成本。

Go 虽在 1.18 后支持泛型，但即使在旧版本中，我们也能借助接口抽象 + 结构体嵌入实现类型安全、零反射的复用方案。

✅ 核心思路：定义可分页接口 + 统一分页器结构

首先，定义一个轻量接口，仅声明获取分页元数据的能力：

type Pagable interface {
    Paging() PagingData
}

接着，创建一个通用的 Pager 结构体，负责承载并暴露分页字段：

type Pager struct {
    Paging PagingData `json:"paging"`
}

func (p Pager) Paging() PagingData {
    return p.Paging
}

关键在于：让所有分页响应类型匿名嵌入 Pager。Go 的嵌入机制会自动将 Pager 的字段和方法“提升”到外层结构体中，使其天然满足 Pagable 接口：

type PagedLoanResponse struct {
    Pager // ← 嵌入：获得 Paging() 方法 + paging 字段
    Items []Loan `json:"loans"`
}

type PagedLenderResponse struct {
    Pager // ← 同样嵌入
    Items []Lender `json:"lenders"`
}

此时，PagedLoanResponse 和 PagedLenderResponse 都实现了 Pagable 接口，且 JSON 反序列化时能正确填充 paging 和 items 字段（json 标签仍生效）。

✅ 改写 `doPaged`：接收接口，消除反射

现在可重写 doPaged 方法，签名更清晰、类型安全、无需 reflect：

func (c *Client) doPaged(
    method, urlpath string,
    query url.Values,
    body io.Reader,
    v Pagable, // ← 接收接口，而非 interface{}
    numPages int,
) (interface{}, error) {
    if numPages <blockquote><p>⚠️ 注意：虽然 <code>v</code> 是接口，但 <code>Items</code> 字段名固定，因此只需一次反射提取其值；相比原方案全程反射操作 <code>pr</code>，此处反射范围极小，且完全可控。</p></blockquote><h3>✅ 使用示例：简洁、类型安全</h3><pre class="brush:php;toolbar:false;">func (c *Client) GetNewestLoans(numPages int) ([]Loan, error) {
    baseURL := "/v1/loans/newest"
    var resp PagedLoanResponse
    items, err := c.doPaged("GET", baseURL, nil, nil, &resp, numPages)
    if err != nil {
        return nil, err
    }
    return items.([]Loan), nil // 类型断言明确，编译期可检
}

func (c *Client) GetTopLenders(numPages int) ([]Lender, error) {
    baseURL := "/v1/lenders/top"
    var resp PagedLenderResponse
    items, err := c.doPaged("GET", baseURL, nil, nil, &resp, numPages)
    if err != nil {
        return nil, err
    }
    return items.([]Lender), nil
}