Skip to content

Commit 1ccf936

Browse files
cj848cj848
committed
feat: implement cast, right, left, replace expressions
1 parent ca9f2fc commit 1ccf936

File tree

18 files changed

+688
-0
lines changed

18 files changed

+688
-0
lines changed

‎docs/en/jpql-with-kotlin-jdsl/expressions.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -199,6 +199,10 @@ Kotlin JDSL provides a series of functions to support built-in functions in JPA.
199199
* UPPER (upper)
200200
* LENGTH (length)
201201
* LOCATE (locate)
202+
* CAST (cast) - *Added in JPA 3.2*
203+
* LEFT (left) - *Added in JPA 3.2*
204+
* RIGHT (right) - *Added in JPA 3.2*
205+
* REPLACE (replace) - *Added in JPA 3.2*
202206

203207
```kotlin
204208
concat(path(Book::title), literal(":"), path(Book::imageUrl))
@@ -215,6 +219,18 @@ upper(path(Book::title))
215219
length(path(Book::title))
216220

217221
locate("Book", path(Book::title))
222+
223+
cast(path(Book::price), String::class)
224+
cast<String>(path(Book::price))
225+
226+
left(path(Book::title), 3)
227+
left(path(Book::title), literal(3))
228+
229+
right(path(Book::title), 3)
230+
right(path(Book::title), literal(3))
231+
232+
replace(path(Book::title), "old", "new")
233+
replace(path(Book::title), literal("old"), literal("new"))
218234
```
219235

220236
### Arithmetic functions

‎docs/ko/jpql-with-kotlin-jdsl/expressions.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,10 @@ Kotlin JDSL은 JPA에서 제공하는 여러 함수들을 지원하기 위한
197197
* UPPER (upper)
198198
* LENGTH (length)
199199
* LOCATE (locate)
200+
* CAST (cast) - *JPA 3.2에 추가됨*
201+
* LEFT (left) - *JPA 3.2에 추가됨*
202+
* RIGHT (right) - *JPA 3.2에 추가됨*
203+
* REPLACE (replace) - *JPA 3.2에 추가됨*
200204

201205
```kotlin
202206
concat(path(Book::title), literal(":"), path(Book::imageUrl))
@@ -213,6 +217,18 @@ upper(path(Book::title))
213217
length(path(Book::title))
214218

215219
locate("Book", path(Book::title))
220+
221+
cast(path(Book::price), String::class)
222+
cast<String>(path(Book::price))
223+
224+
left(path(Book::title), 3)
225+
left(path(Book::title), literal(3))
226+
227+
right(path(Book::title), 3)
228+
right(path(Book::title), literal(3))
229+
230+
replace(path(Book::title), "old", "new")
231+
replace(path(Book::title), literal("old"), literal("new"))
216232
```
217233

218234
### Arithmetic functions

‎dsl/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/dsl/jpql/Jpql.kt

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1705,6 +1705,78 @@ open class Jpql : JpqlDsl {
17051705
)
17061706
}
17071707

1708+
/**
1709+
* Creates an expression that represents the casting of a value to a different type.
1710+
*/
1711+
@SinceJdsl("3.6.0")
1712+
fun <T : Any> cast(value: Expressionable<*>, type: KClass<T>): Expression<T> {
1713+
return Expressions.cast(value.toExpression(), type)
1714+
}
1715+
1716+
/**
1717+
* Creates an expression that represents the casting of a value to a different type.
1718+
*/
1719+
@SinceJdsl("3.6.0")
1720+
inline fun <reified T : Any> cast(value: Expressionable<*>): Expression<T> {
1721+
return Expressions.cast(value.toExpression(), T::class)
1722+
}
1723+
1724+
/**
1725+
* Creates an expression that returns the leftmost count characters from a string.
1726+
*/
1727+
@SinceJdsl("3.6.0")
1728+
fun left(value: Expressionable<String>, count: Expressionable<Int>): Expression<String> {
1729+
return Expressions.left(value.toExpression(), count.toExpression())
1730+
}
1731+
1732+
/**
1733+
* Creates an expression that returns the leftmost count characters from a string.
1734+
*/
1735+
@SinceJdsl("3.6.0")
1736+
fun left(value: Expressionable<String>, count: Int): Expression<String> {
1737+
return Expressions.left(value.toExpression(), intLiteral(count))
1738+
}
1739+
1740+
/**
1741+
* Creates an expression that returns the rightmost count characters from a string.
1742+
*/
1743+
@SinceJdsl("3.6.0")
1744+
fun right(value: Expressionable<String>, count: Expressionable<Int>): Expression<String> {
1745+
return Expressions.right(value.toExpression(), count.toExpression())
1746+
}
1747+
1748+
/**
1749+
* Creates an expression that returns the rightmost count characters from a string.
1750+
*/
1751+
@SinceJdsl("3.6.0")
1752+
fun right(value: Expressionable<String>, count: Int): Expression<String> {
1753+
return Expressions.right(value.toExpression(), intLiteral(count))
1754+
}
1755+
1756+
/**
1757+
* Creates an expression that replaces all occurrences of a search string with a replacement string.
1758+
*/
1759+
@SinceJdsl("3.6.0")
1760+
fun replace(
1761+
value: Expressionable<String>,
1762+
search: Expressionable<String>,
1763+
replacement: Expressionable<String>,
1764+
): Expression<String> {
1765+
return Expressions.replace(value.toExpression(), search.toExpression(), replacement.toExpression())
1766+
}
1767+
1768+
/**
1769+
* Creates an expression that replaces all occurrences of a search string with a replacement string.
1770+
*/
1771+
@SinceJdsl("3.6.0")
1772+
fun replace(
1773+
value: Expressionable<String>,
1774+
search: String,
1775+
replacement: String,
1776+
): Expression<String> {
1777+
return Expressions.replace(value.toExpression(), stringLiteral(search), stringLiteral(replacement))
1778+
}
1779+
17081780
/**
17091781
* Creates an expression that represents predefined database functions and user-defined database functions.
17101782
*/

