您当前的位置:首页 > 电脑百科 > 程序开发 > 编程百科

API快速开发平台设计思考

时间:2021-01-07 09:59:29  来源:  作者:
API快速开发平台设计思考

 

在我头条谈API网关的时候曾经谈到过快速开发平台,即将API快速开发的一些内容放入到API网关中,实际来看围绕API全生命周期管理,本身包括了开发态,运行态,运维态。

对于API网关更多的是解决运行态的问题,API网关本身应该轻量化设计,不做太多的协议转换,适配,数据映射等工作,这些工作应该放到API开发平台来完成。API开发平台最终就是开发完成并暴露一个标准的Http API接口,并将接口注册和接入到API网关。

API全生命周期管理

围绕API全生命周期管理来看,整个子系统划分如下:

API快速开发平台设计思考

 

简单来讲这部分可以分解为四个子系统,即API开发平台,API网关引擎,API监控运维平台,API全生命周期管控平台。

对于传统ESB总线里面的适配器,协议转换等相关比较重的内容,都可以转移到API快速开发平台来完成,即API开发平台暴露标准的API服务接口,注册和接入到API网关引擎。而对于API监控平台则从引擎采集日志信息,进行API性能监控和日志监控分析。

API全生命周期管控平台实现API接口从设计,开发,测试,部署上线的全生命周期管理,也可以理解为底层三个子系统的一个统一管理门户,实现和下面三个子系统集成。

对于API开发平台开发和配置完成的微服务API接口,可以支持自动部署到微服务运行平台。

基于对象建模驱动

API快速开发平台设计思考

 

在整个API开发平台实现中,核心思想仍然应该是基于对象建模驱动,通过对象建模很好的实现接口和底层数据库,数据库表之间的解耦,也方便实现底层多数据库,多表的支持能力。

当前很多API快速开发平台都是基于数据库对象或表,直接发布类似CRUD的API接口服务,但是基于是数据库表的直接发布,我们仍然建议逆向对象这层,方便后续在对象层进行相关的组合,规则扩展等操作。

对象建模和API接口契约

可以直接在API开发平台创建对象,并对数据项进行定义,对象是一个多层的树状结构实体。一个对象可以向数据库生成多张表。对于已经存在的数据对象,也可以进行组合,将多个组合为一个复合对象结构。

对象的好处即是一个完整的对象属于同一生命周期,可以一起进行事务控制。

一个设计好的对象可以默认生成标准的POST,GET,DELETE等接口操作方法,类似下图,整个对象接口契约的生成也应该是自动的。

API快速开发平台设计思考

 

定义好的对象可以直接生成类似RAML,YAML,WADL等接口契约文件。

类似Swagger工具一样,完成的对象建模本身也可以直接导出不同语言,不同开发框架下的客户端消费框架,服务端提供框架代码。

API快速开发平台设计思考

 

对象适配到数据库

前面讲到了,既可以是数据库直接逆向对象,也可以是在对象建模完成后,将对象适配到数据库。完成对象和数据库表之间的映射。一个对象可以映射到多张数据库表,因此在映射过程中除了完成数据库表和字段映射外,还需要完成主外键关联关系的映射操作。

在完成对象模型和数据库表之间的映射和适配后,基本发布的API接口已经可用。

API接口发布

对于完成的对象定义,可以选择具体发布哪些API接口服务能力。比如可以只选择发布查询接口,也可以只选择发布数据导入的POST接口等。

注意API接口的发布,具体可以基于全局的对象建模,配置具体需要发布到接口的数据项信息。很多时候我们对数据对象的操作,并不是操作整个对象全集,而仅仅是部分数据项。

API接口模拟测试和验证

可以对发布的API接口进行模拟测试和验证,因此需要提供在线的API测试工具,能够方便在线进行API接口的测试工作。同时可以对测试过的用例和测试数据进行保存。

API接口文档生成

支持自动生成API接口文档的能力。这个地方可以直接对接类似开源Swagger等工具来实现API接口文档的自动生成功能。

对象常用接口操作

