feat : client example 추가

Author: kshired

api-server/src/main/kotlin/com/kshired/boilerplate/apiserver/controller/example/ExampleController.kt

@@ -0,0 +1,20 @@
+package com.kshired.boilerplate.apiserver.controller.example
+
+import com.kshired.boilerplate.apiserver.controller.example.response.CatFactResponse
+import com.kshired.boilerplate.clients.client.example.ExampleClient
+import com.kshired.boilerplate.common.util.response.ApiResponse
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+@RequestMapping("/api/v1/example")
+class ExampleController(
+    // (예시용) 보통 client를 controller에서 직접 사용하지는 않습니다. service 혹은 구현 계층에서 사용하는게 일반적입니다.
+    private val exampleClient: ExampleClient
+) {
+    @GetMapping("/cat/fact")
+    fun getCatFact(): ApiResponse<CatFactResponse> {
+        return ApiResponse.success(CatFactResponse(exampleClient.getCatFacts()))
+    }
+}

api-server/src/main/kotlin/com/kshired/boilerplate/apiserver/controller/example/response/CatFactResponse.kt

@@ -0,0 +1,5 @@
+package com.kshired.boilerplate.apiserver.controller.example.response
+
+data class CatFactResponse(
+    val fact: String
+)

clients/client-example/src/main/kotlin/com/kshired/boilerplate/clients/client/example/ExampleApi.kt

@@ -0,0 +1,11 @@
+package com.kshired.boilerplate.clients.client.example
+
+import com.kshired.boilerplate.clients.client.example.response.ExampleResponse
+import org.springframework.cloud.openfeign.FeignClient
+import org.springframework.web.bind.annotation.GetMapping
+
+@FeignClient(name = "example", url = "https://catfact.ninja")
+interface ExampleApi {
+    @GetMapping("/fact")
+    fun getFact(): ExampleResponse
+}

clients/client-example/src/main/kotlin/com/kshired/boilerplate/clients/client/example/ExampleClient.kt

@@ -0,0 +1,12 @@
+package com.kshired.boilerplate.clients.client.example
+
+import org.springframework.stereotype.Component
+
+@Component
+class ExampleClient(
+    private val exampleApi: ExampleApi
+) {
+    fun getCatFacts(): String {
+        return exampleApi.getFact().fact
+    }
+}

clients/client-example/src/main/kotlin/com/kshired/boilerplate/clients/client/example/response/ExampleResponse.kt

@@ -0,0 +1,6 @@
+package com.kshired.boilerplate.clients.client.example.response
+
+data class ExampleResponse(
+    val fact: String,
+    val length: Int
+)