‎dsl/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/dsl/jpql/expression/ExpressionDslTest.kt

Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,4 +44,158 @@ class ExpressionDslTest : WithAssertions {
4444

4545
assertThat(actual).isEqualTo(expected)
4646
}
47+
48+
@Test
49+
fun `cast() with a expression and a class`() {
50+
// when
51+
val expression = queryPart {
52+
cast(expression(String::class, alias1), Int::class)
53+
}.toExpression()
54+
55+
val actual: Expression<Int> = expression // for type check
56+
57+
// then
58+
val expected = Expressions.cast(
59+
Expressions.expression(String::class, alias1),
60+
Int::class,
61+
)
62+
63+
assertThat(actual).isEqualTo(expected)
64+
}
65+
66+
@Test
67+
fun `inline cast() with a expression and a class`() {
68+
// when
69+
val expression = queryPart {
70+
cast<Int>(expression(String::class, alias1))
71+
}.toExpression()
72+
73+
val actual: Expression<Int> = expression // for type check
74+
75+
// then
76+
val expected = Expressions.cast(
77+
Expressions.expression(String::class, alias1),
78+
Int::class,
79+
)
80+
81+
assertThat(actual).isEqualTo(expected)
82+
}
83+
84+
@Test
85+
fun `left() with two expressions`() {
86+
// when
87+
val expression = queryPart {
88+
left(expression(String::class, alias1), expression(Int::class, "alias2"))
89+
}.toExpression()
90+
91+
val actual: Expression<String> = expression // for type check
92+
93+
// then
94+
val expected = Expressions.left(
95+
Expressions.expression(String::class, alias1),
96+
Expressions.expression(Int::class, "alias2"),
97+
)
98+
99+
assertThat(actual).isEqualTo(expected)
100+
}
101+
102+
@Test
103+
fun `left() literal with two expressions`() {
104+
// when
105+
val expression = queryPart {
106+
left(expression(String::class, alias1), 1)
107+
}.toExpression()
108+
109+
val actual: Expression<String> = expression // for type check
110+
111+
// then
112+
val expected = Expressions.left(
113+
Expressions.expression(String::class, alias1),
114+
Expressions.intLiteral(1),
115+
)
116+
117+
assertThat(actual).isEqualTo(expected)
118+
}
119+
120+
@Test
121+
fun `right() with two expressions`() {
122+
// when
123+
val expression = queryPart {
124+
right(expression(String::class, alias1), expression(Int::class, "alias2"))
125+
}.toExpression()
126+
127+
val actual: Expression<String> = expression // for type check
128+
129+
// then
130+
val expected = Expressions.right(
131+
Expressions.expression(String::class, alias1),
132+
Expressions.expression(Int::class, "alias2"),
133+
)
134+
135+
assertThat(actual).isEqualTo(expected)
136+
}
137+
138+
@Test
139+
fun `right() literal with two expressions`() {
140+
// when
141+
val expression = queryPart {
142+
right(expression(String::class, alias1), 1)
143+
}.toExpression()
144+
145+
val actual: Expression<String> = expression // for type check
146+
147+
// then
148+
val expected = Expressions.right(
149+
Expressions.expression(String::class, alias1),
150+
Expressions.intLiteral(1),
151+
)
152+
153+
assertThat(actual).isEqualTo(expected)
154+
}
155+
156+
@Test
157+
fun `replace() with three expressions`() {
158+
// when
159+
val expression = queryPart {
160+
replace(
161+
expression(String::class, alias1),
162+
expression(String::class, "alias2"),
163+
expression(String::class, "alias3"),
164+
)
165+
}.toExpression()
166+
167+
val actual: Expression<String> = expression // for type check
168+
169+
// then
170+
val expected = Expressions.replace(
171+
Expressions.expression(String::class, alias1),
172+
Expressions.expression(String::class, "alias2"),
173+
Expressions.expression(String::class, "alias3"),
174+
)
175+
176+
assertThat(actual).isEqualTo(expected)
177+
}
178+
179+
@Test
180+
fun `replace() literal with three expressions`() {
181+
// when
182+
val expression = queryPart {
183+
replace(
184+
expression(String::class, alias1),
185+
"string1",
186+
"string2",
187+
)
188+
}.toExpression()
189+
190+
val actual: Expression<String> = expression // for type check
191+
192+
// then
193+
val expected = Expressions.replace(
194+
Expressions.expression(String::class, alias1),
195+
Expressions.stringLiteral("string1"),
196+
Expressions.stringLiteral("string2"),
197+
)
198+
199+
assertThat(actual).isEqualTo(expected)
200+
}
47201
}

