緊接着上一篇,本文我們對go-admin下載后的源碼進行分析。
首先對項目所使用的第三方庫進行分析,了解作者使用的庫是否是通用的官方庫可以有助於我們更快地閱讀程序。接着對項目的main()方法進行分析,因為程序使用cli的方式啟動,對cli不同的命令進行分析。基於此倆點開始工作。
go-admin中使用的第三方庫
強大的cli封裝,支持命令嵌套
簡單安全的類型轉換
輕量級開源訪問控制框架,采用了元模型的設計思想,支持多種經典的訪問控制方案,如基於角色的訪問控制 RBAC、基於屬性的訪問控制 ABAC 等
一個神奇的,對開發人員友好的 Golang ORM 庫
隨着微服務的流行,服務和服務之間的穩定性變得越來越重要。Sentinel 是面向分布式服務架構的流量控制組件,主要以流量為切入點,從流量控制、熔斷降級、系統自適應保護等多個維度來幫助您保障微服務的穩定性。
分布式追蹤庫
定時任務庫,支持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 命令

定義指令 version,runE執行調用run方法,控制台打印版本號
go-admin config 命令

與上一個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 啟動服務,打印啟動時的日志
命令的解析大體如下,接下來針對框架中的細節的進行描述,請等待作者的更新。