go-admin在線開發平臺學習-2[程序結構分析]

緊接着上一篇,本文我們對go-admin下載後的源碼進行分析。

首先對項目所使用的第三方庫進行分析,瞭解作者使用的庫是否是通用的官方庫可以有助於我們更快地閱讀程序。接着對項目的main()方法進行分析,因爲程序使用cli的方式啓動,對cli不同的命令進行分析。基於此倆點開始工作。

go-admin中使用的第三方庫

cobra

強大的cli封裝,支持命令嵌套

cast

簡單安全的類型轉換

casbin

輕量級開源訪問控制框架,採用了元模型的設計思想,支持多種經典的訪問控制方案,如基於角色的訪問控制 RBAC、基於屬性的訪問控制 ABAC 等

gorm

一個神奇的,對開發人員友好的 Golang ORM 庫

sentinel-golang

隨着微服務的流行,服務和服務之間的穩定性變得越來越重要。Sentinel 是面向分佈式服務架構的流量控制組件,主要以流量爲切入點,從流量控制、熔斷降級、系統自適應保護等多個維度來幫助您保障微服務的穩定性。

opentracing-go

分佈式追蹤庫

cron

定時任務庫,支持cron表達式

啓動分析

main.go作爲程序第一個入口文件,main()方法作爲程序入口

使用corboa命令行的方式進行啓動,有多個不同的命令,如下所示

  • 查看系統版本

go-admin version

  • 查看系統配置

go-admin config

  • 服務啓動

go-admin server

  • 數據庫遷移

go-admin migrate

不同的命令有不同的參數進行配置

命令的代碼在根目錄cmd下分文件保存,通過cobra.go作爲統一入口

corbora的使用遵循一個通用的規則。首先創建一個cmd文件夾,在其中定義一個分支命令即是定義一個新的go文件。本項目所使用的方式也類似,每一個命令都 定義一個文件夾,分別管理自己命令的內容,最後通過cobra.go這個上層入口暴露出來。

go-admin version 命令

<img src="https://gitee.com/happlyfox/img/raw/master/image-20210218141425364.png" alt="image-20210218141425364" style="zoom: 80%;" />

定義指令 version,runE執行調用run方法,控制檯打印版本號

go-admin config 命令

<img src="https://gitee.com/happlyfox/img/raw/master/image-20210218141705707.png" alt="image-20210218141705707" style="zoom:80%;" />

與上一個version指令類似,只是多一個輸入參數,用來指定路徑。

init初始化方法定義輸入的flag參數,當執行go-admin config -c 路徑,進入run()方法。

run方法中

1、config.Setup(configYml),將yml配置文件轉爲不同的實體類

2、打印不同的分類內容

go-admin migrate 命令

數據庫遷移指令

基於gorm的migrate方法,定義自己的initdata內容,執行指令完成數據庫遷移工具。

有點類似.net core中的code first模式

go-admin server命令

重點!!!

我們直接進行 server 命令的分析

api文件夾下的server.go文件,對應服務啓動指令

Init方法

init() 方法中是對 命令行參數的解析和初始化路由方法的綁定

以上代碼分爲倆部門看

1、對server 指令的參數綁定

2、route.InitRouter方法添加到AppRouters中,等待後續執行


router.InitRouter方法來源於 /admin/router/initrouter.go文件

initrouter.go中包含多項內容

1、通過配置獲取程序所用引擎,當前只支持gin,後續作者可能會進行添加。

2、通過配置判斷是否使用ssl加密,如果使用""註冊tls處理中間件"

3、讀取配置獲取數據庫類型,連接字符串獲取gorm具體數據庫的接口實現,自定義中間件設置數據庫上下文,集成到gin使用

4、配置Sentinel限流規則

阿里開源的一套東西,需要研究研究

5、通用的系統中間件載入

中間件的業務邏輯包含在 /admin/middleware中

日誌處理 logger.go

作者自己生態的日誌封裝,基於logrus和zap的實現,具體沒看

邏輯是獲取request的請求信息寫入文件日誌,如果包含特定請求寫入數據庫(後期可能會廢棄)

全局異常處理

當出現全局異常的時候捕獲異常,避免程序直接掛掉

緩存

NoCache是一個附加頭的中間件函數。防止客戶端緩存HTTP響應。

意思是客戶端不進行緩存,每次都要的請求向服務器發起

跨域

增加跨域請求頭信息,允許所有請求的跨域

這塊之後應該集成第三方,實現滿足特定需要的跨域

安全

Secure是附加了security的中間件功能

鏈路追蹤

鏈路追蹤是實現每請求的時間線展示嗎還是什麼,這塊還需要研究

6、 jwt認證方式實現

7、註冊業務路由

區分倆種

需要認證的路由,基於上述jwt

不需要認證的路由

命令定義

我感覺這有點像是web core中的依賴注入的概念,首先進行各服務的註冊注入然後啓動服務的某些功能,當然實際上還是有很多不同的,只是突然這麼想到了而已

PreRun

啓動前的初始化配置

讀取配置文件,配置三種全局日誌,分別爲

  • Logger 日誌
  • JobLogger 定時任務日誌
  • RequestLogger 請求日誌

初始化數據庫鏈接,通過配置文件得到不同的數據庫,並執行不同的數據庫驅動

驅動位於/go-admin/common/database/_driver後綴

已集成mysql,pgsql,sqlites的驅動

配置接口控制全局,基於casbin

RunE

啓動配置

判斷是否爲開發環境,增加環境監控

將初始化配置的路由中間件載入

定義服務端口,ssl等信息

啓動定時服務

打印啓動日誌

啓動服務

srv := &http.Server{
        Addr:    config.ApplicationConfig.Host + ":" + config.ApplicationConfig.Port,
        Handler: global.Cfg.GetEngine(),
    }

定義啓動服務的host+port

定義啓動服務的句柄,當前支持的方式是gin

srv.ListenAndServe 啓動服務,打印啓動時的日誌

命令的解析大體如下,接下來針對框架中的細節的進行描述,請等待作者的更新。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章