如何更快理解和運用服務編排？（使用Goku API Gateway實現）

• 2019 年 10 月 21 日
• 筆記

上一篇博客 未來實現API管理系統的幾個關鍵詞 發佈後，有不少讀者私信我，讓我寫一篇實際運用的文章，我周末趁着有空寫了這篇有關“服務編排”的文章。用的是Goku API Gateway進行演示， 希望本文對讀者有所啟發。

什麼是服務編排/數據聚合？

服務編排/數據聚合 指的是可以通過一個請求來依次調用多個微服務，並對每個服務的返回結果做數據處理，最終整合成一個大的結果返回給前端。

例如一個服務是“查詢用戶預定的酒店”，前端僅需要傳一個訂單ID，後端會返回整個訂單的信息，包括用戶信息、酒店信息和房間信息等。

這個服務背後可能對應着以下幾個操作：

• 請求訂單詳情，返回訂單對應的用戶ID、酒店ID、房間ID；

• 根據各類ID查詢對應的信息；

• 將數據做過濾、移動等操作，最後整合起來；

• 將整合好的數據返回給前端。

下面的圖可以幫你更好理解：

編排的優勢

微服務架構上對功能做了解耦，使用服務編排可以快速從各類服務上獲取需要的數據，對業務實現快速響應。總的來說，編排有以下幾點優勢：

• 功能解耦，服務能夠被複用；

• 對前端友好，無需多次請求；

• 業務響應速度快，服務能夠被快速生成；

• 返回數據有改動的話，請求接口無影響；

• 老系統改動的情況下，不需要改動前端，可以通過網關對數據做兼容。

使用編排工具Goku API Gateway：

先簡單介紹一下，Goku API Gateway （中文名：悟空 API 網關）是一個基於 Golang 開發的微服務網關，能夠實現高性能 HTTP API 轉發、服務編排、多租戶管理、API 訪問權限控制等目的，擁有強大的自定義插件系統可以自行擴展，並且提供友好的圖形化配置界面，能夠快速幫助企業進行 API 服務治理、提高 API 服務的穩定性和安全性。

本次之所以採用Goku API Gateway來進行演示，主要看中的是它因為支持一個編排API對應多個後端服務，每個後端服務的請求參數可以使用前端傳入的參數，也可以在編排里自定義（寫靜態參數或從返回數據里獲得）。每個後端服務的返回數據支持過濾、刪除、移動、重命名、拆包和封包等操作，而且編排API能夠設定編排失敗時的異常返回。這對本次服務編排很有作用。

這次用的是Goku API Gateway 的社區版本（CE），也就是開源版本，我對內置的插件系統進行部分改動也算是定製開發了。

項目地址：https://github.com/eolinker/goku-api-gateway

官網地址：https://www.eolinker.com

下面進入實際操作環節。

如何在Goku上做服務編排？

我們將編排的整個操作放到網關進行，由網關對數據做處理與轉換，這樣無需對後端服務做改動。一個請求到達網關，網關調用多個後端服務，並且在網關上對各個服務的返回數據做處理（操作有過濾、移動、重命名、封包、拆包，後面會對各操作做詳細解釋），最後由網關將數據整合好返回給前端。通過下圖查看會更加明白：

操作步驟

1.在網關上，新建API的類型可以選擇服務編排：

2.配置 查詢預定酒店 API的請求信息：

3.添加並配置Step：

網關將編排過程中對 API的轉發處理過程（轉發->獲取返回數據->數據處理）稱為一個 Step。

添加一個轉發服務，該服務為 查詢訂單詳情API，配置相應的轉發地址、傳入的參數、對返回數據做何種處理等。

由於篇幅原因，後續的Step（查詢用戶詳情、查詢酒店詳情、查詢房間詳情）就不一一展示了。

編排的傳遞參數方式和數據處理

為了讓讀者更好的理解編排的實現方式，簡單說一下兩種傳遞參數方式：

網關將編排過程中對 API的轉發處理過程（轉發->獲取返回數據->數據處理）稱為一個 Step。

我們將處理查詢訂單詳情API稱為 Step1，其中Step1的返回數據有：用戶ID、酒店ID、房間ID。同理，將查詢用戶信息這步稱為 Step2，將查詢酒店信息稱為 Step3，將查詢房間信息稱為 Step4。

傳參規則：

• 使用前端傳入的參數可以寫成：body.參數名、header.參數名

• 使用Step1里的返回數據作為參數可以寫成：body1.參數名、header1.參數名

• 以此類推

以下為轉發路徑的傳參寫法：

• 例如Step1要接收前端傳入的orderID參數，還有Authorization參數。

Step1的轉發路徑可以寫成：/getOrderInfo/{{body.orderID}}/{{header.Authorization}}

• 例如Step2 接收 Step1 里的返回用戶ID參數（userID），同時接收前端傳入的Authorization參數。

Step2的轉發路徑可以寫成：/getUserInfo/{{body1.userID}}/{{header.Authorization}}

Step2中需要接收Step1里返回的userID作為參數，同時需要接收前端傳入的Authorization參數

在網關里Step2的請求參數配置如下所示，請求參數存在多個的話用換行表示：

1.查詢訂單詳情的API，返回數據稱為json1，內容如下：

{  "status":"000000",  "data":{  "id":"201910180009x"          ,"user_account":"[email protected]"          ,"hotal":"0001"          ,"room":"biger1"          ,"time_start":"20191019"          ,"time_end":"20191020"  }  }

{  "status":"000000",  "data":{  "account":"[email protected]",  "full_name":"",  "phone":""  }  }

{  "status":"000000",  "data":{  "id":"001",          "type":"星級酒店",          "name":"",          "address":"",          "location":{},  }  }

{  "status":"000000",  "data":{  "name":"豪華大床房"          ,"window":1          ,"floor":"10-12"          ,"nosmoke":1  }  }

{      "id":"201910180009x"      ,"userInfo":{  "account":"[email protected]",  "full_name":"",  "phone":""      }      ,"hotelinfo":{  "type":"星級酒店",  "name":"",  "address":"",  "location":{},      }      , "roominfo":{          "name":"豪華大床房"  ,"window":1  ,"floor":"10-12"  ,"nosmoke":1      }  }

{  "status":"000000",  "data":{  "id":"001",          "type":"星級酒店",          "name":"",          "address":"",          "location":{},  }  }

"hotelinfo":{  "type":"星級酒店",  "name":"",  "address":"",  "location":{},      }

{  "status":"000000",  "data":{          "type":"星級酒店",          "name":"",          "address":"",          "location":{},  }  }

{          "type":"星級酒店",          "name":"",          "address":"",          "location":{},  }

{  "hotelinfo":{          "type":"星級酒店",          "name":"",          "address":"",          "location":{},  }  }