Android Java中如何通过Github API的rel="next"实现分页（替代手动页码递增）

刚好我之前做过类似的需求，用Retrofit2结合响应头里的rel="next"来实现自动分页完全可行，不用再手动管理page参数了，给你一步步拆解实现方法：

1. 调整Retrofit Service接口 #

首先我们需要新增一个能直接请求任意URL的方法，用来调用rel="next"指向的链接，修改后的接口如下：

public interface ApiService {
    // 初始请求第一页的方法（也可用于指定page请求，但我们主要用它拿第一页数据）
    @GET("user/repos")
    Call<Repos> getRepos(@Query("api_key") String apiKey, @Query("page") int pageIndex);

    // 用来请求next链接的方法，@Url会覆盖@GET里的固定路径
    @GET
    Call<Repos> getNextRepos(@Url String nextUrl);
}

2. 解析响应头中的Link字段，提取rel="next"的URL #

服务器返回的Link响应头格式通常是这样的：

<https://your-api-domain/user/repos?api_key=xxx&page=2>; rel="next", <https://your-api-domain/user/repos?api_key=xxx&page=5>; rel="last"

我们需要写一个工具方法来解析这个字段，提取出rel="next"对应的URL：

public class PagingUtils {
    // 解析Link头，获取next页面的URL
    public static String extractNextPageUrl(String linkHeader) {
        if (linkHeader == null || linkHeader.isEmpty()) {
            return null;
        }

        // 分割多个链接（用逗号分隔）
        String[] links = linkHeader.split(",");
        for (String link : links) {
            // 分割URL和rel参数（用分号分隔）
            String[] parts = link.split(";");
            if (parts.length >= 2) {
                String urlPart = parts[0].trim();
                String relPart = parts[1].trim();

                // 去掉URL的尖括号
                if (urlPart.startsWith("<") && urlPart.endsWith(">")) {
                    String url = urlPart.substring(1, urlPart.length() - 1);
                    // 检查rel是否为next
                    if (relPart.equals("rel=\"next\"")) {
                        return url;
                    }
                }
            }
        }
        return null; // 没有next页面
    }
}

3. 发起请求并处理自动分页 #

在你的业务代码中（比如Activity、ViewModel），先发起第一页请求，然后在回调中解析Link头，拿到next URL后继续请求：

// 初始化Retrofit和ApiService（这里假设你已经有了Retrofit实例）
ApiService apiService = retrofit.create(ApiService.class);

// 第一页请求
apiService.getRepos("your_api_key", 1).enqueue(new Callback<Repos>() {
    @Override
    public void onResponse(Call<Repos> call, Response<Repos> response) {
        if (response.isSuccessful() && response.body() != null) {
            // 处理当前页的数据（比如添加到列表、刷新UI）
            handleReposData(response.body());

            // 提取next页面的URL
            String nextUrl = PagingUtils.extractNextPageUrl(response.headers().get("Link"));
            if (nextUrl != null) {
                // 有下一页，发起请求
                requestNextPage(nextUrl);
            } else {
                // 没有下一页了，结束分页
                Toast.makeText(context, "已加载全部数据", Toast.LENGTH_SHORT).show();
            }
        }
    }

    @Override
    public void onFailure(Call<Repos> call, Throwable t) {
        // 处理请求失败逻辑
        t.printStackTrace();
    }
});

// 封装请求下一页的方法
private void requestNextPage(String nextUrl) {
    apiService.getNextRepos(nextUrl).enqueue(new Callback<Repos>() {
        @Override
        public void onResponse(Call<Repos> call, Response<Repos> response) {
            if (response.isSuccessful() && response.body() != null) {
                handleReposData(response.body());

                // 继续检查是否有下一页
                String nextPageUrl = PagingUtils.extractNextPageUrl(response.headers().get("Link"));
                if (nextPageUrl != null) {
                    requestNextPage(nextPageUrl);
                } else {
                    Toast.makeText(context, "已加载全部数据", Toast.LENGTH_SHORT).show();
                }
            }
        }

        @Override
        public void onFailure(Call<Repos> call, Throwable t) {
            t.printStackTrace();
        }
    });
}

// 处理数据的业务方法
private void handleReposData(Repos repos) {
    // 示例：添加到列表并刷新适配器
    // repoList.addAll(repos.getItems());
    // repoAdapter.notifyDataSetChanged();
}

4. 注意事项 #

• 确保你的服务器确实在响应头中返回了Link字段，并且包含rel="next"的条目，如果服务器未返回该字段，此方法无法生效。
• 可以根据需求调整分页触发逻辑，比如改成RecyclerView滚动到底部再请求下一页，而非自动连续加载。
• 建议添加请求失败的重试逻辑，避免单次请求失败就终止分页流程。

内容的提问来源于stack exchange，提问作者Den