低代碼開(kāi)發(fā)和API快速開(kāi)發(fā)

在談低代碼開(kāi)發(fā)平臺(tái)的時(shí)候我多次強(qiáng)調(diào)了對(duì)象模型和數(shù)據(jù)驅(qū)動(dòng)的重要性，同時(shí)低代碼開(kāi)發(fā)平臺(tái)不是零代碼開(kāi)發(fā)，對(duì)于復(fù)雜規(guī)則的實(shí)現(xiàn)仍然需要自己寫代碼來(lái)完成。

而對(duì)于自己寫代碼實(shí)現(xiàn)復(fù)雜規(guī)則，其核心還是基于類似云原生里面ServerLess的思路，即通過(guò)API接口和服務(wù)來(lái)實(shí)現(xiàn)上層應(yīng)用和底層能力提供之間的解耦。那么如何快速地開(kāi)發(fā)和發(fā)布API接口服務(wù)，如何對(duì)API接口進(jìn)行組裝和編排就成為了低代碼開(kāi)發(fā)平臺(tái)不可缺少的一部分。

對(duì)于API快速開(kāi)發(fā)和發(fā)布，既可以是一個(gè)獨(dú)立的子產(chǎn)品，也可以是我們規(guī)劃設(shè)計(jì)的整體低代碼開(kāi)發(fā)平臺(tái)的一部分，但是核心都是基于對(duì)象建模和模型驅(qū)動(dòng)的思路進(jìn)行。

對(duì)于業(yè)界當(dāng)前對(duì)于API快速開(kāi)發(fā)，如何通過(guò)對(duì)象模型快速發(fā)布API接口，如何通過(guò)數(shù)據(jù)庫(kù)的數(shù)據(jù)表和SQL快速靈活發(fā)布API接口，如何對(duì)API接口靈活組裝和配置，并沒(méi)有特別好的開(kāi)源產(chǎn)品，因此在做我們自己的API快速開(kāi)發(fā)平臺(tái)的時(shí)候，更多還是借鑒了我們多年實(shí)施SOA項(xiàng)目，進(jìn)行微服務(wù)架構(gòu)實(shí)踐的一些實(shí)際項(xiàng)目需求出發(fā)進(jìn)行。

對(duì)于SOA項(xiàng)目實(shí)踐，即對(duì)傳統(tǒng)的SOA集成中的數(shù)據(jù)庫(kù)適配，存儲(chǔ)過(guò)程適配等能力轉(zhuǎn)變?yōu)楦虞p量易用的基于對(duì)象和數(shù)據(jù)庫(kù)的接口發(fā)布。

而對(duì)于項(xiàng)目實(shí)踐，經(jīng)常會(huì)遇到和外部業(yè)務(wù)系統(tǒng)集成，需要開(kāi)發(fā)自身接口的情況，那么通過(guò)API快速開(kāi)發(fā)平臺(tái)可以快速的通過(guò)可配置化的方式發(fā)布對(duì)外接口能力，同時(shí)實(shí)現(xiàn)基本的API接口管控和治理。

這也是我們自主研發(fā)基于數(shù)據(jù)驅(qū)動(dòng)的API低代碼開(kāi)發(fā)平臺(tái)的初衷。

API快速開(kāi)發(fā)平臺(tái)概述和應(yīng)用場(chǎng)景

對(duì)于前后端分離的應(yīng)用來(lái)說(shuō)，后端應(yīng)用主要是以API的形式對(duì)外提供能力，而在微服務(wù)架構(gòu)盛行的當(dāng)下，很多企業(yè)對(duì)于后端傳統(tǒng)的應(yīng)用程序已經(jīng)做了打散和拆分，實(shí)現(xiàn)了微服務(wù)改造。如果一個(gè)企業(yè)的IT建設(shè)比較全的話，那么在管理域、業(yè)務(wù)域和運(yùn)維域的傳統(tǒng)信息化系統(tǒng)至少超過(guò)10個(gè)，全部經(jīng)過(guò)微服務(wù)拆分改造后的微服務(wù)應(yīng)用可能達(dá)到幾十甚至上百個(gè)。如此多的微服務(wù)應(yīng)用不僅運(yùn)維管控存在問(wèn)題，而且微服務(wù)應(yīng)用的開(kāi)發(fā)、變更、升級(jí)都會(huì)存在較大的時(shí)間和資金成本。

