Motivation

• Fix a BadJpqlGrammarException that occurs in Spring Boot 4 (Spring Data JPA 3.4+) environments when using findPage with certain valid JPQL constructs.
• Spring Data JPA 3.4 introduced a strict ANTLR-based JPQL parser for query enhancement, which rejects keywords like NULL within SELECT NEW constructor expressions.
• Provide a robust, provider-agnostic way to generate count queries by leveraging Kotlin JDSL's internal Query Model instead of fragile string-based re-parsing.

Modifications

• Model-based Count Query Generation:
  • Added SelectQueries.toCountQuery() utility in the query-model-jpql module. This allows safe transformation of a SelectQuery into a COUNT(1) query at the model level.
  • Updated JpqlEntityManagerUtils.kt in both support/spring-data-jpa and support/spring-data-jpa-boot4 modules to use this model-based approach for generating count queries.
• Visibility and Compatibility Fixes:
  • Resolved Kotlin visibility-related copy() warnings (KT-11914) by encapsulating the transformation logic within the same module as the internal constructors.
  • Ensured the solution remains vendor-neutral, working seamlessly across Hibernate, EclipseLink, and other JPA providers without provider-specific code.
• Validation:
  • Added Issue1039Test.kt in both example/spring-data-jpa and example/spring-data-jpa-boot4 to reproduce the reported issue and verify the fix.
  • Updated JpqlEntityManagerUtilsTest.kt to cover the new model-based execution path.

Result

• Kotlin JDSL now supports pagination (findPage) for queries containing NULL literals or other complex expressions in SELECT NEW clauses on Spring Boot 4.
• Pagination logic is now more efficient and reliable by avoiding redundant string-based parsing during query enhancement.
• Consistent behavior across all Spring Data JPA support modules (Boot 2/3 and Boot 4).

Closes

#1039

--- korean

Motivation

• Spring Boot 4 (Spring Data JPA 3.4+) 환경에서 findPage 호출 시 일부 유효한 JPQL 구문에 대해 발생하는 BadJpqlGrammarException을 해결합니다.
• Spring Data JPA 3.4부터 도입된 엄격한 ANTLR 기반 JPQL 파서가 SELECT NEW 생성자 내의 NULL 키워드 등을 거부하는 문제를 해결하기 위함입니다.
• 문자열 재파싱 방식(QueryEnhancer) 대신 Kotlin JDSL의 쿼리 모델(Query Model) 을 직접 조작하여 카운트 쿼리를 생성함으로써 근본적이고 프로바이더 중립적인 해결책을 제공합니다.

Modifications

• 모델 기반 카운트 쿼리 생성:
  • query-model-jpql 모듈에 SelectQueries.toCountQuery() 유틸리티를 추가하여 모델 수준에서 SelectQuery를 COUNT(1) 쿼리로 안전하게 변환하도록 했습니다.
  • support/spring-data-jpa 및 support/spring-data-jpa-boot4 모듈의 JpqlEntityManagerUtils.kt가 문자열 파서 대신 이 모델 기반 방식을 사용하도록 수정했습니다.
• 가시성 및 호환성 개선:
  • internal 생성자 접근으로 인한 Kotlin copy() 경고(KT-11914)를 변환 로직의 모듈 내 캡슐화를 통해 해결했습니다.
  • 특정 JPA 벤더 전용 코드를 사용하지 않고 표준 JDSL 모델만 사용하여 벤더 중립성을 유지했습니다.
• 검증:
  • example/spring-data-jpa 및 example/spring-data-jpa-boot4에 Issue1039Test.kt를 추가하여 문제를 재현하고 해결 여부를 검증했습니다.
  • JpqlEntityManagerUtilsTest.kt를 업데이트하여 모델 기반 카운트 쿼리 생성 경로를 테스트하도록 보강했습니다.

Result

• Spring Boot 4 환경에서도 SELECT NEW 절에 NULL 리터럴 등이 포함된 쿼리에 대해 페이지네이션(findPage) 기능을 정상적으로 사용할 수 있습니다.
• 쿼리 강화 과정에서 불필요한 문자열 파싱을 생략하여 페이지네이션 로직의 효율성과 안정성이 향상되었습니다.
• 모든 Spring Data JPA 지원 모듈(Boot 2/3 및 Boot 4)에서 일관된 동작을 보장합니다.

Closes

#1039