鯨品堂｜靈犀平臺—API的全可視化開發

2021-10-27 873
作為一個程序猿，接手一個老項目時，經常遇到無文檔無注釋，此時不提有多崩潰；作為一個設計人員，只能等功能驗收時才能知道邏輯是否符合設計，若錯誤會造成大量返工和資源浪費；作為業務人員，只能等軟件交付后才能驗證業務需求是否正確實現，若錯誤又要大大延長需求交付周期；作為一個新人，要學習很多技術棧和編程知識才能加入到項目開發中，加上技術迭代這么快，開發門檻就更高了。

那我們是繼續這樣負重前行，還是尋求改變？能否尋求一種大家都更簡單更高效的模式，讓大家都可以成為開發者。

API開發的痛點分析


浩鯨科技每年要交付幾百個項目，根據項目不同，會涉及到多個產品研發和集成，過程中我們經常遇到API開發的一些問題，主要如下：


API無具體規范：導致溝通、聯調、接入成本巨大；


API開發無法很好的銜接，開發是把設計文檔轉譯為代碼；


API文檔不全，導致后期開發維護工作量巨大；


API技術棧很難標準化，多模塊集成時經常遇到技術棧版本沖突；


API開發門檻高，需要懂語言、微服務、分布式技術；


API的質量不受控，基本依賴于開發人員技術能力。


總體上，API開發體驗還是比較差，開發門檻較高、效率較低、質量偏低。這種模式下，業務開發無法聚焦于業務邏輯開發，很大精力要關注技術問題，導致業務開發效率大打折扣。

隨研發精進，浩鯨科技逐步沉淀了自己的技術框架、業務框架和云原生技術底座，解決了API開發部分技術棧的問題，無需從0開始研發；今年又發布了靈犀平臺，解決了API研發主要痛點。

API全可視化開發


浩鯨科技經過長期研發沉淀和抽象，最終形成了靈犀快速開發平臺。靈犀快速開發平臺是一個面向“公民開發者”的開發平臺，通過標準化資產庫+技術開放體系+可視化開發工具快速構建軟件應用?！肮耖_發者”可以讓更多人參與到開發中，可以讓沒有編程經驗或者少量編程經驗的人參與開發，可以讓業務咨詢師、產品經理、業務架構師、測試人員、項目經理、運維人員都可以成為開發人員。
圖片關鍵詞
圖片關鍵詞

上圖是靈犀平臺的一個邏輯功能架構圖。靈犀快速開發平臺底層基于云原生技術框架，開發出的應用天然具備云原生特性，平臺提供了設計開發平臺、運行引擎平臺、基礎管理平臺、資產管理平臺。

靈犀平臺提供了API的全程可視化研發，從API契約設計、API業務建模、API編程、API調測、API連接外部能力，助力API開發實現高效、低門檻、高質量的API開發，業務開發可以聚焦業務邏輯開發。

1
API契約可視化管理

由于API缺乏規范，導致溝通、聯調和接入成本很高。尤其是涉及眾多子系統、子模塊進行集成聯調時候，經常由于個別模塊接口的變化導致集成失敗，很多模塊重復返工，浪費了大量資源。

靈犀平臺提供API的契約管理，提供了API契約設計、API契約查詢、API在線撥測。通過API契約化，研發有了共同語言，免去溝通、聯調和接入的痛點。


API契約設計：靈犀平臺提供API契約設計，設計人員可以通過可視化設計工具定義API契約，可以定義好API訪問路徑 、出入參數、調用樣例等。后續開發時候遵循契約進行開發。


圖片關鍵詞



API契約查詢：靈犀平臺提供了API市場，所有發布的API都在市場中，在API市場中可以查詢到所有開放的API契約，聯調、接入時候可以按API市場定義契約。


API在線撥測：靈犀平臺API市場還提供了API撥測功能，提供樣例直接調用API，可以清晰看到出入參結果，清晰知道入參填寫是否正確，免去溝通、聯調，讓接入者、使用者有更直接的體驗。


圖片關鍵詞