当对象定义完成后,可以基于对象进行相关API接口的自动生成。在这里简单列下基于对象常用的接口方法,主要包括新增一条数据,基于主键更新,查询,删除数据。其它的则是基于条件查询对数据进行查询相关操作等。

在GtiHub里面开源又一个xMySQL的工具,可以直接将整个mysql数据库中的数据库表发布为RestAPI接口,具体可以安装试用。

npm install -g xmysql
xmysql -h localhost -u mysqlUsername -p mysqlPassword -d databaseName
http://localhost:3000

注意需要提前安装Node.js,部分接口方法列表如下:

API快速开发平台设计思考

 

由于生成的API接口都没有相关的权限控制,因此该开源工具也仅仅用于自己测试和验证使用。但是生成的方法和API可以作为API开发工具时候参考。

实际上对于API接口的生成,我们并不建议对于复杂查询条件下的查询都通过GET方法来实现,更好的思路还是通过POST方法,将查询条件作为POST输入进行处理。

复合对象一次生成

比如将订单作为一个对象,实际包括了订单头和订单明细表,而在进行API生成时候可以一次生成基于订单对象的插入操作,查询操作。最终查询出来的是一个订单复合实体Json数据。而对于订单插入,也是先准备好整个订单实体信息,一次调用API接口完成数据插入,也方便在API接口实现的时候进行事务控制。

复合对象生成的API接口更类似于领域对象暴露的API接口服务能力。

分页支持

对于查询API接口服务的生成,应该支持分页能力,具体分页的大小,本次查询访问具体页数等信息都可以作为API接口的查询输入参数进行设置。

直接定义API接口并发布

API快速开发平台设计思考

 

在前面谈到了基于对象来发布API接口服务,但是还有一些业务规则逻辑类接口,复杂的管理数据查询类接口等并不能简单的通过对象来自动生成。

因此还需要能够实现基于方法来发布API接口服务。

即在API快速开发平台能够进行API接口的自定义,详细的定义API接口的输入参数和输出参数信息。同时对于定义完成的接口实现和后台方法的绑定。

实现和JAR包里面的API接口的绑定

可以实现和一个JAR包里面方法或函数的绑定,将一个方法或函数发布为一个Http API接口方法。在当前很多公有云的云服务总线产品上可以看到这个实现方式。

实现和动态SQL的绑定

可以将定义的一个API接口方法和动态SQL进行绑定。其中动态SQL本身具体动态输入参数,这些输入参数和API接口定义中的输入进行数据映射。同时SQL语句查询的输出结果和API接口定义的输出字段进行映射。

如果动态SQL是插入或更新类,同样也可以通过参数化变量方式进行数据映射和绑定操作。

和存储过程进行绑定

一个数据库的存储过程,实际即是一个方法函数,因此可以将API接口定义的输入和输出和数据库存储过程的输入和输出进行映射绑定。

要注意的是针对不同的数据库存储过程schema信息获取和适配本身有差异,这也是在上图中构建一个独立的统一数据库适配层的原因。

规则处理

API快速开发平台设计思考

 

在API接口开发过程中,可以进行一些简单的规则处理。具体如下:

输入数据完整性校验

对输入数据进行完整性校验,其中包括场景的数据类型,长度,范围约束等,这些都是属于比较容易通过配置进行实现的内容。

数据项间规则处理

可以对多个数据项进行简单规则处理,其中包括了场景的数据映射,数据丰富,数据截取等。这些本身也是在主流的传统ESB总线产品中都支持的内容。

自定义脚本语言

对于API快速开发平台本身可以作为低代码开发平台的一个子类,因此如果能够支持自定义脚本语言进行规则处理,那么整体扩展性和灵活性也会得到大幅度提升。

消息头和输出预留

对于API开发平台发布的API接口,需要对输入消息头,输出的异常类型,异常编码,信息等字段进行提前约定。

在输入的消息头中往往包括了类似用户名,Token等用于访问安全校验的字段,也包括了类似路由,分页等相关扩展字段信息。对于输出字段,需要对返回的异常类型,编码,异常信息等进行约定。特别是涉及到数据CUD操作的时候,需要按约定的输出字段进行输出。