‎query-model/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/querymodel/jpql/expression/Expressions.kt

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlAliasedExpres
77
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlAvg
88
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlCaseValue
99
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlCaseWhen
10+
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlCast
1011
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlCeiling
1112
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlCoalesce
1213
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlConcat
@@ -22,6 +23,7 @@ import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlExpression
2223
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlExpressionParentheses
2324
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlFloor
2425
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlFunctionExpression
26+
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlLeft
2527
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlLength
2628
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlLiteral
2729
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlLn
@@ -41,6 +43,8 @@ import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlParam
4143
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlPathType
4244
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlPlus
4345
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlPower
46+
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlReplace
47+
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlRight
4448
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlRound
4549
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlSign
4650
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl.JpqlSize
@@ -723,6 +727,42 @@ object Expressions {
723727
return JpqlLocate(substring, string, start)
724728
}
725729

730+
/**
731+
* Creates an expression that represents the casting of a value to a different type.
732+
*/
733+
@SinceJdsl("3.6.0")
734+
fun <T : Any> cast(value: Expression<*>, type: KClass<T>): Expression<T> {
735+
return JpqlCast(value, type)
736+
}
737+
738+
/**
739+
* Creates an expression that returns the leftmost count characters from a string.
740+
*/
741+
@SinceJdsl("3.6.0")
742+
fun left(value: Expression<String>, count: Expression<Int>): Expression<String> {
743+
return JpqlLeft(value, count)
744+
}
745+
746+
/**
747+
* Creates an expression that returns the rightmost count characters from a string.
748+
*/
749+
@SinceJdsl("3.6.0")
750+
fun right(value: Expression<String>, count: Expression<Int>): Expression<String> {
751+
return JpqlRight(value, count)
752+
}
753+
754+
/**
755+
* Creates an expression that replaces all occurrences of a search string with a replacement string.
756+
*/
757+
@SinceJdsl("3.6.0")
758+
fun replace(
759+
value: Expression<String>,
760+
search: Expression<String>,
761+
replacement: Expression<String>,
762+
): Expression<String> {
763+
return JpqlReplace(value, search, replacement)
764+
}
765+
726766
/**
727767
* Creates an expression that represents predefined database functions and user-defined database functions.
728768
*/

‎query-model/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/querymodel/jpql/expression/impl/JpqlCast.kt

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
package com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl
2+
3+
import com.linecorp.kotlinjdsl.SinceJdsl
4+
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.Expression
5+
import kotlin.reflect.KClass
6+
7+
@SinceJdsl("3.6.0")
8+
data class JpqlCast<T : Any> internal constructor(
9+
val value: Expression<*>,
10+
val type: KClass<T>,
11+
) : Expression<T>

‎query-model/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/querymodel/jpql/expression/impl/JpqlLeft.kt

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
package com.linecorp.kotlinjdsl.querymodel.jpql.expression.impl
2+
3+
import com.linecorp.kotlinjdsl.SinceJdsl
4+
import com.linecorp.kotlinjdsl.querymodel.jpql.expression.Expression
5+
6+
@SinceJdsl("3.6.0")
7+
data class JpqlLeft internal constructor(
8+
val value: Expression<String>,
9+
val length: Expression<Int>,
10+
) : Expression<String>

0 commit comments

Comments
 (0)