如何更快理解和运用服务编排？（使用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":{},  }  }