Add simple service with a GET and a POST request

Author: Xennis

.gitignore

@@ -3,7 +3,7 @@
 ############
 
 .gradle
-/build/
+build/
 
 # Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
 !gradle-wrapper.jar

README.md

@@ -0,0 +1,4 @@
+# Kotlin Microservices Spring Boot Example
+
+Services
+* [bankofhamburg-customer-service](bankofhamburg-customer-service) Example service with a GET and POST endpoint

bankofhamburg-customer-service/README.md

@@ -0,0 +1,18 @@
+# Bank of Hamburg Customer Service
+
+Run service
+```
+../gradlew bootRun
+```
+
+### Exemplary usage
+
+`helloWorld` endpoint: GET request
+```
+curl -v http://localhost:8080/helloWorld?type=fuu
+```
+
+`customer` endpoint: POST request
+```
+curl -v -F firstName=Jana -F lastName=Müller http://localhost:8080/customer
+```

bankofhamburg-customer-service/build.gradle.kts

@@ -0,0 +1,8 @@
+val jar by tasks.getting(Jar::class) {
+    baseName = "bankofhamburg-customer-service"
+    version = "0.1.0"
+}
+
+application {
+    mainClassName = "org.example.bankofhamburg.customer.ApplicationKt" // Required for Gradle Kotlin DSL
+}

bankofhamburg-customer-service/src/main/kotlin/org/example/bankofhamburg/customer/Application.kt

@@ -0,0 +1,12 @@
+package org.example.bankofhamburg.customer
+
+import org.springframework.boot.SpringApplication
+import org.springframework.boot.autoconfigure.SpringBootApplication
+
+
+@SpringBootApplication
+class Application
+
+fun main(args: Array<String>) {
+    SpringApplication.run(Application::class.java, *args)
+}

bankofhamburg-customer-service/src/main/kotlin/org/example/bankofhamburg/customer/CustomerController.kt

@@ -0,0 +1,19 @@
+package org.example.bankofhamburg.customer
+
+import org.springframework.http.HttpStatus
+import org.springframework.http.MediaType
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestParam
+import org.springframework.web.bind.annotation.RestController
+
+
+@RestController
+class CustomerController {
+
+    @PostMapping("/customer", consumes = [MediaType.MULTIPART_FORM_DATA_VALUE])
+    fun customer(@RequestParam("firstName") firstName: String, @RequestParam("lastName") lastName: String): ResponseEntity<String> {
+        println("Hello $firstName $lastName")
+        return ResponseEntity(HttpStatus.CREATED)
+    }
+}

bankofhamburg-customer-service/src/main/kotlin/org/example/bankofhamburg/customer/HelloWorldController.kt

@@ -0,0 +1,17 @@
+package org.example.bankofhamburg.customer
+
+import org.springframework.http.HttpStatus
+import org.springframework.http.ResponseEntity
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.RequestParam
+import org.springframework.web.bind.annotation.RestController
+
+
+@RestController
+class HelloWorldController {
+
+    @GetMapping("/helloWorld")
+    fun helloWorld(@RequestParam(value = "type", defaultValue = "pong") type: String): ResponseEntity<String> {
+        return ResponseEntity("Type is $type", HttpStatus.OK)
+    }
+}

bankofhamburg-customer-service/src/test/kotlin/org/example/bankofhamburg/customer/CustomerControllerTest.kt

@@ -0,0 +1,43 @@
+package org.example.bankofhamburg.customer
+
+import org.assertj.core.api.Assertions.assertThat
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.boot.test.context.SpringBootTest.WebEnvironment
+import org.springframework.test.context.junit4.SpringRunner
+import org.springframework.boot.test.web.client.TestRestTemplate
+import org.springframework.util.LinkedMultiValueMap
+import org.springframework.http.HttpEntity
+import org.springframework.http.HttpHeaders
+import org.springframework.http.HttpStatus
+import org.springframework.http.MediaType
+
+
+@RunWith(SpringRunner::class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+class CustomerControllerTest {
+
+    @Autowired
+    lateinit var restTemplate: TestRestTemplate
+
+    @Test
+    fun customerTest() {
+        val requestEntity = createEntity("Jana", "Müller")
+        val responseEntity = this.restTemplate.postForEntity("/customer", requestEntity, String::class.java)
+        assertThat(responseEntity.statusCodeValue).isEqualTo(HttpStatus.CREATED.value())
+    }
+
+    private fun createEntity(firstName: String, lastName: String): HttpEntity<LinkedMultiValueMap<String, String>> {
+        val body = LinkedMultiValueMap<String, String>()
+        body.add("firstName", firstName)
+        body.add("lastName", lastName)
+
+        val headers = HttpHeaders()
+        headers.contentType = MediaType.MULTIPART_FORM_DATA
+        return HttpEntity(body, headers)
+    }
+}

bankofhamburg-customer-service/src/test/kotlin/org/example/bankofhamburg/customer/HelloWorldControllerTest.kt

@@ -0,0 +1,30 @@
+package org.example.bankofhamburg.customer
+
+import org.assertj.core.api.Assertions.assertThat
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.boot.test.context.SpringBootTest.WebEnvironment
+import org.springframework.test.context.junit4.SpringRunner
+import org.springframework.boot.test.web.client.TestRestTemplate
+import org.springframework.http.HttpStatus
+
+
+@RunWith(SpringRunner::class)
+@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)
+class HelloWorldControllerTest {
+
+    @Autowired
+    lateinit var restTemplate: TestRestTemplate
+
+    @Test
+    fun helloWorldTest() {
+        val responseEntity = this.restTemplate.getForEntity("/helloWorld?type=fuu", String::class.java)
+        assertThat(responseEntity.statusCodeValue).isEqualTo(HttpStatus.OK.value())
+        assertThat(responseEntity.body).isEqualTo("Type is fuu")
+    }
+
+}

build.gradle.kts

@@ -0,0 +1,31 @@
+plugins {
+    val kotlinVersion = "1.2.41"
+
+    application // Required for Gradle Kotlin DSL
+
+    // Plugins used by submodules only
+    kotlin("jvm") version kotlinVersion apply false
+    kotlin("plugin.spring") version kotlinVersion apply false
+    id("org.springframework.boot") version "1.5.4.RELEASE" apply false
+}
+
+// Configure Kotlin and Spring Boot for all Projects
+subprojects {
+
+    apply {
+        plugin("application") // Required for Gradle Kotlin DSL
+        plugin("kotlin")
+        plugin("kotlin-spring")
+        plugin("org.springframework.boot")
+    }
+
+    repositories {
+        jcenter()
+    }
+
+    dependencies {
+        compile(kotlin("stdlib"))
+        compile("org.springframework.boot:spring-boot-starter-web")
+        testCompile("org.springframework.boot:spring-boot-starter-test")
+    }
+}

settings.gradle.kts

@@ -1 +1,4 @@
 rootProject.name = "bankofhamburg-services"
+
+include(
+        "bankofhamburg-customer-service")