基于對象模型和數(shù)據(jù)驅(qū)動的API低代碼開發(fā)平臺(基于對象的編程)
低代碼開發(fā)和API快速開發(fā)
在談低代碼開發(fā)平臺的時候我多次強調(diào)了對象模型和數(shù)據(jù)驅(qū)動的重要性,同時低代碼開發(fā)平臺不是零代碼開發(fā),對于復雜規(guī)則的實現(xiàn)仍然需要自己寫代碼來完成。
而對于自己寫代碼實現(xiàn)復雜規(guī)則,其核心還是基于類似云原生里面ServerLess的思路,即通過API接口和服務來實現(xiàn)上層應用和底層能力提供之間的解耦。那么如何快速地開發(fā)和發(fā)布API接口服務,如何對API接口進行組裝和編排就成為了低代碼開發(fā)平臺不可缺少的一部分。
對于API快速開發(fā)和發(fā)布,既可以是一個獨立的子產(chǎn)品,也可以是我們規(guī)劃設計的整體低代碼開發(fā)平臺的一部分,但是核心都是基于對象建模和模型驅(qū)動的思路進行。
對于業(yè)界當前對于API快速開發(fā),如何通過對象模型快速發(fā)布API接口,如何通過數(shù)據(jù)庫的數(shù)據(jù)表和SQL快速靈活發(fā)布API接口,如何對API接口靈活組裝和配置,并沒有特別好的開源產(chǎn)品,因此在做我們自己的API快速開發(fā)平臺的時候,更多還是借鑒了我們多年實施SOA項目,進行微服務架構實踐的一些實際項目需求出發(fā)進行。
對于SOA項目實踐,即對傳統(tǒng)的SOA集成中的數(shù)據(jù)庫適配,存儲過程適配等能力轉(zhuǎn)變?yōu)楦虞p量易用的基于對象和數(shù)據(jù)庫的接口發(fā)布。
而對于項目實踐,經(jīng)常會遇到和外部業(yè)務系統(tǒng)集成,需要開發(fā)自身接口的情況,那么通過API快速開發(fā)平臺可以快速的通過可配置化的方式發(fā)布對外接口能力,同時實現(xiàn)基本的API接口管控和治理。
這也是我們自主研發(fā)基于數(shù)據(jù)驅(qū)動的API低代碼開發(fā)平臺的初衷。
API快速開發(fā)平臺概述和應用場景
對于前后端分離的應用來說,后端應用主要是以API的形式對外提供能力,而在微服務架構盛行的當下,很多企業(yè)對于后端傳統(tǒng)的應用程序已經(jīng)做了打散和拆分,實現(xiàn)了微服務改造。如果一個企業(yè)的IT建設比較全的話,那么在管理域、業(yè)務域和運維域的傳統(tǒng)信息化系統(tǒng)至少超過10個,全部經(jīng)過微服務拆分改造后的微服務應用可能達到幾十甚至上百個。如此多的微服務應用不僅運維管控存在問題,而且微服務應用的開發(fā)、變更、升級都會存在較大的時間和資金成本。
微服務運維管控的問題交給Devops,本章只為應對微服務應用開發(fā)變更帶來的問題。目前業(yè)界提供了一個快速應對的解決方案—API開發(fā)設計平臺,該平臺能協(xié)助開發(fā)人員全程可視化、無代碼快速創(chuàng)建API并發(fā)布,業(yè)務變更時快速更新API,分鐘級完成微服務應用的產(chǎn)品開發(fā)部署。API開發(fā)設計平臺真正降低了企業(yè)應用進行微服務改造的難度,對于開發(fā)設計人員來說是一個非常不錯的工具。
API開發(fā)設計平臺的適用場景主要包括以下幾個方面:
1.統(tǒng)一后端API設計/開發(fā)/測試平臺:承擔API的設計、開發(fā)、測試功能,可通過配置完成API的在線發(fā)布,業(yè)務人員同樣可以熟練操作。
2.移動端API開發(fā)平臺: 對于APP、微信、小程序、釘釘等前端應用,可作為統(tǒng)一后端API開發(fā)平臺
3.前后端分離開發(fā):對于前后端分離的業(yè)務系統(tǒng),可作為后端API的開發(fā)平臺
4.數(shù)據(jù)快速提?。?/strong>能實現(xiàn)數(shù)據(jù)中臺的數(shù)據(jù)能力發(fā)布,可作為數(shù)據(jù)快速提取平臺
5.微服務架構開發(fā):同樣可作為業(yè)務系統(tǒng) (OA、CRM、ERP、HR、MES)微服務改造與開發(fā)的基礎平臺。
對于API開發(fā)開發(fā)平臺我們采用微服務架構進行開發(fā),開發(fā)底層框架選擇了JeecgBoot,并在該開源框架下做了一些優(yōu)化處理和定制。
而對于API接口服務的開發(fā),
首先來談一下平臺的整體技術架構,該平臺底層框架采用JeecgBot,架構團隊在JeecgBot的基礎之上做過一些優(yōu)化。對于服務的發(fā)布,平臺采用了IBM開源輕量的Node-Red作為API在線發(fā)布的基礎組件,使用FreeMaker開發(fā)模板作為微服務應用生成框架,并集成了DBApi產(chǎn)品的后端所有功能。其他技術框架包括Springboot swagger Mybatis lombok Redis Shiro Maven Vue等。
場景一:數(shù)據(jù)實體生成API的實現(xiàn)
在前面已經(jīng)談到,該API開發(fā)平臺是基于對象建模和數(shù)據(jù)驅(qū)動的,因此核心是里面的元數(shù)據(jù)管理和數(shù)據(jù)實體定義。通過數(shù)據(jù)實體既可以向前生成API接口服務,又可以向后生成后臺的數(shù)據(jù)庫對象和數(shù)據(jù)表。
平臺支持多數(shù)據(jù)源管理,支持連接主流的關系型數(shù)據(jù)庫Mysql/Oracle/Sqlserver.支持連接的在線測試、密碼加密、連接共享等功能。
對象建模能力通過元數(shù)據(jù)管理來實現(xiàn)。元數(shù)據(jù)為最底層的原子數(shù)據(jù)對象,支持對元數(shù)據(jù)的基礎管理能力,同時元數(shù)據(jù)本身又是建立數(shù)據(jù)實體的基礎數(shù)據(jù)依賴,可通過關聯(lián)多個元數(shù)據(jù)來構建多層數(shù)據(jù)實體。
支持通過導入元數(shù)據(jù)的方式來建立多層數(shù)據(jù)實體(目前支持父/子/孫三層實體關系),可根據(jù)選擇的數(shù)據(jù)源連接類型來生成數(shù)據(jù)庫建表的SQL語句,并可直接在平臺上對數(shù)據(jù)源連接的數(shù)據(jù)庫生成數(shù)據(jù)表結構和表依賴關系。
支持數(shù)據(jù)實體快速發(fā)布在線API,在線API發(fā)布支持公有和私有兩種方式,私有API通過配置群組和Token值來限制訪問;通過數(shù)據(jù)實體發(fā)布的API支持對該數(shù)據(jù)實體的新增/修改/刪除/查詢,操作的數(shù)據(jù)會同步讀取或者寫入數(shù)據(jù)實體對應數(shù)據(jù)源連接的庫表中。
在線API發(fā)布后形成Node-Red的流程,通過設計器可對流程進行拖拽修改;對于發(fā)布后的API,可直接在平臺上進行測試。
從上可以看到整個思路完全是基于對象建模驅(qū)動,通過對象建模來定義詳細的實體對象模型和接口契約規(guī)范,一方面是定義的對象模型可以通過配置的數(shù)據(jù)源管理向后臺生成數(shù)據(jù)庫表,一方面是可以直接將對象模型發(fā)布為通用的Rest API接口服務。
同時發(fā)布的內(nèi)容在后臺會生成對應的Node-Red服務編排模板,如果對于發(fā)布的接口需要進行相關的修改和調(diào)整,也相當容易實現(xiàn)靈活定制和配置。
場景一:數(shù)據(jù)庫表和SQL直接發(fā)布API接口
如果你已經(jīng)創(chuàng)建了數(shù)據(jù)庫對象和數(shù)據(jù)表,那么你可以直接將數(shù)據(jù)表發(fā)布為Rest API接口,同時也可以自己定制參數(shù)化SQL語句,并將SQL語句發(fā)布為API接口服務。
對于數(shù)據(jù)庫中已經(jīng)存在的數(shù)據(jù)表,也可直接發(fā)布生成API。
數(shù)據(jù)表API發(fā)布功能除了發(fā)布常用的對數(shù)據(jù)表的新增/修改/刪除/查詢API之外,還發(fā)布對數(shù)據(jù)表進行分頁和條件查詢的API;數(shù)據(jù)表API發(fā)布支持對發(fā)布后API的動態(tài)編排,公有私有配置、API端點的在線測試。
SQL語句發(fā)布為API接口服務
可編寫SQL語句發(fā)布在線API,在線API發(fā)布在當前服務器下,支持動態(tài)SQL的編寫和發(fā)布,支持傳入?yún)?shù)的定義、配置和SQL映射。
2、通過SQL發(fā)布后的API可支持上線/下線操作、公有私有配置、在線API測試操作。
場景四:基于YAML規(guī)范來開發(fā)發(fā)布API:
還有一種場景是首先進行了API接口契約規(guī)范的設計,然后在進行API接口的開發(fā)實現(xiàn)。那么在API契約確定清楚后,實際整個API接口就已經(jīng)可以按規(guī)范進行發(fā)布。
因此我們API快速開發(fā)平臺在功能實現(xiàn)中也集成了第三方API規(guī)范設計器,支持YAML/JSON格式規(guī)范的結構化設計。也集成了Swagger設計器,可靈活編寫API規(guī)范文件。
基于規(guī)范的API在線發(fā)布,可按步驟填寫配置完成API的開發(fā)發(fā)布。支持對規(guī)范入?yún)⑴cSQL參數(shù)的快速映射。
基于規(guī)范在線發(fā)布后的API同樣也會部署到Node-Red中形成流程,支持對發(fā)布后API的動態(tài)編排,公有私有配置、API端點的在線測試。
簡單總結
經(jīng)過上面典型場景描述可以看到,API低代碼開發(fā)平臺圍繞對象驅(qū)動和元數(shù)據(jù)建模為核心,支撐API接口的快速定義,快速發(fā)布能力。同時在已有數(shù)據(jù)庫表和對象的情況下又能夠快速的將數(shù)據(jù)庫表,參數(shù)化SQL預計等發(fā)布為API接口服務。
平臺API開發(fā)設計功能支持Mysql/Oracle/Sqlserver三種類型數(shù)據(jù)庫,并且API加入了數(shù)據(jù)庫事務支持,針對API服務的整體性事務,出錯回滾所有數(shù)據(jù)。在線API的調(diào)用和導出后微服務應用中API的調(diào)用數(shù)據(jù)和返回數(shù)據(jù)完全相同,保證了API在線使用和分布式部署后使用的一致性。在線API調(diào)用日志都已記錄并可供查詢和統(tǒng)計。
同時在平臺我們當前還在進一步完善對于發(fā)布的API接口進行服務編排和能力組裝的能力。該平臺一方面是應用到日常的API接口快速開發(fā),同時也是低代碼開發(fā)平臺的一個重要能力補充。
注:歡迎點贊,歡迎轉(zhuǎn)發(fā)評論,如果大家都感興趣的話我后續(xù)會考慮將該產(chǎn)品開源出來。