SpringBoot中Pageable分页参数的自动提取与全局复用

@GetMapping("/users")
public Page<User> getUsers(Pageable pageable) {
    return userService.findAll(pageable);
}

GET /users?page=0&size=10&sort=name,asc

@Configuration
public class WebConfig {

    @Bean
    public PageableHandlerMethodArgumentResolverCustomizer pageableCustomizer() {
        return resolver -> {
            resolver.setOneIndexedParameters(true); // 启用 page=1 表示第一页
            resolver.setMaxPageSize(100);           // 限制最大每页条数
            resolver.setFallbackPageable(PageRequest.of(0, 20)); // 默认分页
        };
    }
}

public class PageResult<T> {
    private List<T> content;
    private long totalElements;
    private int totalPages;
    private int pageNumber; // 1-based
    private int pageSize;

    // 构造方法 + getter/setter
    public static <T> PageResult<T> of(Page<T> page) {
        PageResult<T> result = new PageResult<>();
        result.content = page.getContent();
        result.totalElements = page.getTotalElements();
        result.totalPages = page.getTotalPages();
        result.pageNumber = page.getNumber() + 1; // 转为 1-based
        result.pageSize = page.getSize();
        return result;
    }
}

@GetMapping("/users")
public PageResult<User> getUsers(Pageable pageable) {
    Page<User> page = userService.findAll(pageable);
    return PageResult.of(page);
}

public class UserQuery {
    private String keyword;
    private String status;
    // 分页参数通过继承或组合 Pageable 获取
    private Pageable pageable;

    // 或者手动解析
    private Integer page = 1;
    private Integer size = 20;

    public Pageable toPageable() {
        return PageRequest.of(
            Math.max(0, page - 1), 
            Math.min(size, 100),
            Sort.by("createTime").descending()
        );
    }
}

@GetMapping("/users")
public PageResult<User> getUsers(UserQuery query) {
    Page<User> page = userService.search(query.getKeyword(), query.getStatus(), query.toPageable());
    return PageResult.of(page);
}

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleException(Exception e) {
        if (e instanceof IllegalArgumentException && e.getMessage().contains("Page index")) {
            return ResponseEntity.badRequest().body(new ErrorResponse("无效的页码"));
        }
        // 其他异常处理...
    }
}