GF(Go Frame)是一款模塊化、高性能、生產(chǎn)級的Go基礎(chǔ)開發(fā)框架。 實(shí)現(xiàn)了比較完善的基礎(chǔ)設(shè)施建設(shè)以及開發(fā)工具鏈，提供了常用的基礎(chǔ)開發(fā)模塊， 如：緩存、日志、隊(duì)列、數(shù)組、集合、容器、定時(shí)器、命令行、內(nèi)存鎖、對象池、 配置管理、資源管理、數(shù)據(jù)校驗(yàn)、數(shù)據(jù)編碼、定時(shí)任務(wù)、數(shù)據(jù)庫ORM、TCP/UDP組件、進(jìn)程管理/通信等等。 并提供了Web服務(wù)開發(fā)的系列核心組件，如：Router、Cookie、Session、Middleware、服務(wù)注冊、模板引擎等等， 支持熱重啟、熱更新、域名綁定、TLS/HTTPS、Rewrite等特性。

特點(diǎn)：

模塊化、松耦合設(shè)計(jì)；

模塊豐富、開箱即用；

簡便易用、易于維護(hù)；

高代碼質(zhì)量、高單元測試覆蓋率；

社區(qū)活躍，大牛謙遜低調(diào)脾氣好；

詳盡的開發(fā)文檔及示例；

完善的本地中文化支持；

設(shè)計(jì)為團(tuán)隊(duì)及企業(yè)使用；

模塊：

核心模塊

GoFrame提供了一些基礎(chǔ)的、常用的模塊，簡單、易用和輕量級，并保持極少的外部依賴，這些模塊由gf主倉庫細(xì)致維護(hù)。

社區(qū)模塊

社區(qū)模塊主要由社區(qū)貢獻(xiàn)并維護(hù)，大部分也是由gf主倉庫的貢獻(xiàn)者提供及維護(hù)，存放于gogf空間下，與gf主倉庫處于同一級別。有的社區(qū)模塊是從gf主倉庫中剝離出來單獨(dú)維護(hù)的模塊，這些模塊并不是特別常用，或者對外部依賴較重。

環(huán)境：

OS: Ubuntu 18.04 amd64

CPU: AMD A8-6600K x 4

MEM: 32GB

GO: v1.13.4

更新日志

組件改進(jìn)

gdb

新增Stats接口定義及實(shí)現(xiàn)，用于獲取當(dāng)前數(shù)據(jù)庫orm對象維護(hù)的連接池信息：ORM高級特性-連接池狀態(tài)

新增FormatUpsert接口定義及實(shí)現(xiàn)，用于不同數(shù)據(jù)庫類型實(shí)現(xiàn)寫入/更新操作，即Save操作。

新增SqlType類型，并將已有的sql type類型定義從string類型改為了SqlType類型。

新增Model.OnConflict方法，用于實(shí)現(xiàn)部分?jǐn)?shù)據(jù)庫類型當(dāng)字段唯一鍵沖突時(shí)的更新策略，特別是實(shí)現(xiàn)Save操作。

修復(fù)ClearTableFieldsAll方法失效的問題。

ghttp

新增MiddlewareNeverDoneCtx中間件，開發(fā)者可以選擇使用，避免客戶端取消請求時(shí)服務(wù)端收到的context cancel問題：常見問題

新增http server的監(jiān)控指標(biāo)實(shí)現(xiàn)，默認(rèn)關(guān)閉不會影響性能，只有在開啟metrics特性時(shí)才會自動開啟：HTTPServer-監(jiān)控指標(biāo)

改進(jìn)tracing記錄，將span名稱從query uri改為了route uri，便于查看時(shí)更容易聚合。

改進(jìn)Request對象中的EnterTime及LeaveTime屬性類型，從int64改為了*gtime.Time類型。

將WebSocket方法標(biāo)記廢棄，將會在未來的大版本中去掉，也會去掉http server對websocket的內(nèi)嵌耦合支持。未來建議通過其他的websocket開源組件結(jié)合http server一起使用，更加解耦靈活。

修復(fù)由于Request Body默認(rèn)可重復(fù)讀取的問題引發(fā)的大文件上傳占用內(nèi)存問題。

修復(fù)StartPProfServer方法的pattern參數(shù)失效問題。

文件下載方法Request.ServeFileDownload方法新增Access-Control-Expose-Headers Header返回，以支持ajax文件請求。

服務(wù)配置新增SwaggerUITemplate配置項(xiàng)，用于快捷配置SwaggerUI頁面的HTML內(nèi)容。

http server啟動路由打印時(shí)不再打印內(nèi)置的中間件。

gclient

修復(fù)在開啟服務(wù)發(fā)現(xiàn)的情況下，所有的http請求均會強(qiáng)制走服務(wù)發(fā)現(xiàn)的域名解析問題。

新增http client的監(jiān)控指標(biāo)實(shí)現(xiàn)，默認(rèn)關(guān)閉不會影響性能，只有在開啟metrics特性時(shí)才會自動開啟：HTTPClient-監(jiān)控指標(biāo)

gcron

新增忽略符號#，對cron pattern中的秒字段進(jìn)行占位，表示忽略秒字段，用于將6段式的cron pattern轉(zhuǎn)換為5段式的linux crontab pattern：定時(shí)任務(wù)-表達(dá)式

