로드맵¶

easy-paging의 향후 계획을 정리한 살아있는 문서입니다. 항목은 느슨한 약속 — 기대치는 잡되, 사용자 피드백에 따라 유연하게 조정됩니다. 항목을 위/아래로 옮기고 싶다면 이슈를 열어주세요.

정식 버전은 ROADMAP.md에 있습니다. 출시 완료된 기능은 변경 이력을 참고하세요.

최근 출시¶

릴리스	주요 변경
v4.0.0	Spring-major-정렬 버전 정책 — `0.5.0`의 재번호링. 라이브러리 메이저가 이제 Spring Boot 메이저와 일치 (4.x = SB4, 3.x = SB3). 코드 동일, 좌표만 새로. VERSIONING 정책 참조.
v3.0.0	Spring Boot 3 maintenance 라인을 `0.4.0`에서 재번호링. 코드 동일, 좌표만 새로. SB 3.3–3.5 maintenance가 여기서 계속, 보안 패치 제공.
v0.5.0	Spring Boot 4 릴리즈 라인. SB4 / Spring Framework 7 / Jackson 3 베이스라인. PageHelper 4.0.0 + MyBatis 4.0.1 (SB4 호환). `spring-boot-starter-aop` → `spring-boot-starter-aspectj`. 스타터가 이제 `PageableHandlerMethodArgumentResolver` + `SortHandlerMethodArgumentResolver`를 자동 등록 (SB4가 auto-config 제거).
v0.4.0	새 옵션 아티팩트 `easy-paging-spring-boot-starter-reactive`로 네이티브 R2DBC + WebFlux 지원. Gradle 빌드 멀티-모듈 구조로 마이그레이션. Testcontainers dialect-compat 테스트 레이어 (PostgreSQL + MySQL).
v0.3.0	Keyset 역방향 (`prevCursor` 활성화). Spring Boot 베이스라인 3.3.5 → 3.5.3. PageHelper 2.1.1 + transitive MyBatis starter `api`로 승격.

전체 노트는 변경 이력 참조.

v4.0.0 이후 사용자 피드백에 따라 형태가 결정됩니다. 현재 검토 중 섹션의 항목들이 후보 — 원하는 항목에 이슈로 투표해주세요.

3.x maintenance 브랜치는 Spring Boot 3.5 자체가 upstream에서 지원받는 동안 보안 패치와 의존성 bump를 계속 받습니다.

v0.x가 안정되고 실제 사용자 피드백이 쌓이면. v1.0은 SemVer 하에 API 안정성을 약속 — 깨는 변경은 메이저 bump에서만.

Spring Security / 테넌트 리졸버와 연동하여 테넌트별 기본값 적용:

easy-paging:
  tenants:
    tenant-a:
      max-page-size: 100
    tenant-b:
      max-page-size: 1000

직접적 동기: row-level 멀티테넌시를 쓰는 SaaS가 고객 플랜별로 export 크기를 제한하고 싶을 때 (전역이 아니라).

현재 엔진은 PageHelper로 하드와이어. v1.0은 엔진 경계를 추상화하여 같은 @AutoPaginate 어노테이션으로 다음을 구동:

엔진	대상
JPA Specification	이미 Spring Data JPA를 쓰는 프로젝트
jOOQ	타입-안전 SQL 선호자
순수 JDBC + `NamedParameterJdbcTemplate`	최소 의존성 셋업

@AutoPaginate 어노테이션은 그대로 유지; 소비자가 easy-paging.engine: pagehelper | jpa | jooq | jdbc 로 엔진 선택.

레이더에 올라가 있는 것들. 강한 의견이 있거나, 이 중 하나가 본인의 채택을 막고 있다면 이슈 열어주세요.

아이디어	매력	망설임
커서 만료 / TTL	도난 커서 피해 제한	복잡도 증가, 대부분 팀은 체감 못 함
요청별 커서 시크릿 로테이션	고보안 도메인 위한 방어 1겹 더	니치; 현재 HMAC도 충분히 강력
GraphQL Relay 스타일 connection	널리 쓰이는 spec 정렬	소비자에 GraphQL 스택 필요
스트리밍 export (chunked `Transfer-Encoding`)	"1M 행 export" 사용 사례 해결	페이지네이션과 다른 문제; 별도 라이브러리에 속할 수도
내장 메트릭 (Micrometer)	페이지네이션 레이턴시, 쿼리 카운트 관측	사용자가 직접 추가하기 쉬움
Spring Native / GraalVM 네이티브 지원	클라우드 네이티브 배포 스토리	PageHelper의 reflection 패턴 검증 필요

명시적으로 검토 후 안 하기로 결정한 것들.

NoSQL 페이지네이션 어댑터 (Mongo, DynamoDB, Elasticsearch). PageHelper/JPA 정신 모델로 잘 옮겨지지 않는 고유 패턴 보유. 전용 라이브러리가 더 적합.
프론트엔드 페이지네이션 컴포넌트. 서버사이드 라이브러리. 알맞은 클라이언트 라이브러리와 페어링.
PageHelper가 이미 지원하는 것 외의 SQL 방언 커스텀 지원. PageHelper가 흔한 DB (MySQL, PostgreSQL, Oracle, SQL Server, H2, DB2, MariaDB 등) 다 커버; 여러분 DB가 거기 없다면 추가는 PageHelper 쪽에서.