微服務(wù)運(yùn)維管控的問(wèn)題交給Devops，本章只為應(yīng)對(duì)微服務(wù)應(yīng)用開(kāi)發(fā)變更帶來(lái)的問(wèn)題。目前業(yè)界提供了一個(gè)快速應(yīng)對(duì)的解決方案—API開(kāi)發(fā)設(shè)計(jì)平臺(tái)，該平臺(tái)能協(xié)助開(kāi)發(fā)人員全程可視化、無(wú)代碼快速創(chuàng)建API并發(fā)布，業(yè)務(wù)變更時(shí)快速更新API，分鐘級(jí)完成微服務(wù)應(yīng)用的產(chǎn)品開(kāi)發(fā)部署。API開(kāi)發(fā)設(shè)計(jì)平臺(tái)真正降低了企業(yè)應(yīng)用進(jìn)行微服務(wù)改造的難度，對(duì)于開(kāi)發(fā)設(shè)計(jì)人員來(lái)說(shuō)是一個(gè)非常不錯(cuò)的工具。

API開(kāi)發(fā)設(shè)計(jì)平臺(tái)的適用場(chǎng)景主要包括以下幾個(gè)方面：

1.統(tǒng)一后端API設(shè)計(jì)/開(kāi)發(fā)/測(cè)試平臺(tái)：承擔(dān)API的設(shè)計(jì)、開(kāi)發(fā)、測(cè)試功能，可通過(guò)配置完成API的在線發(fā)布，業(yè)務(wù)人員同樣可以熟練操作。

2.移動(dòng)端API開(kāi)發(fā)平臺(tái)： 對(duì)于APP、微信、小程序、釘釘等前端應(yīng)用，可作為統(tǒng)一后端API開(kāi)發(fā)平臺(tái)

3.前后端分離開(kāi)發(fā)：對(duì)于前后端分離的業(yè)務(wù)系統(tǒng)，可作為后端API的開(kāi)發(fā)平臺(tái)

4.數(shù)據(jù)快速提取：能實(shí)現(xiàn)數(shù)據(jù)中臺(tái)的數(shù)據(jù)能力發(fā)布，可作為數(shù)據(jù)快速提取平臺(tái)

5.微服務(wù)架構(gòu)開(kāi)發(fā)：同樣可作為業(yè)務(wù)系統(tǒng) (OA、CRM、ERP、HR、MES)微服務(wù)改造與開(kāi)發(fā)的基礎(chǔ)平臺(tái)。

對(duì)于API開(kāi)發(fā)開(kāi)發(fā)平臺(tái)我們采用微服務(wù)架構(gòu)進(jìn)行開(kāi)發(fā)，開(kāi)發(fā)底層框架選擇了JeecgBoot，并在該開(kāi)源框架下做了一些優(yōu)化處理和定制。

而對(duì)于API接口服務(wù)的開(kāi)發(fā)，

首先來(lái)談一下平臺(tái)的整體技術(shù)架構(gòu)，該平臺(tái)底層框架采用JeecgBot，架構(gòu)團(tuán)隊(duì)在JeecgBot的基礎(chǔ)之上做過(guò)一些優(yōu)化。對(duì)于服務(wù)的發(fā)布，平臺(tái)采用了IBM開(kāi)源輕量的Node-Red作為API在線發(fā)布的基礎(chǔ)組件，使用FreeMaker開(kāi)發(fā)模板作為微服務(wù)應(yīng)用生成框架，并集成了DBApi產(chǎn)品的后端所有功能。其他技術(shù)框架包括Springboot swagger Mybatis lombok Redis Shiro Maven Vue等。

場(chǎng)景一：數(shù)據(jù)實(shí)體生成API的實(shí)現(xiàn)