2
API可視化業務建模

靈犀平臺提供了API的可視化業務建模，可以創建業務模型，而后在業務模型基礎上創建業務對象。


業務建模：靈犀平臺提供靈活多樣的業務建模能力，可以根據實際場景選擇不同的建模方式。若是新項目，可以直接在靈犀平臺上手工建模，或者通過SQL自動創建模型；若是老項目，可以把模型批量導入。


行業模型庫：浩鯨還沉淀了系列行業模型，業務建模時可以直接復用已有的行業模型，減少建模工作量。


圖片關鍵詞



業務對象設計：業務建模主要是完成數據的物理存儲，業務對象提供模型如何跟頁面、服務的對接。業務對象設計時候可以定義相關對象關系、對象屬性顯示規則、對象脫敏設置、對象屬性值設置等能力。


3
API可視化編程

傳統開發方式，對于需求分析和設計后，再由開發編碼轉換為實現。在編碼階段，由于編程知識和技術門檻，多數需求和設計都很難接入；對于API開發人員來說，要熟悉業務邏輯，還要熟悉各種技術棧，門檻比較高，而且代碼質量完全隨開發人員技能和心情。

靈犀平臺對常用的程序控制邏輯、數據訪問、API集成、規則集成、業務流程集成、代碼段或函數復用進行了抽象和封裝，形成了幾十個常用組件，實現了API的可視編程。

靈犀平臺提供API可視化編程、API處理邏輯，按流程可視化展示、API處理邏輯瀏覽和查看、豐富的API組件供對接數據庫、鏈接外部能力、自定義代碼。
圖片關鍵詞
圖片關鍵詞


API處理邏輯可視化：編排出的API處理邏輯是一個可視化的流程圖，整個API的處理邏輯一目了然。從需求人員和設計人員維度，通過流程圖很容易知道需求在開發落地中業務處理邏輯是否有問題。從客戶角度，通過流程圖可以掌握業務的實際處理邏輯，清晰了解到業務邏輯是否正確，實現知識的自主掌控。對于后續接手人員來說，代碼即文檔，能夠快速上手，免去鉆研代碼的痛苦。


API拖拽式開發：點擊API處理流程，可以在流程上增加處理環節，提供20+的組件供選擇。包括我們編程中使用的程序控制邏輯、數據操作、訪問外部服務、集成規則、集成業務流程、集成函數或自定義代碼段、通知等組件?？梢詽M足我們絕大部分API的開發訴求。


API處理邏輯查看：API業務處理邏輯開發完后，提供查詢回看功能?？梢栽俨樵冋w處理邏輯是否正確，每個環節的出入參映射是否正確。


豐富的組件：

    • 邏輯組件：提供了我們編程常用的程序控制結構，有條件結構、循環結構；條件結構提供單條件（if ）組件、分支判斷組件（if … else ）兩種；循環結構提供循環組件（loop ）和循環跳出組件（break）；還提供了過程變量的定定義。

    • 數據組件：數據組件提供了對數據庫操作的封裝，可以對查詢、更新、自定義查詢等關鍵邏輯進行封裝。提供了API編程中要對數據庫可視化能力。通過數數據訪問組件，可以根據業務要求快捷對數據進行操作。

      圖片關鍵詞


    • 服務組件：編程過程免不了要調用外部系統或其他模塊的服務，外部服務組件提供了外部服務訪問的封裝，拖拽外部服務組件就可以一鍵訪問外部服務，無無需任何代碼。

    • 規則組件：規則組件實現跟規則中心對接，針對一些復雜業務邏輯需要通過業業務規則來控制時，可以使用規則組件來調用規則中心的能力，復用規則的擴擴展能力實現業務邏輯的規則化。

    • 流程組件：流程組件實現了調用流程平臺已有流程的能力，若在API邏輯中要引用流程，可以使用流程組件調用流程平臺的流程啟動、流程流轉等能力實現現對業務流程的控制，滿足業務處理中跟業務流程的關聯互動。

    • 工具箱組件：若API處理邏輯中還需要需要做一些特殊處理，需要單獨寫代碼實現，工具箱組件提供一些自定義函數庫供復用，可以直接使用工具箱的函數數庫進行開發，也可以開發自己編寫擴展的函數直接集成到API處理環節中。