修復(fù)在確定的秒級任務(wù)場景中（例如2 * * * * *），當(dāng)?shù)讓訒r(shí)間出現(xiàn)不準(zhǔn)確時(shí)可能引發(fā)兩次任務(wù)執(zhí)行。

gerror

修復(fù)gerror.HasCode方法遞歸邏輯失效的問題。

g

改進(jìn)DumpJson方法，用于實(shí)現(xiàn)對任意變量按照J(rèn)SON格式進(jìn)行打印。

gcache

修復(fù)大量創(chuàng)建Cache對象引發(fā)的goroutine過多問題。

gcmd

新增RunWithSpecificArgs方法，用于使用自定義的arguments運(yùn)行命令對象。

修復(fù)部分場景下由于參數(shù)結(jié)構(gòu)體名稱和結(jié)構(gòu)體標(biāo)簽名稱沖突引發(fā)的參數(shù)丟失問題。

gfsnotify

修復(fù)gfsnotify對象關(guān)閉時(shí)可能引發(fā)的panic問題。

glog

修復(fù)rotate特性對gz后綴日志壓縮文件的重復(fù)rotate問題。

gmetric

新增gmetric組件，采用了解耦設(shè)計(jì)，只有接口定義和Noop的實(shí)現(xiàn)，真實(shí)的實(shí)現(xiàn)在社區(qū)組件中。只有引入具體的實(shí)現(xiàn)才會真實(shí)開啟metric特性：服務(wù)監(jiān)控告警

gproc

修復(fù)進(jìn)程參數(shù)解析在windows下可能失敗的問題。

改進(jìn)Signal信號監(jiān)聽實(shí)現(xiàn)，允許在運(yùn)行時(shí)增加信號監(jiān)聽處理方法。

gview

修復(fù)由于os.Getwd方法執(zhí)行失敗引起的健壯性問題。

gconv

json.RawMessage支持接受slice類型的參數(shù)轉(zhuǎn)換。

修復(fù)MapDeep內(nèi)部轉(zhuǎn)換缺失Deep參數(shù)引發(fā)的遞歸轉(zhuǎn)換失敗問題。

使用MapRange改進(jìn)內(nèi)部Map遍歷邏輯，提高執(zhí)行性能。

社區(qū)組件

社區(qū)contrib/drivers數(shù)據(jù)庫組件的改進(jìn)：

contrib/drivers/dm組件新增對Save操作的支持。

contrib/drivers/mssql組件新增對Save操作的支持。

contrib/drivers/oracle組件新增對Save操作的支持，并修復(fù)寫入?yún)?shù)不支持gdb.Raw類型的問題。

contrib/drivers/pgsql組件新增對Save操作的支持。

contrib/drivers/sqlite組件新增對Save操作的支持。

contrib/drivers/sqlitecgo組件新增對Save操作的支持。

新增contrib/metric/otelmetric組件，實(shí)現(xiàn)了對OpenTelemetry Metric的支持：服務(wù)監(jiān)控告警

改進(jìn)contrib/nosql/redis組件：

新增SentinelUsername及SentinelPassword參數(shù)配置，以擴(kuò)展對Redis Sentinel模式的支持：Redis-配置管理

改進(jìn)Redis接口實(shí)現(xiàn)，開發(fā)者可以靈活自定義擴(kuò)展、覆蓋社區(qū)組件對象redis.Redis類型的實(shí)現(xiàn)：Redis-接口化設(shè)計(jì)

改進(jìn)contrib/registry/etcd組件，允許開發(fā)者配置etcd鏈接的校驗(yàn)信息。

改進(jìn)contrib/rpc/grpcx組件：

對啟用tracing特性時(shí)，安全截?cái)嗾埱髢?nèi)容。

新增對logger配置項(xiàng)的支持，允許在配置文件中通過logger配置項(xiàng)配置grpc server的日志對象：服務(wù)端配置

改進(jìn)contrib/trace/otlphttp及contrib/trace/otlpgrpc組件，修復(fù)在短進(jìn)程場景下正常ShutDown仍可能會出現(xiàn)的trace數(shù)據(jù)丟失問題。

開發(fā)工具

改進(jìn)gen dao生成的entity源文件，增加orm標(biāo)簽，以提高數(shù)據(jù)庫查詢結(jié)果轉(zhuǎn)換到entity對象的效率。

改進(jìn)gen service命令，修復(fù)生成的源碼文件中，方法順序不一致問題。

改進(jìn)build命令，將生成的二進(jìn)制文件存放目錄path參數(shù)的默認(rèn)值從./temp改為了.即當(dāng)前目錄，以解決該參數(shù)自定義失效的問題。

改進(jìn)init命令，新增-module/g參數(shù)，用于在初始化項(xiàng)目時(shí)顯式指定go module名稱。

修復(fù)gen dao在多個(gè)數(shù)據(jù)庫生成配置下，使用clear參數(shù)時(shí)刪除已生成的dao源文件的問題。

修復(fù)gen pbentity命令，使用自定義的jsonCase參數(shù)無效的問題。

修復(fù)run命令的-w指定監(jiān)聽目錄參數(shù)失效的問題。