服务组合和编排

对于API开发平台还可以进一步提供服务组合和服务编排的能力。这个能力的实现也不适合放在API网关来完成,而是应该规划到API开发平台来实现。

API快速开发平台设计思考

 

服务组合编排是服务组合,服务组装等,希望通过服务编排能够完成这些事情,而不是简单的完成单一服务的设计和开发。即将多个原子服务组合或组装在一起,最终形成一个新的服务并提供的能力。我们举例来说明下。

比如存在A,B,C三个原子服务,我们通过服务编排形成一个新的D服务。

三个原子服务全部是查询服务,希望组装一个新服务,一次返回A,B,C三个服务查询结果

这个即我们说的服务组合能力,比如我们可以对合同基本信息查询,合同条款信息查询,合同执行信息查询三个基本原子服务进行组合,最终返回一个服务综合信息查询的服务,一次返回三个查询结果。

在这种场景下我们需要考虑查询结果是并行返回还是按层次返回即可。

二个查询类的原子服务,最终需要返回两个数据集关联查询的结果集

这个在微服务架构做了底层数据库拆分后经常会遇到,比如对于物料基本信息查询,和采购订单明细查询是在两个独立的数据库独立服务提供。而我们希望返回的查询结果集是物料编码,名称,型号,单位,价格,采购数量的复合结果集。

这种场景下往往一般都是在前端功能开发的时候进行组装,而实际上可以考虑是否可以在服务编排层解决这个问题,该问题写代码来解决容易,但是要做为可视化服务编排组态方式来做实际上有一定的难度。

对单个已有服务进行裁剪和丰富并形成一个新服务输出

这个暂时也将其纳入到服务编排的范畴,即仍然是输入服务,但是输出是提供了一个新服务。

即对单个已有的服务进行服务裁剪和丰富,比如对于输出结果过滤掉一些数据项,对于输入固定输入一些数据项等。这些简单的服务裁剪,丰富,或简单的数据转换可以在服务编排的时候完成,并提供一个新服务。

对多个原子服务进行流程式的前后串接并形成服务提供

这个是我们经常看到的一种服务编排场景,即A,B,C三个服务直接进行编排,即A服务的输出直接变为B服务的输入,B服务的输出又变为C服务的输出。如果仅仅是上面假设的这样,那么这种流程式的服务编排仍然很简单,也很容易去实现。

但是实际上的难点在于A服务的输出本身也需要作为C服务的输出,同时A,B服务的输出也可能是整体输出的一部分,这本身就加大了服务编排可视化设计的难度。

单一业务服务为主体服务,但是编排多个业务规则逻辑处理类服务

这也是经常会遇到的场景,比如我们在进行合同信息导入的时候,首先要调用合同有效性校验服务,同时还有调用预算信息检查和扣减服务进行相关的完整性和业务规则校验。在这些校验完成后再调用实际的合同信息导入服务,如果校验失败则直接返回失败结果。

这类服务编排往往也正是我们实际在进行前端功能开发时候服务进行组装的逻辑。

多个导入服务组装为一个导入服务合并导入并形成一个新服务

这个场景实际上和场景1是对应的,既然多个服务可以组合后形成组合结果返回,那么自然可以将多个导入服务合并为一个导入服务,一次性的完成数据导入。

比如有项目信息导入和项目WBS信息导入两个原子服务,那么我们就可以提供一个新的项目信息导入服务,一次完成项目基本信息和项目WBS信息的导入。

API快速开发平台设计思考

 

在这些场景里面可以看到,实际上服务编排就是服务串联,服务并联下的输入和输出合并,服务内容丰富和裁剪等常见场景。在一个理想的场景下,我们最希望实现的就是一个业务功能点的实现完全能够通过服务编排可视化设计方式来完成。

关于服务编排详细说明可以参考下文:

从ESB服务组合编排到NetflixConductor微服务编排

源代码导出

API快速开发平台设计思考

 