4
API在線調測

可視化開發可以有效降低API開發門檻，API開發完后，如何驗證API處理邏輯是否正確？靈犀平臺提供在線調測功能，提供可視化調測，輕松搞定API處理邏輯的正確性。


API在線調測：API開發完后，點擊服務調測功能，調測功能提供API各環節處理鏈，提供每個環節的出入參、處理耗時、處理詳細日志信息。通過調測結果，可以清晰明了看到每個環節的出入參值，可以知道對于環節參數映射是否存在問題。


圖片關鍵詞



圖片關鍵詞函數調測：API開發過程的工具箱組件可以提供自定義函數管理，對于自定義的函數也提供在線測試功能?？梢暂斎牒瘮等雲瘮颠M行測試，驗證函數返回是否符合開發人員預期。


5
API能力連接器

API開發中，我們可能要與很多外部平臺、外部模塊對接，而由于各種歷史原因，各個平臺的API的技術棧還會存在差異，對于比較老些的系統，比如WebService，對于較新的系統，基本采用微服務架構，常用的微服務技術棧有Dubbo、SpringCloud、gRPC等，若每個API編程都需要去對接不同的技術棧，工作量會很大，對開發人員要求也會很高。

靈犀平臺提供API能力連接器，可以接入豐富的服務類型，面向開發者可以統一轉換為HTTP/HTTPS服務，免去開發集成復雜多樣的痛苦。

目前靈犀平臺API能力連接器可以接入SOAP、Dubbo、NACOS、HTTP、gRPC、數據庫等不同類型的API能力。

總結和展望


我們回顧下，通過犀平臺進行API開發跟通過其他模式開發比對：


從0開始開發使用框架開發使用靈犀平臺開發
API設計無第三方工具全可視化（契約、業務建模、業務邏輯）
API編程直接編碼直接編碼可視化編程
API技術難度高（要關注引入的所有技術）中（框架解決了部分技術棧）低（20+組件，開發聚焦業務）
API調測難度復雜中等簡單（在線調測）
API集成難難（協調、溝通）簡單（API市場上訂閱使用）
開發者門檻高（全編碼）中偏高（絕大部分編碼）低（極少編碼）
開發效率低中高
代碼質量偏低（完全依賴開發）中等偏低（大部分依賴開發）高（代碼絕大部分自動生成）

我們總結下，通過靈犀平臺開發API的好處：


高效率：業務開發聚焦業務邏輯，無需關注技術；


低成本：通過復用組件和能力，交付周期更短成本更低；通過API處理邏輯可視化展示，降低了后續開發維護成本；


低門檻：無需編程經驗，可以全民開發；


高質量：代碼基本是自動生成，質量內建；


全程可視化：設計、編碼、調測都提供可視化工具；


自主掌控：API處理邏輯以流程圖可視化展示，對客戶可以實現自主掌控。


靈犀平臺今年才發布，在整個平臺上，在API開發上還有很長的路要走，在API開發能力上還需繼續演進：


API開發的架構：API開發發布后，采用Serverless架構承載；API開發只關注業務，不用關注資源、運行和運維；


API的能力連接器豐富：需要進一步豐富API的能力連接器，提供更多標準化能力，實現更豐富的API業務場景開發；包括消息服務、緩存服務、云能力服務等；


API組件豐富：提供更豐富的API組件，滿足更豐富的API業務場景；包括文件處理類、協議轉換等。

關于我們

產品與解決方案

成功故事

媒體中心


官方微信公眾號

浩鯨云計算科技股份有限公司 版權所有 2003-2023

蘇ICP備10224443號-6       蘇公網安備 32011402011374號

亚洲精品免费视频_热99re6久精品国产首页青柠_精品国产专区91在线_亚洲美洲欧洲偷拍片区