在前面已經(jīng)談到，該API開(kāi)發(fā)平臺(tái)是基于對(duì)象建模和數(shù)據(jù)驅(qū)動(dòng)的，因此核心是里面的元數(shù)據(jù)管理和數(shù)據(jù)實(shí)體定義。通過(guò)數(shù)據(jù)實(shí)體既可以向前生成API接口服務(wù)，又可以向后生成后臺(tái)的數(shù)據(jù)庫(kù)對(duì)象和數(shù)據(jù)表。

平臺(tái)支持多數(shù)據(jù)源管理，支持連接主流的關(guān)系型數(shù)據(jù)庫(kù)Mysql/Oracle/Sqlserver.支持連接的在線測(cè)試、密碼加密、連接共享等功能。

對(duì)象建模能力通過(guò)元數(shù)據(jù)管理來(lái)實(shí)現(xiàn)。元數(shù)據(jù)為最底層的原子數(shù)據(jù)對(duì)象，支持對(duì)元數(shù)據(jù)的基礎(chǔ)管理能力，同時(shí)元數(shù)據(jù)本身又是建立數(shù)據(jù)實(shí)體的基礎(chǔ)數(shù)據(jù)依賴，可通過(guò)關(guān)聯(lián)多個(gè)元數(shù)據(jù)來(lái)構(gòu)建多層數(shù)據(jù)實(shí)體。

支持通過(guò)導(dǎo)入元數(shù)據(jù)的方式來(lái)建立多層數(shù)據(jù)實(shí)體(目前支持父/子/孫三層實(shí)體關(guān)系)，可根據(jù)選擇的數(shù)據(jù)源連接類型來(lái)生成數(shù)據(jù)庫(kù)建表的SQL語(yǔ)句，并可直接在平臺(tái)上對(duì)數(shù)據(jù)源連接的數(shù)據(jù)庫(kù)生成數(shù)據(jù)表結(jié)構(gòu)和表依賴關(guān)系。

支持?jǐn)?shù)據(jù)實(shí)體快速發(fā)布在線API，在線API發(fā)布支持公有和私有兩種方式，私有API通過(guò)配置群組和Token值來(lái)限制訪問(wèn)；通過(guò)數(shù)據(jù)實(shí)體發(fā)布的API支持對(duì)該數(shù)據(jù)實(shí)體的新增/修改/刪除/查詢，操作的數(shù)據(jù)會(huì)同步讀取或者寫入數(shù)據(jù)實(shí)體對(duì)應(yīng)數(shù)據(jù)源連接的庫(kù)表中。

在線API發(fā)布后形成Node-Red的流程，通過(guò)設(shè)計(jì)器可對(duì)流程進(jìn)行拖拽修改；對(duì)于發(fā)布后的API，可直接在平臺(tái)上進(jìn)行測(cè)試。

從上可以看到整個(gè)思路完全是基于對(duì)象建模驅(qū)動(dòng)，通過(guò)對(duì)象建模來(lái)定義詳細(xì)的實(shí)體對(duì)象模型和接口契約規(guī)范，一方面是定義的對(duì)象模型可以通過(guò)配置的數(shù)據(jù)源管理向后臺(tái)生成數(shù)據(jù)庫(kù)表，一方面是可以直接將對(duì)象模型發(fā)布為通用的Rest API接口服務(wù)。

同時(shí)發(fā)布的內(nèi)容在后臺(tái)會(huì)生成對(duì)應(yīng)的Node-Red服務(wù)編排模板，如果對(duì)于發(fā)布的接口需要進(jìn)行相關(guān)的修改和調(diào)整，也相當(dāng)容易實(shí)現(xiàn)靈活定制和配置。

場(chǎng)景一：數(shù)據(jù)庫(kù)表和SQL直接發(fā)布API接口

如果你已經(jīng)創(chuàng)建了數(shù)據(jù)庫(kù)對(duì)象和數(shù)據(jù)表，那么你可以直接將數(shù)據(jù)表發(fā)布為Rest API接口，同時(shí)也可以自己定制參數(shù)化SQL語(yǔ)句，并將SQL語(yǔ)句發(fā)布為API接口服務(wù)。

對(duì)于數(shù)據(jù)庫(kù)中已經(jīng)存在的數(shù)據(jù)表，也可直接發(fā)布生成API。

