https://github.com/softleader/feign-demo
A demo using spring-cloud-openfeign without Ribbon or Eureka
https://github.com/softleader/feign-demo
Last synced: 3 months ago
JSON representation
A demo using spring-cloud-openfeign without Ribbon or Eureka
- Host: GitHub
- URL: https://github.com/softleader/feign-demo
- Owner: softleader
- Created: 2019-03-15T07:47:35.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-03-18T06:05:52.000Z (about 6 years ago)
- Last Synced: 2025-01-18T04:26:29.228Z (5 months ago)
- Language: Makefile
- Size: 31.3 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# feign-demo
A demo using spring-cloud-openfeign without Ribbon or Eureka
## Required
- java 8
- gradle
- docker
- docker-compose
- make (optional, 沒有的話可打開 Makefile 直接執行對應的指令)
## Command
- `make` - build demo image to docker daemon
- `make up` - build image & docker-compose up
- `make down` - docker-compose down
## Api
```
GET /{app}
```
`app` 指定由哪個 app 來回覆當前時間, 一共有3個: `app1`, `app2`, `app3`
```sh
# 在 app1 回復當前時間
$ curl localhost:8080 -v
# 在 app3 回復當前時間
$ curl localhost:8080/app3 -v
```
### QueryString
- `ex=` - 固定丟出 exception 並返回指定 status
```sh
# 在 app2 丟出 exception, 並返回 417 status code
$ curl localhost:8080/app2?ex=417 -v
```
## Response the Root Cause to Client
在微服務架構中, 真正的決定 reponse body 或 http status code 的可能是好幾層下的某個服務, 但以 feign 預設的模式只要 client 不是回覆 2xx 的 status code 就會被送到 [ErrorDecoder](https://github.com/OpenFeign/feign/blob/master/core/src/main/java/feign/codec/ErrorDecoder.java#L56) 封裝並丟出 `feign.FeignException`, 這樣會造成 UI 拿不到真正的回應內容
因此可以透過註冊我們自己的 [@ExceptionHandler](https://github.com/softleader/feign-demo/blob/master/demo/src/main/java/tw/com/softleader/demo/FeignExceptionHandler.java) 來解決這樣的問題:
```java
@ExceptionHandler(FeignException.class)
public final ResponseEntity> exception(FeignException ex) {
if (ex.content() != null) { // 這邊依照專案需求, 實作如何判斷 feign client 已經處理了 body 的邏輯
return ResponseEntity.status(ex.status()).body(new RawValue(ex.contentUTF8()));
}
throw ex;
}
```
### Test
首先執行打包 image 並以 docker 環境執行 3 個 app instance
```sh
$ make up
```
約等待個 5~10 秒鐘, 可以使用以下指令測試, 若回應 200 則代表 app instances 已經就緒:
```sh
$ curl localhost:8080 -v
```
你可以以 IDE 開啟並執行測試程式 [tw.com.softleader.demo.DemoApplicationTests](https://github.com/softleader/feign-demo/blob/master/demo/src/test/java/tw/com/softleader/demo/DemoApplicationTests.java), 或可直接透過 gradle command 執行:
```sh
# 由指定層級回應 status code 200 及 response body
$ gradle test --tests DemoApplicationTests.responseByEachApp -b demo/build.gradle --info
# 在任何一層丟出 exception, 送到最外面時都要是當層丟出的 status code 及 response body
$ gradle test --tests DemoApplicationTests.responseRootCauseByEachApp -b demo/build.gradle --info
```