feat: implement cast, right, left, replace expressions

[cj848]

Motivation

• This PR introduces new string manipulation functions (CAST, LEFT, RIGHT, REPLACE) to the Kotlin JDSL JPQL DSL. These functions align with the JPA 3.2 specification, providing enhanced capabilities for string operations directly within JPQL queries. This change aims to expand the functionality of Kotlin JDSL to support more advanced JPQL features as defined in the latest JPA specifications.

Modifications

• Added cast, left, right, and replace functions to dsl/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/dsl/jpql/Jpql.kt for use within jpql {} blocks.
• Implemented corresponding JpqlCast, JpqlLeft, JpqlRight, JpqlReplace expression types in query-model/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/querymodel/jpql/expression/impl/.
• Added serializers for these new expression types in render/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/.
• Created unit tests for the new serializers in render/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/.
• Added DSL usage tests for the new functions in dsl/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/dsl/jpql/expression/ExpressionDslTest.kt.
• Updated documentation (docs/en/jpql-with-kotlin-jdsl/expressions.md and docs/ko/jpql-with-kotlin-jdsl/expressions.md) to include details and examples of the new functions, noting their addition in JPA 3.2.

Result

• After this PR is merged, users will be able to utilize CAST, LEFT, RIGHT, and REPLACE functions directly within their Kotlin JDSL JPQL queries, enabling more powerful and flexible string manipulation operations. The documentation will also be updated to reflect these new capabilities.

Closes

• N/A (No specific issue is being closed by this PR, it's a new feature implementation)

---

동기

• 이 PR은 Kotlin JDSL JPQL DSL에 새로운 문자열 조작 함수(CAST, LEFT, RIGHT, REPLACE)를 도입합니다. 이 함수들은 JPA 3.2 스펙에 맞춰 JPQL 쿼리 내에서 문자열 연산을 위한 향상된 기능을 제공합니다. 이 변경은 최신 JPA 스펙에 정의된 고급 JPQL 기능을 지원하기 위해 Kotlin JDSL의 기능을 확장하는 것을 목표로 합니다.

수정 사항

• jpql {} 블록 내에서 사용할 수 있도록 dsl/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/dsl/jpql/Jpql.kt에 cast, left, right, replace 함수를 추가했습니다.
• query-model/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/querymodel/jpql/expression/impl/에 해당 JpqlCast, JpqlLeft, JpqlRight, JpqlReplace expression 타입을 구현했습니다.
• render/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/에 새로운 expression 타입에 대한 Serializer를 추가했습니다.
• render/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/에 새로운 Serializer에 대한 단위 테스트를 생성했습니다.
• dsl/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/dsl/jpql/expression/ExpressionDslTest.kt에 새로운 함수에 대한 DSL 사용 테스트를 추가했습니다.
• JPA 3.2에 추가된 기능임을 명시하고 새로운 함수에 대한 세부 정보 및 예제를 포함하도록 문서(docs/en/jpql-with-kotlin-jdsl/expressions.md 및 docs/ko/jpql-with-kotlin-jdsl/expressions.md)를 업데이트했습니다.

결과

• 이 PR이 병합되면 사용자는 Kotlin JDSL JPQL 쿼리 내에서 CAST, LEFT, RIGHT, REPLACE 함수를 직접 활용하여 더욱 강력하고 유연한 문자열 조작 작업을 수행할 수 있게 됩니다. 문서 또한 이러한 새로운 기능을 반영하여 업데이트될 것입니다.

닫는 이슈

• N/A (이 PR은 특정 이슈를 닫지 않으며, 새로운 기능 구현입니다.)

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 93.65079% with 4 lines in your changes missing coverage. Please review.

Project coverage is 90.74%. Comparing base (ca9f2fc) to head (1ccf936).
Report is 1 commits behind head on develop.

Files with missing lines	Patch %	Lines
.../render/jpql/serializer/impl/JpqlCastSerializer.kt	87.50%	1 Missing ⚠️
.../render/jpql/serializer/impl/JpqlLeftSerializer.kt	87.50%	1 Missing ⚠️
...nder/jpql/serializer/impl/JpqlReplaceSerializer.kt	90.00%	1 Missing ⚠️
...render/jpql/serializer/impl/JpqlRightSerializer.kt	87.50%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #894      +/-   ##
===========================================
+ Coverage    90.69%   90.74%   +0.04%     
===========================================
  Files          344      352       +8     
  Lines         3688     3751      +63     
  Branches       227      227              
===========================================
+ Hits          3345     3404      +59     
- Misses         271      275       +4     
  Partials        72       72              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.