數(shù)據(jù)表API發(fā)布功能除了發(fā)布常用的對(duì)數(shù)據(jù)表的新增/修改/刪除/查詢API之外，還發(fā)布對(duì)數(shù)據(jù)表進(jìn)行分頁(yè)和條件查詢的API；數(shù)據(jù)表API發(fā)布支持對(duì)發(fā)布后API的動(dòng)態(tài)編排，公有私有配置、API端點(diǎn)的在線測(cè)試。

SQL語(yǔ)句發(fā)布為API接口服務(wù)

可編寫SQL語(yǔ)句發(fā)布在線API，在線API發(fā)布在當(dāng)前服務(wù)器下，支持動(dòng)態(tài)SQL的編寫和發(fā)布，支持傳入?yún)?shù)的定義、配置和SQL映射。

2、通過(guò)SQL發(fā)布后的API可支持上線/下線操作、公有私有配置、在線API測(cè)試操作。

場(chǎng)景四：基于YAML規(guī)范來(lái)開(kāi)發(fā)發(fā)布API：

還有一種場(chǎng)景是首先進(jìn)行了API接口契約規(guī)范的設(shè)計(jì)，然后在進(jìn)行API接口的開(kāi)發(fā)實(shí)現(xiàn)。那么在API契約確定清楚后，實(shí)際整個(gè)API接口就已經(jīng)可以按規(guī)范進(jìn)行發(fā)布。

因此我們API快速開(kāi)發(fā)平臺(tái)在功能實(shí)現(xiàn)中也集成了第三方API規(guī)范設(shè)計(jì)器，支持YAML/JSON格式規(guī)范的結(jié)構(gòu)化設(shè)計(jì)。也集成了Swagger設(shè)計(jì)器，可靈活編寫API規(guī)范文件。

基于規(guī)范的API在線發(fā)布，可按步驟填寫配置完成API的開(kāi)發(fā)發(fā)布。支持對(duì)規(guī)范入?yún)⑴cSQL參數(shù)的快速映射。

基于規(guī)范在線發(fā)布后的API同樣也會(huì)部署到Node-Red中形成流程，支持對(duì)發(fā)布后API的動(dòng)態(tài)編排，公有私有配置、API端點(diǎn)的在線測(cè)試。

簡(jiǎn)單總結(jié)

經(jīng)過(guò)上面典型場(chǎng)景描述可以看到，API低代碼開(kāi)發(fā)平臺(tái)圍繞對(duì)象驅(qū)動(dòng)和元數(shù)據(jù)建模為核心，支撐API接口的快速定義，快速發(fā)布能力。同時(shí)在已有數(shù)據(jù)庫(kù)表和對(duì)象的情況下又能夠快速的將數(shù)據(jù)庫(kù)表，參數(shù)化SQL預(yù)計(jì)等發(fā)布為API接口服務(wù)。

平臺(tái)API開(kāi)發(fā)設(shè)計(jì)功能支持Mysql/Oracle/Sqlserver三種類型數(shù)據(jù)庫(kù)，并且API加入了數(shù)據(jù)庫(kù)事務(wù)支持，針對(duì)API服務(wù)的整體性事務(wù)，出錯(cuò)回滾所有數(shù)據(jù)。在線API的調(diào)用和導(dǎo)出后微服務(wù)應(yīng)用中API的調(diào)用數(shù)據(jù)和返回?cái)?shù)據(jù)完全相同，保證了API在線使用和分布式部署后使用的一致性。在線API調(diào)用日志都已記錄并可供查詢和統(tǒng)計(jì)。

同時(shí)在平臺(tái)我們當(dāng)前還在進(jìn)一步完善對(duì)于發(fā)布的API接口進(jìn)行服務(wù)編排和能力組裝的能力。該平臺(tái)一方面是應(yīng)用到日常的API接口快速開(kāi)發(fā)，同時(shí)也是低代碼開(kāi)發(fā)平臺(tái)的一個(gè)重要能力補(bǔ)充。

注：歡迎點(diǎn)贊，歡迎轉(zhuǎn)發(fā)評(píng)論，如果大家都感興趣的話我后續(xù)會(huì)考慮將該產(chǎn)品開(kāi)源出來(lái)。