对于API快速开发平台,很难去实现复杂的业务规则编码。因此在存在复杂业务规则实现的时候仍然是建议开发人员自己开发代码来完成。因此整个平台应该提供源代码导出功能,导出的源代码应该直接能够编译通过,脱离API开发平台部署和运行。

对于导出的源代码,考虑到后续API接口变更的场景,建议是对扩展部分进行约定。

比如一个标准的API接口服务实现方法,可以在前后增加扩展处理。

//BeforeDo();
//ProcessAPI();
//AfterDo();

这样在接口实现前可以进行额外的业务规则处理和完整性校验,在接口返回数据前还可以对输出的数据进一步进行处理和加工。

微服务应用

可以将多个对象或多个API接口服务打包到一个微服务应用再进行部署和发布。因此在这里引入一个微服务集的概念,对微服务API进行打包处理。

打包完成的微服务可以导出为独立的JAR包进行部署,也可以直接在API开发平台进行托管部署。对于API开发平台本身应该对接到微服务运行平台。



Tags:API   点击:()  评论:()
声明:本站部分内容及图片来自互联网,转载是出于传递更多信息之目的,内容观点仅代表作者本人,如有任何标注错误或版权侵犯请与我们联系(Email:2595517585@qq.com),我们将及时更正、删除,谢谢。
▌相关推荐
近日只是为了想尽办法为 Flask 实现 Swagger UI 文档功能,基本上要让 Flask 配合 Flasgger, 所以写了篇 Flask 应用集成 Swagger UI 。然而不断的 Google 过程中偶然间发现了...【详细内容】
2021-12-23  Tags: API  点击:(6)  评论:(0)  加入收藏
一个项目的大部分API,测试用例在参数和参数值等信息会有很多相似的地方。我们可以复制API,复制用例来快速生成,然后做细微调整既可以满足我们的测试需求1.复制API:在菜单发布单...【详细内容】
2021-12-14  Tags: API  点击:(20)  评论:(0)  加入收藏
10月18号, W3C中网络平台孵化器小组(Web Platform Incubator Community Group)公布了HTML Sanitizer API的规范草案。这份草案用来解决浏览器如何解决XSS攻击问题。 网络安全中...【详细内容】
2021-12-07  Tags: API  点击:(18)  评论:(0)  加入收藏
当我们通过kubectl来查看、修改Kubernetes资源时,有没有想过后面的接口到底是怎样的?有没有办法探查这些交互数据呢?Kuberenetes客户端和服务端交互的接口,是基于http协议的。所...【详细内容】
2021-11-23  Tags: API  点击:(29)  评论:(0)  加入收藏
前言客户端请求API,通常需要通过返回码来判断API返回的结果是否符合预期,以及该如何处理返回的内容等。相信很多同学都吃过返回码定义混乱的亏,有的API用返回码是int类型,有的是...【详细内容】
2021-10-28  Tags: API  点击:(51)  评论:(0)  加入收藏
凭借着平缓的学习曲线和简单直接的语法,Python在全球范围内的受欢迎程度,正在呈指数级增长。该编码语言往往可以被用于Web开发、软件开发、数学计算、系统脚本、以及几乎所有...【详细内容】
2021-09-22  Tags: API  点击:(47)  评论:(0)  加入收藏
Guava提供的RateLimiter可以限制物理或逻辑资源的被访问速率,咋一听有点像java并发包下的Samephore,但是又不相同,RateLimiter控制的是速率,Samephore控制的是并发量。RateLimit...【详细内容】
2021-09-17  Tags: API  点击:(72)  评论:(0)  加入收藏
前言前后端分离开发模式中,api文档是最好的沟通方式。今天就来说一说如何整合Swagger生成一套漂亮、美观、实用的接口文档。 源码传送门: https://gitee.com/huoqstudy/xiliu-...【详细内容】
2021-09-08  Tags: API  点击:(65)  评论:(0)  加入收藏
注:商业级功能效果演示,非开源,无源码。研发基础在之前AJAX请求数据加密效果之上,更进一步,对返回数据加密。之前是单纯用于登录场景。更广泛的场景是所有此类AJAX WEB API接口。...【详细内容】
2021-09-03  Tags: API  点击:(73)  评论:(0)  加入收藏
最近一连串的 API 安全事件(Peloton、Experian、Clubhouse 等)无疑迫使许多安全和开发团队仔细检查他们的 API 安全状况,以确保它们不会成为下一个被攻击对象。创建面向外部受...【详细内容】
2021-09-01  Tags: API  点击:(59)  评论:(0)  加入收藏
▌简易百科推荐
摘 要 (OF作品展示)OF之前介绍了用python实现数据可视化、数据分析及一些小项目,但基本都是后端的知识。想要做一个好看的可视化大屏,我们还要学一些前端的知识(vue),网上有很多比...【详细内容】
2021-12-27  项目与数据管理    Tags:Vue   点击:(1)  评论:(0)  加入收藏
程序是如何被执行的  程序是如何被执行的?许多开发者可能也没法回答这个问题,大多数人更注重的是如何编写程序,却不会太注意编写好的程序是如何被运行,这并不是一个好...【详细内容】
2021-12-23  IT学习日记    Tags:程序   点击:(9)  评论:(0)  加入收藏
阅读收获✔️1. 了解单点登录实现原理✔️2. 掌握快速使用xxl-sso接入单点登录功能一、早期的多系统登录解决方案 单系统登录解决方案的核心是cookie,cookie携带会话id在浏览器...【详细内容】
2021-12-23  程序yuan    Tags:单点登录(   点击:(8)  评论:(0)  加入收藏
下载Eclipse RCP IDE如果你电脑上还没有安装Eclipse,那么请到这里下载对应版本的软件进行安装。具体的安装步骤就不在这赘述了。创建第一个标准Eclipse RCP应用(总共分为六步)1...【详细内容】
2021-12-22  阿福ChrisYuan    Tags:RCP应用   点击:(7)  评论:(0)  加入收藏
今天想简单聊一聊 Token 的 Value Capture,就是币的价值问题。首先说明啊,这个话题包含的内容非常之光,Token 的经济学设计也可以包含诸多问题,所以几乎不可能把这个问题说的清...【详细内容】
2021-12-21  唐少华TSH    Tags:Token   点击:(9)  评论:(0)  加入收藏
实现效果:假如有10条数据,分组展示,默认在当前页面展示4个,点击换一批,从第5个开始继续展示,到最后一组,再重新返回到第一组 data() { return { qList: [], //处理后...【详细内容】
2021-12-17  Mason程    Tags:VUE   点击:(14)  评论:(0)  加入收藏
什么是性能调优?(what) 为什么需要性能调优?(why) 什么时候需要性能调优?(when) 什么地方需要性能调优?(where) 什么时候来进行性能调优?(who) 怎么样进行性能调优?(How) 硬件配...【详细内容】
2021-12-16  软件测试小p    Tags:性能调优   点击:(19)  评论:(0)  加入收藏
Tasker 是一款适用于 Android 设备的高级自动化应用,它可以通过脚本让重复性的操作自动运行,提高效率。 不知道从哪里听说的抖音 app 会导致 OLED 屏幕烧屏。于是就现学现卖,自...【详细内容】
2021-12-15  ITBang    Tags:抖音防烧屏   点击:(23)  评论:(0)  加入收藏
11 月 23 日,Rust Moderation Team(审核团队)在 GitHub 上发布了辞职公告,即刻生效。根据公告,审核团队集体辞职是为了抗议 Rust 核心团队(Core team)在执行社区行为准则和标准上...【详细内容】
2021-12-15  InfoQ    Tags:Rust   点击:(24)  评论:(0)  加入收藏
一个项目的大部分API,测试用例在参数和参数值等信息会有很多相似的地方。我们可以复制API,复制用例来快速生成,然后做细微调整既可以满足我们的测试需求1.复制API:在菜单发布单...【详细内容】
2021-12-14  AutoMeter    Tags:AutoMeter   点击:(20)  评论:(0)  加入收藏
最新更新
栏目热门
栏目头条