feat(render): add introspect method for KCallable

render/jpql/src/main/kotlin/com/linecorp/kotlinjdsl/render/jpql/introspector/JpqlRenderIntrospector.kt

@@ -4,6 +4,7 @@ import com.linecorp.kotlinjdsl.SinceJdsl
 import com.linecorp.kotlinjdsl.render.AbstractRenderContextElement
 import com.linecorp.kotlinjdsl.render.RenderContext
 import java.util.concurrent.ConcurrentHashMap
+import kotlin.reflect.KCallable
 import kotlin.reflect.KClass
 
 /**
@@ -15,7 +16,8 @@ class JpqlRenderIntrospector(
 ) : AbstractRenderContextElement(Key) {
     companion object Key : RenderContext.Key<JpqlRenderIntrospector>
 
-    private val tableLookupCache: MutableMap<KClass<*>, JpqlEntityDescription> = ConcurrentHashMap()
+    private val classTableLookupCache: MutableMap<KClass<*>, JpqlEntityDescription> = ConcurrentHashMap()
+    private val propertyTableLookupCache: MutableMap<KCallable<*>, JpqlPropertyDescription> = ConcurrentHashMap()
 
     /**
      * Creates a new introspector by combining this introspector and the introspector.
@@ -38,8 +40,22 @@ class JpqlRenderIntrospector(
         return getCachedDescription(clazz)
     }
 
+    /**
+     * Introspects the KCallable to get the property information.
+     */
+    @SinceJdsl("3.1.0")
+    fun introspect(property: KCallable<*>): JpqlPropertyDescription {
+        return getCachedDescription(property)
+    }
+
     private fun getCachedDescription(clazz: KClass<*>): JpqlEntityDescription {
-        return tableLookupCache.computeIfAbsent(clazz) {
+        return classTableLookupCache.computeIfAbsent(clazz) {
+            getDescription(it)
+        }
+    }
+
+    private fun getCachedDescription(property: KCallable<*>): JpqlPropertyDescription {
+        return propertyTableLookupCache.computeIfAbsent(property) {
             getDescription(it)
         }
     }
@@ -48,4 +64,9 @@ class JpqlRenderIntrospector(
         return introspector.introspect(clazz)
             ?: throw IllegalStateException("There is no description for ${clazz.java.name}")
     }
+
+    private fun getDescription(property: KCallable<*>): JpqlPropertyDescription {
+        return introspector.introspect(property)
+            ?: throw IllegalStateException("There is no description for ${property.name}")
+    }
 }

render/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/JpqlEntitySerializerTest.kt

@@ -18,6 +18,7 @@ import io.mockk.verifySequence
 import org.assertj.core.api.WithAssertions
 import org.junit.jupiter.api.Test
 import org.junit.jupiter.params.ParameterizedTest
+import kotlin.reflect.KClass
 
 @JpqlSerializerTest
 internal class JpqlEntitySerializerTest : WithAssertions {
@@ -57,7 +58,7 @@ internal class JpqlEntitySerializerTest : WithAssertions {
         clause: JpqlRenderClause,
     ) {
         // given
-        every { introspector.introspect(any()) } returns entityDescription1
+        every { introspector.introspect(any<KClass<*>>()) } returns entityDescription1
 
         val part = Entities.entity(Book::class, alias1)
         val context = TestRenderContext(introspector, statement, clause)

render/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/JpqlEntityTreatSerializerTest.kt

@@ -19,6 +19,7 @@ import io.mockk.verifySequence
 import org.assertj.core.api.WithAssertions
 import org.junit.jupiter.api.Test
 import org.junit.jupiter.params.ParameterizedTest
+import kotlin.reflect.KClass
 
 @JpqlSerializerTest
 class JpqlEntityTreatSerializerTest : WithAssertions {
@@ -58,7 +59,7 @@ class JpqlEntityTreatSerializerTest : WithAssertions {
         clause: JpqlRenderClause,
     ) {
         // given
-        every { introspector.introspect(any()) } returns entityDescription1
+        every { introspector.introspect(any<KClass<*>>()) } returns entityDescription1
 
         val part = Entities.treat(
             entity1,
@@ -93,7 +94,7 @@ class JpqlEntityTreatSerializerTest : WithAssertions {
         clause: JpqlRenderClause,
     ) {
         // given
-        every { introspector.introspect(any()) } returns entityDescription1
+        every { introspector.introspect(any<KClass<*>>()) } returns entityDescription1
 
         val part = Entities.treat(
             entity1,

render/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/JpqlPathTreatSerializerTest.kt

@@ -15,6 +15,7 @@ import io.mockk.impl.annotations.MockK
 import io.mockk.verifySequence
 import org.assertj.core.api.WithAssertions
 import org.junit.jupiter.api.Test
+import kotlin.reflect.KClass
 
 @JpqlSerializerTest
 class JpqlPathTreatSerializerTest : WithAssertions {
@@ -47,7 +48,7 @@ class JpqlPathTreatSerializerTest : WithAssertions {
     @Test
     fun serialize() {
         // given
-        every { introspector.introspect(any()) } returns entityDescription1
+        every { introspector.introspect(any<KClass<*>>()) } returns entityDescription1
 
         val part = Paths.treat(
             path1,

render/jpql/src/test/kotlin/com/linecorp/kotlinjdsl/render/jpql/serializer/impl/JpqlValueSerializerTest.kt

@@ -13,6 +13,7 @@ import io.mockk.impl.annotations.MockK
 import io.mockk.verifySequence
 import org.assertj.core.api.WithAssertions
 import org.junit.jupiter.api.Test
+import kotlin.reflect.KClass
 
 @JpqlSerializerTest
 class JpqlValueSerializerTest : WithAssertions {
@@ -59,7 +60,7 @@ class JpqlValueSerializerTest : WithAssertions {
     @Test
     fun `serialize() draws entity name, when value is KClass`() {
         // given
-        every { introspector.introspect(any()) } returns entityDescription1
+        every { introspector.introspect(any<KClass<*>>()) } returns entityDescription1
 
         val part = Expressions.value(
             Book::class,