feat(): added simple kotlin example for Synapse integration

service/service-samples/sample-service-kotlin/pom.xml

@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>synapse</artifactId>
+        <groupId>io.americanexpress.synapse</groupId>
+        <version>0.3.8-SNAPSHOT</version>
+        <relativePath>../../../pom.xml</relativePath>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>sample-service-kotlin</artifactId>
+
+    <properties>
+        <maven.compiler.source>19</maven.compiler.source>
+        <maven.compiler.target>19</maven.compiler.target>
+        <kotlin.version>1.6.10</kotlin.version>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <!--Dependencies-->
+    <dependencies>
+        <!--Synapse-->
+        <dependency>
+            <groupId>io.americanexpress.synapse</groupId>
+            <artifactId>synapse-service-rest</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.jetbrains.kotlin</groupId>
+            <artifactId>kotlin-reflect</artifactId>
+            <version>${kotlin.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.jetbrains.kotlin</groupId>
+            <artifactId>kotlin-stdlib-jdk8</artifactId>
+            <version>${kotlin.version}</version>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <!-- Kotlin Maven Plugin -->
+            <plugin>
+                <groupId>org.jetbrains.kotlin</groupId>
+                <artifactId>kotlin-maven-plugin</artifactId>
+                <version>${kotlin.version}</version>
+                <executions>
+                    <execution>
+                        <id>compile</id>
+                        <goals>
+                            <goal>compile</goal>
+                        </goals>
+                        <configuration>
+                            <jvmTarget>1.8</jvmTarget>
+                        </configuration>
+                    </execution>
+                    <execution>
+                        <id>test-compile</id>
+                        <goals>
+                            <goal>test-compile</goal>
+                        </goals>
+                        <configuration>
+                            <jvmTarget>1.8</jvmTarget>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <!-- Surefire Plugin -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-surefire-plugin</artifactId>
+                <configuration>
+                    <includes>
+                        <include>**/*Test.kt</include>
+                    </includes>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/Main.kt

@@ -0,0 +1,27 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest
+
+import org.springframework.boot.autoconfigure.SpringBootApplication
+import org.springframework.boot.runApplication
+
+/**
+ * Main
+ */
+@SpringBootApplication
+class Main {
+    fun main(args: Array<String>) {
+        runApplication<Main>(*args)
+    }
+}

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/config/BookConfig.kt

@@ -0,0 +1,29 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.config
+
+import io.americanexpress.synapse.service.rest.config.ServiceRestConfig
+import org.springframework.context.annotation.ComponentScan
+import org.springframework.context.annotation.Configuration
+import org.springframework.context.annotation.Import
+
+@Configuration
+@ComponentScan(basePackages = ["io.americanexpress.synapse.rest"])
+@Import(ServiceRestConfig::class)
+class BookConfig {
+
+    companion object {
+        const val BOOK_ENDPOINT = "/v1/books"
+    }
+}

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/controller/CreateBookController.kt

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.controller
+
+import io.americanexpress.synapse.rest.config.BookConfig
+import io.americanexpress.synapse.rest.model.BookRequest
+import io.americanexpress.synapse.rest.model.BookResponse
+import io.americanexpress.synapse.rest.service.CreateBookService
+import io.americanexpress.synapse.service.rest.controller.BaseCreateController
+import org.springframework.stereotype.Controller
+import org.springframework.web.bind.annotation.RequestMapping
+
+@Controller
+@RequestMapping(BookConfig.BOOK_ENDPOINT)
+class CreateBookController : BaseCreateController<BookRequest, BookResponse, CreateBookService>()

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/controller/DeleteBookController.kt

@@ -0,0 +1,24 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.controller
+
+import io.americanexpress.synapse.rest.config.BookConfig.Companion.BOOK_ENDPOINT
+import io.americanexpress.synapse.rest.service.DeleteBookService
+import io.americanexpress.synapse.service.rest.controller.BaseDeleteController
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+@RequestMapping(BOOK_ENDPOINT)
+class DeleteBookController : BaseDeleteController<DeleteBookService>()

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/controller/GetBookController.kt

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.controller
+
+import io.americanexpress.synapse.rest.config.BookConfig.Companion.BOOK_ENDPOINT
+import io.americanexpress.synapse.rest.model.BookResponse
+import io.americanexpress.synapse.rest.service.GetBookService
+import io.americanexpress.synapse.service.rest.controller.BaseGetMonoController
+import org.springframework.stereotype.Controller
+import org.springframework.web.bind.annotation.RequestMapping
+
+@Controller
+@RequestMapping(BOOK_ENDPOINT)
+class GetBookController : BaseGetMonoController<BookResponse, GetBookService>()

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/controller/ReadBookController.kt

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.controller
+
+import io.americanexpress.synapse.rest.config.BookConfig
+import io.americanexpress.synapse.rest.model.BookRequest
+import io.americanexpress.synapse.rest.model.BookResponse
+import io.americanexpress.synapse.rest.service.ReadBookService
+import io.americanexpress.synapse.service.rest.controller.BaseReadMonoController
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+@RequestMapping(BookConfig.BOOK_ENDPOINT)
+class ReadBookController : BaseReadMonoController<BookRequest, BookResponse, ReadBookService>()

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/controller/UpdateBookController.kt

@@ -0,0 +1,25 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.controller
+
+import io.americanexpress.synapse.rest.config.BookConfig
+import io.americanexpress.synapse.rest.model.BookRequest
+import io.americanexpress.synapse.rest.service.UpdateBookService
+import io.americanexpress.synapse.service.rest.controller.BaseUpdateController
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+@RequestMapping(BookConfig.BOOK_ENDPOINT)
+class UpdateBookController : BaseUpdateController<BookRequest, UpdateBookService>()

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/model/BookRequest.kt

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.model
+
+import io.americanexpress.synapse.service.rest.model.BaseServiceRequest
+
+class BookRequest(
+        val identifier: String,
+        val title: String,
+        val author: String,
+        ) : BaseServiceRequest

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/model/BookResponse.kt

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.model
+
+import io.americanexpress.synapse.service.rest.model.BaseServiceResponse
+
+class BookResponse(
+        val title: String,
+        val author: String
+        ) : BaseServiceResponse()

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/service/CreateBookService.kt

@@ -0,0 +1,30 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.service
+
+import io.americanexpress.synapse.rest.model.BookRequest
+import io.americanexpress.synapse.rest.model.BookResponse
+import io.americanexpress.synapse.service.rest.service.BaseCreateService
+import org.springframework.http.HttpHeaders
+import org.springframework.stereotype.Service
+import java.util.*
+
+@Service
+class CreateBookService : BaseCreateService<BookRequest, BookResponse>() {
+
+    override fun executeCreate(headers: HttpHeaders?, request: BookRequest?): BookResponse {
+        val actualRequest = request ?: BookRequest(UUID.randomUUID().toString(), "Synapse", "Gabriel")
+        return BookResponse(title = actualRequest.title, author = actualRequest.author)
+    }
+}

service/service-samples/sample-service-kotlin/src/main/kotlin/io/americanexpress/synapse/rest/service/DeleteBookService.kt

@@ -0,0 +1,26 @@
+/*
+ * Copyright 2020 American Express Travel Related Services Company, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+package io.americanexpress.synapse.rest.service
+
+import io.americanexpress.synapse.service.rest.service.BaseDeleteService
+import org.springframework.http.HttpHeaders
+import org.springframework.stereotype.Service
+
+@Service
+class DeleteBookService : BaseDeleteService() {
+
+    override fun executeDelete(headers: HttpHeaders?, id: String?) {
+        println("delete") //TODO: you would delete something here but for now print.
+    }
+}