📣 easy-paging 0.5.0 released — Spring Boot 4 line, with 0.4.x maintenance / SB4 라인 출시 + 0.4.x 유지보수

[jlc488]

English · 한국어

TL;DR

• easy-paging-spring-boot-starter 0.5.0 released to Maven Central — first cut of the Spring Boot 4 line (Spring Framework 7 / Jackson 3 / PageHelper 4.0 / mybatis-spring-boot-starter 4.0).
• The 0.4.x branch continues as the SB 3.3–3.5 maintenance line — already received its first patch bumps after the split.
• 4 new SB4 demos added in this repo (easy-paging-sb4-demo, -sb4-keyset-demo, -sb4-postgres-demo, -sb4-reactive-demo) alongside the existing 4 SB3 demos.

Choose your line

Need	Use	Demos
Spring Boot 4+	kr.devslab:easy-paging-spring-boot-starter:0.5.0	easy-paging-sb4-demo, -sb4-keyset-demo, -sb4-postgres-demo, -sb4-reactive-demo
Spring Boot 3.3–3.5	kr.devslab:easy-paging-spring-boot-starter:0.4.0	easy-paging-demo, -keyset-demo, -postgres-demo, -reactive-demo

API surface is the same on both lines — @AutoPaginate, @KeysetPaginate, PageResponse<T>, KeysetPage<T>, R2dbcOffsetPagingSupport, etc. all carried over identically. Only the underlying runtime BOM differs.

SB4 migration notes (if you are coming from 0.4.x)

The 0.5.0 release captured every surprise from the migration in the PR body — main ones to watch for in your own code:

• io.spring.dependency-management 1.1.6 is silently incompatible with the SB4 BOM → bump to 1.1.7.
• spring-boot-starter-aop was renamed to spring-boot-starter-aspectj in SB4. The error message just says "Could not find ... -aop:." (empty version), not "wrong artifact ID" — easy to misread.
• @AutoConfigureMockMvc / @AutoConfigureWebTestClient moved out of spring-boot-test-autoconfigure into dedicated spring-boot-starter-{webmvc,webflux}-test modules with new package paths.
• Jackson 2 → 3 package move (com.fasterxml.jackson.* → tools.jackson.*), JavaTimeModule auto-registered (no longer needs explicit .registerModule(...)), JsonNode.asText() deprecated → asString(), spring.jackson.serialization.write-dates-as-timestamps removed (default is now ISO-8601).
• SB4 dropped auto-registration of PageableHandlerMethodArgumentResolver for servlet MVC — starter 0.5.0 wires it itself (and the reactive equivalent), so you no longer need a per-app WebMvcConfigurer/WebFluxConfigurer for Pageable pageable controller parameters.
• Testcontainers 2.x rename: artifact IDs got a testcontainers- prefix (postgresql → testcontainers-postgresql), classes moved out of org.testcontainers.containers.* into dedicated per-module packages, and the self-typed generic on PostgreSQLContainer<SELF> / MySQLContainer<SELF> was removed.
• Gradle ≥ 8.14 required (SB4 plugin refuses to apply on older Gradle).

If you bump the demos directly: PR #50 on the starter and PR #39 on this repo are the reference walkthroughs.

Related links

• 📦 Maven Central: easy-paging-spring-boot-starter · -reactive
• 🔧 Starter repo: main (SB4) · 0.4.x (SB3 maintenance)
• 📖 Documentation: easy-paging.devslab.kr

---

한국어 — 한눈에

• **easy-paging-spring-boot-starter 0.5.0**이 Maven Central에 publish — Spring Boot 4 라인 첫 release (Spring Framework 7 / Jackson 3 / PageHelper 4.0 / mybatis-spring-boot-starter 4.0).
• 0.4.x 브랜치는 SB 3.3–3.5 maintenance 라인으로 계속 유지 — 분기 직후 첫 패치 bump들도 들어옴.
• 이 repo에 새 SB4 데모 4개 추가 (easy-paging-sb4-demo, -sb4-keyset-demo, -sb4-postgres-demo, -sb4-reactive-demo) — 기존 4개 SB3 데모와 나란히.

어느 라인 쓰세요?

필요한 환경	사용 좌표	데모
Spring Boot 4+	kr.devslab:easy-paging-spring-boot-starter:0.5.0	easy-paging-sb4-demo 외 3개
Spring Boot 3.3–3.5	kr.devslab:easy-paging-spring-boot-starter:0.4.0	easy-paging-demo 외 3개

API 표면은 양쪽 라인 동일 — @AutoPaginate, @KeysetPaginate, PageResponse<T>, KeysetPage<T>, R2dbcOffsetPagingSupport 등 모두 그대로. 단 BOM과 런타임 의존성만 SB 메이저 따라 다름.

SB4 마이그레이션 노트 (0.4.x에서 올라오는 경우)

마이그레이션 중 만난 모든 surprise는 0.5.0 release PR 본문에 기록되어 있고, 직접 코드 마이그레이션할 때 주의할 큰 항목들:

• io.spring.dependency-management 1.1.6은 SB4 BOM과 silently 호환 안 됨 → 1.1.7로 bump.
• spring-boot-starter-aop가 SB4에서 spring-boot-starter-aspectj로 rename됨. 에러 메시지는 "Could not find ... -aop:." (version 빈 채) — "wrong artifact ID" 가 아니라 "version 못 찾음"으로 보임.
• @AutoConfigureMockMvc / @AutoConfigureWebTestClient 이동 — spring-boot-test-autoconfigure에서 빠지고 spring-boot-starter-{webmvc,webflux}-test 별도 모듈 + 새 패키지 경로.
• Jackson 2 → 3 패키지 이동 (com.fasterxml.jackson.* → tools.jackson.*), JavaTimeModule 자동 등록됨 (별도 .registerModule(...) 불필요), JsonNode.asText() deprecated → asString(), spring.jackson.serialization.write-dates-as-timestamps 제거 (기본이 ISO-8601).
• SB4가 servlet MVC의 PageableHandlerMethodArgumentResolver auto-config을 dropping — starter 0.5.0이 자체 등록 (reactive도 동일). 더 이상 앱별 WebMvcConfigurer/WebFluxConfigurer로 Pageable pageable 컨트롤러 파라미터를 wire할 필요 없음.
• Testcontainers 2.x rename: artifact ID가 testcontainers- prefix 추가 (postgresql → testcontainers-postgresql), 클래스가 org.testcontainers.containers.*에서 모듈별 패키지로 이동, PostgreSQLContainer<SELF> / MySQLContainer<SELF>의 self-typed generic 제거.
• Gradle ≥ 8.14 필요 (SB4 plugin이 그 이전 Gradle에서 apply 거부).

데모 직접 bump 참고: 스타터 PR #50, 이 repo PR #39.

링크

• 📦 Maven Central: easy-paging-spring-boot-starter · -reactive
• 🔧 스타터 repo: main (SB4) · 0.4.x (SB3 maintenance)
• 📖 문서: easy-paging.devslab.kr