Feature/storm 27 (#28)

* Add Kotlin extension functions.
Relates to #27

Author: zantvoort

README.adoc

@@ -45,15 +45,15 @@ Maven::
 <dependency>
     <groupId>st.orm</groupId>
     <artifactId>storm</artifactId>
-    <version>1.3.5</version>
+    <version>1.3.6</version>
     <scope>compile</scope>
 </dependency>
 ----
 Gradle::
 +
 [source,groovy]
 ----
-implementation 'st.orm:storm:1.3.5'
+implementation 'st.orm:storm:1.3.6'
 ----
 ====
 
@@ -846,15 +846,15 @@ Maven::
 <dependency>
     <groupId>st.orm</groupId>
     <artifactId>storm-oracle</artifactId>
-    <version>1.3.5</version>
+    <version>1.3.6</version>
     <scope>runtime</scope>
 </dependency>
 ----
 Gradle::
 +
 [source,groovy]
 ----
-runtimeOnly 'st.orm:storm-oracle:1.3.5'
+runtimeOnly 'st.orm:storm-oracle:1.3.6'
 ----
 ====
 
@@ -876,15 +876,15 @@ Maven::
 <dependency>
     <groupId>st.orm</groupId>
     <artifactId>storm-metamodel-processor</artifactId>
-    <version>1.3.5</version>
+    <version>1.3.6</version>
     <scope>provided</scope>
 </dependency>
 ----
 Gradle::
 +
 [source,groovy]
 ----
-annotationProcessor 'st.orm:storm-metamodel-processor:1.3.5'
+annotationProcessor 'st.orm:storm-metamodel-processor:1.3.6'
 ----
 ====
 
@@ -952,15 +952,15 @@ Maven::
 <dependency>
     <groupId>st.orm</groupId>
     <artifactId>storm-json</artifactId>
-    <version>1.3.5</version>
+    <version>1.3.6</version>
     <scope>compile</scope>
 </dependency>
 ----
 Gradle::
 +
 [source,groovy]
 ----
-implementation 'st.orm:storm-json:1.3.5'
+implementation 'st.orm:storm-json:1.3.6'
 ----
 ====
 
@@ -1096,15 +1096,15 @@ Maven::
 <dependency>
     <groupId>st.orm</groupId>
     <artifactId>storm-spring</artifactId>
-    <version>1.3.5</version>
+    <version>1.3.6</version>
     <scope>compile</scope>
 </dependency>
 ----
 Gradle::
 +
 [source,groovy]
 ----
-implementation 'st.orm:storm-spring:1.3.5'
+implementation 'st.orm:storm-spring:1.3.6'
 ----
 ====
 

pom.xml

@@ -12,7 +12,7 @@
     </properties>
     <groupId>st.orm</groupId>
     <artifactId>storm-framework</artifactId>
-    <version>1.3.5</version>
+    <version>1.3.6</version>
     <packaging>pom</packaging>
     <name>Storm Framework</name>
     <description>A SQL Template and ORM framework, focusing on modernizing and simplifying database programming.</description>

storm-json/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>st.orm</groupId>
         <artifactId>storm-framework</artifactId>
-        <version>1.3.5</version>
+        <version>1.3.6</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
     <artifactId>storm-json</artifactId>

storm-kotlin/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>st.orm</groupId>
         <artifactId>storm-framework</artifactId>
-        <version>1.3.5</version>
+        <version>1.3.6</version>
         <relativePath>../pom.xml</relativePath>
     </parent>
     <artifactId>storm-kotlin</artifactId>

storm-kotlin/src/main/kotlin/st/orm/kotlin/repository/KRepositoryLookupExtensions.kt

@@ -0,0 +1,51 @@
+package st.orm.kotlin.repository
+
+import st.orm.repository.Entity
+import st.orm.repository.Projection
+
+/**
+ * Extensions for [KRepositoryLookup] to provide convenient access to entity repositories.
+ */
+inline fun <reified T, ID> KRepositoryLookup.typedEntity(): KEntityRepository<T, ID>
+        where T : Record, T : Entity<ID> {
+    return entity(T::class.java)
+}
+
+/**
+ * Extensions for [KRepositoryLookup] to provide convenient access to entity repositories.
+ */
+inline fun <reified T> KRepositoryLookup.entity(): KEntityRepository<T, *>
+        where T : Record, T : Entity<*> {
+    // Use reflection to prevent the need for the ID parameter. The compiler takes care of the type-safety but is
+    // unable to infer the type of the ID parameter at compile time.
+    val method = this::class.java.getMethod("entity", Class::class.java)
+    @Suppress("UNCHECKED_CAST")
+    return method.invoke(this, T::class.java) as KEntityRepository<T, *>
+}
+
+/**
+ * Extensions for [KRepositoryLookup] to provide convenient access to projection repositories.
+ */
+inline fun <reified T, ID> KRepositoryLookup.typedProjection(): KProjectionRepository<T, ID>
+        where T : Record, T : Projection<ID> {
+    return projection(T::class.java)
+}
+
+/**
+ * Extensions for [KRepositoryLookup] to provide convenient access to projection repositories.
+ */
+inline fun <reified T> KRepositoryLookup.projection(): KProjectionRepository<T, *>
+        where T : Record, T : Projection<*> {
+    // Use reflection to prevent the need for the ID parameter. The compiler takes care of the type-safety but is
+    // unable to infer the type of the ID parameter at compile time.
+    val method = this::class.java.getMethod("projection", Class::class.java)
+    @Suppress("UNCHECKED_CAST")
+    return method.invoke(this, T::class.java) as KProjectionRepository<T, *>
+}
+
+/**
+ * Extensions for [KRepositoryLookup] to provide convenient access to repositories.
+ */
+inline fun <reified R : KRepository> KRepositoryLookup.repository(): R {
+    return repository(R::class)
+}

storm-kotlin/src/main/kotlin/st/orm/kotlin/repository/RepositoryLookupExtensions.kt

@@ -0,0 +1,55 @@
+package st.orm.kotlin.repository
+
+import st.orm.repository.Entity
+import st.orm.repository.EntityRepository
+import st.orm.repository.Projection
+import st.orm.repository.ProjectionRepository
+import st.orm.repository.Repository
+import st.orm.repository.RepositoryLookup
+
+/**
+ * Extensions for [RepositoryLookup] to provide convenient access to entity repositories.
+ */
+inline fun <reified T, ID> RepositoryLookup.typedEntity(): EntityRepository<T, ID>
+        where T : Record, T : Entity<ID> {
+    return entity(T::class.java)
+}
+
+/**
+ * Extensions for [RepositoryLookup] to provide convenient access to entity repositories.
+ */
+inline fun <reified T> RepositoryLookup.entity(): EntityRepository<T, *>
+        where T : Record, T : Entity<*> {
+    // Use reflection to prevent the need for the ID parameter. The compiler takes care of the type-safety but is
+    // unable to infer the type of the ID parameter at compile time.
+    val method = this::class.java.getMethod("entity", Class::class.java)
+    @Suppress("UNCHECKED_CAST")
+    return method.invoke(this, T::class.java) as EntityRepository<T, *>
+}
+
+/**
+ * Extensions for [RepositoryLookup] to provide convenient access to projection repositories.
+ */
+inline fun <reified T, ID> RepositoryLookup.typedProjection(): ProjectionRepository<T, ID>
+        where T : Record, T : Projection<ID> {
+    return projection(T::class.java)
+}
+
+/**
+ * Extensions for [RepositoryLookup] to provide convenient access to projection repositories.
+ */
+inline fun <reified T> RepositoryLookup.projection(): ProjectionRepository<T, *>
+            where T : Record, T : Projection<*> {
+    // Use reflection to prevent the need for the ID parameter. The compiler takes care of the type-safety but is
+    // unable to infer the type of the ID parameter at compile time.
+    val method = this::class.java.getMethod("entity", Class::class.java)
+    @Suppress("UNCHECKED_CAST")
+    return method.invoke(this, T::class.java) as ProjectionRepository<T, *>
+}
+
+/**
+ * Extensions for [RepositoryLookup] to provide convenient access to repositories.
+ */
+inline fun <reified R : Repository> RepositoryLookup.repository(): R {
+    return repository(R::class.java)
+}

storm-kotlin/src/main/kotlin/st/orm/kotlin/template/ConnectionExtensions.kt

@@ -0,0 +1,11 @@
+package st.orm.kotlin.template
+
+import st.orm.kotlin.KTemplates
+import st.orm.kotlin.template.KORMTemplate
+import java.sql.Connection
+
+/**
+ * Extension property to convert a [Connection] to a [KORMTemplate].
+ */
+val Connection.orm: KORMTemplate
+    get() = KTemplates.ORM(this)

storm-kotlin/src/main/kotlin/st/orm/kotlin/template/DataSourceExtensions.kt

@@ -0,0 +1,11 @@
+package st.orm.kotlin.template
+
+import st.orm.kotlin.KTemplates
+import st.orm.kotlin.template.KORMTemplate
+import javax.sql.DataSource
+
+/**
+ * Extension property to convert a [DataSource] to a [KORMTemplate].
+ */
+val DataSource.orm: KORMTemplate
+    get() = KTemplates.ORM(this)

storm-kotlin/src/main/kotlin/st/orm/kotlin/template/EntityManagerExtensions.kt

@@ -0,0 +1,11 @@
+package st.orm.kotlin.template
+
+import jakarta.persistence.EntityManager
+import st.orm.kotlin.KTemplates
+import st.orm.kotlin.template.KORMTemplate
+
+/**
+ * Extension property to convert an [EntityManager] to a [KORMTemplate].
+ */
+val EntityManager.orm: KORMTemplate
+    get() = KTemplates.ORM(this)

storm-kotlin/src/main/kotlin/st/orm/kotlin/template/JpaTemplateExtensions.kt

@@ -0,0 +1,10 @@
+package st.orm.kotlin.template
+
+import st.orm.kotlin.template.KORMTemplate
+import st.orm.template.JpaTemplate
+
+/**
+ * Extension property to convert a [JpaTemplate] to a [KORMTemplate].
+ */
+val JpaTemplate.orm: KORMTemplate
+    get() = KORMTemplate.from(this.toORM())