Support Springdoc (#5)

- added two endpoints + springdoc dependencies

Author: nulls

backend/build.gradle.kts

@@ -12,6 +12,8 @@ kotlin {
             dependencies {
 //                implementation("org.springframework.boot:spring-boot-starter-data-jpa")
                 implementation("org.springframework.boot:spring-boot-starter-webflux")
+                implementation("io.projectreactor.kotlin:reactor-kotlin-extensions")
+                implementation("org.jetbrains.kotlinx:kotlinx-serialization-json")
             }
         }
     }

backend/src/jvmMain/kotlin/com/saveourtool/template/backend/BackendController.kt

@@ -0,0 +1,34 @@
+package com.saveourtool.template.backend.controller
+
+import com.saveourtool.template.backend.model.Request
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+import reactor.core.publisher.Flux
+import reactor.core.publisher.Mono
+import reactor.kotlin.core.publisher.toFlux
+
+/**
+ * @since 2024-02-26
+ */
+@RestController
+@RequestMapping("/requests")
+class BackendController {
+    private val requests = mutableListOf<Request>()
+
+    /**
+     * @param request a new [Request]
+     */
+    @PostMapping("/new")
+    fun newEntity(
+        @RequestBody request: Mono<Request>,
+    ): Mono<Unit> = request.map { requests.add(it) }
+
+    /**
+     * @return all [Request]s
+     */
+    @GetMapping("/all")
+    fun getAllEntities(): Flux<Request> = requests.toFlux()
+}

backend/src/jvmMain/kotlin/com/saveourtool/template/backend/controller/BackendController.kt

@@ -0,0 +1,13 @@
+package com.saveourtool.template.backend.model
+
+import kotlinx.serialization.Serializable
+
+/**
+ * @since 2024-03-11
+ */
+@Serializable
+data class Request(
+    val id: Long,
+    val name: String,
+    val operation: String,
+)

backend/src/jvmMain/kotlin/com/saveourtool/template/backend/model/Artifact.kt

@@ -3,12 +3,16 @@ java = "21"
 kotlin = "1.9.22"
 spring-boot = "3.2.2"
 spring-dependency-management-plugin = "1.1.4"
+springdoc = "2.3.0"
 
 [plugins]
 
 [libraries]
 kotlin-spring-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-allopen", version.ref = "kotlin" }
 kotlin-jpa-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-noarg", version.ref = "kotlin" }
 kotlin-multiplatform-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", version.ref = "kotlin" }
+kotlin-serialization-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-serialization", version.ref = "kotlin" }
 spring-boot-gradle-plugin = { module = "org.springframework.boot:spring-boot-gradle-plugin", version.ref = "spring-boot" }
 spring-dependency-management-gradle-plugin = { module = "io.spring.gradle:dependency-management-plugin", version.ref = "spring-dependency-management-plugin" }
+springdoc-openapi-starter-common = { module = "org.springdoc:springdoc-openapi-starter-common", version.ref = "springdoc" }
+springdoc-openapi-starter-webflux-ui = { module = "org.springdoc:springdoc-openapi-starter-webflux-ui", version.ref = "springdoc" }

backend/src/jvmMain/kotlin/com/saveourtool/template/backend/model/Request.kt

@@ -11,6 +11,7 @@ dependencies {
     // workaround https://github.com/gradle/gradle/issues/15383
     implementation(files(project.libs.javaClass.superclass.protectionDomain.codeSource.location))
     implementation(libs.kotlin.multiplatform.gradle.plugin)
+    implementation(libs.kotlin.serialization.gradle.plugin)
     implementation(libs.kotlin.spring.gradle.plugin)
     implementation(libs.kotlin.jpa.gradle.plugin)
     implementation(libs.spring.boot.gradle.plugin)

backend/src/jvmMain/kotlin/com/saveourtool/template/backend/model/UpstreamRegistry.kt

@@ -9,6 +9,7 @@ plugins {
     kotlin("multiplatform")
     kotlin("plugin.spring")
     kotlin("plugin.jpa")
+    kotlin("plugin.serialization")
     id("org.springframework.boot")
     id("io.spring.dependency-management")
 }
@@ -25,6 +26,15 @@ kotlin {
     jvmToolchain {
         this.languageVersion.set(JavaLanguageVersion.of(javaVersion.majorVersion))
     }
+
+    sourceSets {
+        jvmMain {
+            dependencies {
+                implementation(libs.springdoc.openapi.starter.common)
+                implementation(libs.springdoc.openapi.starter.webflux.ui)
+            }
+        }
+    }
 }
 
 tasks.withType<KotlinCompile> {