數(shù)據(jù)接口設(shè)計方案20190611

數(shù)據(jù)接口1.0設(shè)計方案1.目錄數(shù)據(jù)接口1.0設(shè)計方案2.1.數(shù)據(jù)查詢組件V1.0:前端數(shù)據(jù)訪問流程前端系統(tǒng)（Vue.js/JQuery）數(shù)據(jù)查詢組件HiveMySQL需求描述：采用Vue.js/Jquery等前端工具開發(fā)BI報表時，需要訪問后臺數(shù)據(jù)存儲來獲取數(shù)據(jù)，需要設(shè)計統(tǒng)一標(biāo)準(zhǔn)的數(shù)據(jù)查詢訪問接口，供前端調(diào)用來獲取數(shù)據(jù)存儲端的數(shù)據(jù)。后臺需要支持多數(shù)據(jù)源，支持SQL語句的編輯修改，支持指定參數(shù)的替換，支持增加特定的篩選條件。核心需求：支持靈活定義修改查詢條件具體實現(xiàn)：通過在SQL語句中配置CASEWHEN來支持SQL多分支路徑。3.數(shù)據(jù)接口設(shè)計思路數(shù)據(jù)接口的設(shè)計思路是來自MyBatis，在MyBatis里面，SQL語句是以模板的形式存儲在XML文件中，其中用#if#endif來形成條件判斷，實現(xiàn)動態(tài)的SQL語句，把SQL語句拼裝的工作從JAVA里面解放了出來；采用XML文件存儲SQL模板以后，在使用時實際上還是需要包裝成一個JAVA接口才能進(jìn)行調(diào)用，隨著業(yè)務(wù)的擴(kuò)展，所需要的JAVA代碼也在不斷擴(kuò)張；修改XML文件以后必須停止JAVA服務(wù)器重新啟動，服務(wù)器需要頻繁改動升級和啟動，不利于后續(xù)維護(hù)究竟那些任務(wù)調(diào)用了那些SQL語句，難以進(jìn)行統(tǒng)一監(jiān)控和管理（除非直接修改MyBatis源代碼，難度較大）主要設(shè)計思路：將SQL語句從XML文件遷移到后臺的數(shù)據(jù)庫配置表中存儲，不再額外包裝為JAVA接口，直接返回查詢結(jié)果4.前端數(shù)據(jù)訪問接口設(shè)計&查詢表設(shè)計V1.0查詢序號查詢SQL對應(yīng)Datasource備注1Selectid,namefromt_deptwhereid=$id$datasource23輸入?yún)?shù)名參數(shù)說明樣例qid后臺對應(yīng)的查詢序號(必須）qid:1qargsJson字符串，代表查詢條件（必須）qargs:{id:1}qpage_start分頁開始頁碼（可選）qpage_start:1qpage_size每頁行數(shù)（可選）qpage_size:100sqlconfigSql配置表序號（可選）Sqlconfig:1數(shù)據(jù)訪問接口輸入?yún)?shù)定義后臺SQL定義表輸入?yún)?shù)示例：{qid:1,qargs:{id:100}}SQL模板替換以后的SQL語句：Selectid,namefromt_deptwhereid=1005.前端數(shù)據(jù)訪問接口實現(xiàn)邏輯SQL存儲庫數(shù)據(jù)存儲庫獲取前端的查詢參數(shù)參數(shù)有效性檢查根據(jù)qid檢索SQL語句替換查詢條件組合order和where條件，以及分頁條件數(shù)據(jù)源切換執(zhí)行SQL查詢返回查詢結(jié)果考慮到應(yīng)用后端可能會訪問到多個數(shù)據(jù)源，需要配置數(shù)據(jù)源為動態(tài)數(shù)據(jù)源，并在線程安全的情況下實現(xiàn)切換數(shù)據(jù)源的名稱配置在sql配置表中Where條件通過調(diào)用后臺的數(shù)據(jù)權(quán)限接口獲取，不再從前端獲取6.數(shù)據(jù)接口程序代碼調(diào)用層次圖Controller層Service層JPA層數(shù)據(jù)庫層MySQL配置庫commonquerycontrollerQuerySqlServiceDbSelectOperQuerySqlQuerySql1QuerySql2MySQL