SpringBoot的@HttpExchange是否支持Pageable参数？有无相关规划？

一、@HttpExchange 对 Pageable 的原生支持现状 #

• 当前Spring Framework（Spring Boot集成的HttpInterface机制）没有原生支持将Pageable接口作为@HttpExchange方法的参数，无法自动把Pageable对象转换为目标服务所需的page、size、sort这类URL查询参数。
• 关于官方支持规划：目前Spring官方尚未公开明确的时间表或规划来添加该原生支持，不过社区已有相关需求讨论，可关注Spring Framework的issue追踪平台获取动态。

二、跨服务代理 Pageable 请求的可行方案 #

并非无法实现代理，只需手动处理参数转换，有两种常用方式：

1. 手动拆解 Pageable 参数 #

在HttpInterface的方法中，直接将Pageable拆解为对应的查询参数：

@HttpExchange(url = "/target-api/data", method = HttpMethod.GET)
ResponseEntity<Page<DataDTO>> getData(
    @RequestParam("page") int page,
    @RequestParam("size") int size,
    @RequestParam("sort") String sort
);

调用时从传入的Pageable中提取对应值：

// 假设从Controller接收的Pageable参数
Pageable pageable = PageRequest.of(0, 10, Sort.by("id").descending());
String sortStr = pageable.getSort().stream()
    .map(order -> order.getProperty() + "," + order.getDirection())
    .collect(Collectors.joining(","));
dataClient.getData(pageable.getPageNumber(), pageable.getPageSize(), sortStr);

2. 自定义参数解析器 #

实现HttpServiceArgumentResolver接口，让框架自动处理Pageable到查询参数的转换：

public class PageableHttpServiceArgumentResolver implements HttpServiceArgumentResolver {
    @Override
    public boolean resolve(ArgumentResolverContext context, HttpRequestValues.Builder requestValues) {
        MethodParameter parameter = context.getMethodParameter();
        if (Pageable.class.isAssignableFrom(parameter.getParameterType())) {
            Pageable pageable = (Pageable) context.getArgument();
            requestValues.addRequestParameter("page", String.valueOf(pageable.getPageNumber()));
            requestValues.addRequestParameter("size", String.valueOf(pageable.getPageSize()));
            pageable.getSort().forEach(order -> {
                requestValues.addRequestParameter("sort", order.getProperty() + "," + order.getDirection());
            });
            return true;
        }
        return false;
    }
}

然后将该解析器注册到HttpServiceProxyFactory：

@Bean
public DataClient dataClient(RestClient restClient) {
    HttpServiceProxyFactory factory = HttpServiceProxyFactory.builderFor(restClient)
        .argumentResolver(new PageableHttpServiceArgumentResolver())
        .build();
    return factory.createClient(DataClient.class);
}

之后就可以在@HttpExchange方法中直接使用Pageable参数：

@HttpExchange(url = "/target-api/data", method = HttpMethod.GET)
ResponseEntity<Page<DataDTO>> getData(Pageable pageable);

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