服务编排 | API管理系统|开放平台管理系统|API集成平台

# 概述

服务编排是FizzGate集成平台提供的一个强大的功能，能够基于现有的业务微服务通过在线配置的方式快速的生成一个聚合接口，减少中间层胶水代码以及降低编码投入。本文介绍服务编排三个常见场景的使用：单API结果裁剪、多API数据聚合、多API之间传递依赖。

# 服务编排架构

fizz_aggregate_architecture

# 适用场景

# 前端

1、一个页面调用多个接口时，可以编排好返回聚合结果，提高页面数据的加载速度

2、移动设备计算能力有限，可以把数据计算或业务处理逻辑放到服务端完成，加快页面响应

# 后端

1、替换应用层的聚合接口，减少应用层的胶水代码

2、快速生成透传数据类型的接口

3、数据转换和映射

# 资料准备

# FizzGate集成平台安装

可参考： https://www.fizzgate.com/fizz/guide/installation (opens new window)

# 底层服务接口

本文服务编排调用的底层服务接口源码可从gitee(https://gitee.com/fizzgate/fizz-examples)获取。从github克隆最新的fizz-examples源码，并启动fizz-examples-rest-api服务。

fizz_aggregate_demo_backend_1

fizz_aggregate_demo_backend_2

管理后台(菜单位置：RPC管理->服务声明)配置服务声明，如图所示。

fizz_aggregate_demo_backend_3

# 新增编排接口

管理后台，菜单位置：服务编辑->接口列表，点击新增。

# 例子1：单API结果裁剪

本例子在编排接口中调用底层fizz-examples-rest-api服务的/user/detail接口(接口源码：UserController (opens new window))来获取用户详情信息，并对该接口的响应进行裁剪以满足我们想要的数据格式。

# 基础信息

fizz_aggregate_demo_1_1

# 配置输入

在配置输入tab可以定义接口的入参和请求头等信息，如果不配置入参或请求头，网关会原样接收调用方传过来的所有入参或请求头，但不会对接收到的参数做任何校验。在本例子中查询用户详情必须传userId，配置如下图所示。

fizz_aggregate_demo_1_2

# 配置步骤

新增1个步骤step1，然后在步骤step1里新增1个请求request1，服务选择我们预先准备好的fizz-examples-rest-api服务，请求/user/detail接口。入参我们使用input.request.params.userId来引用前端传过来的userId参数，在这里使用了引用值的方式来引用入参，相关引用值的使用方式可参考文档：数据转换使用文档 (opens new window) 。配置响应部分留空，网关会原样接收接口的返回结果。

fizz_aggregate_demo_1_3

# 配置输出

配置要返回给前端的响应报文，这里配置了响应体有以下字段：

msgCode：固定值字符串类型，值为"100";

msg：引用类型，值为步骤step1中请求request1的响应的message字段；

user.info.age：引用类型，值为步骤step1中请求request1的响应的data.age字段。

fizz_aggregate_demo_1_4

# 测试

直接调用/user/detail接口得到的响应如图所示。

fizz_aggregate_demo_1_5

测试接口得到响应如图所示。

fizz_aggregate_demo_1_6

从测试接口的响应可以看出服务编排接口已完成了对/user/detail接口的请求并正确输出了配置的结果，完成了对API结果的裁剪。

# 例子2：多API数据聚合

本例子在编排接口中并发调用底层fizz-examples-rest-api服务的/user/detail接口(接口源码：UserController (opens new window))和/order/detail接口(接口源码：OrderController (opens new window))来获取用户详情信息和订单详情信息，并在订单详情信息中加入我们想要的用户名和手机号码，将聚合后的订单详情信息响应给客户端。