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

特點：

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

模塊豐富、開箱即用；

簡便易用、易于維護；

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

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

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

完善的本地中文化支持；

設(shè)計為團隊及企業(yè)使用；

模塊：

核心模塊

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

社區(qū)模塊

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

環(huán)境：

OS: Ubuntu 18.04 amd64

CPU: AMD A8-6600K x 4

MEM: 32GB

GO: v1.13.4

更新日志

組件改進

gdb

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

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

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

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

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

ghttp

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

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

改進tracing記錄，將span名稱從query uri改為了route uri，便于查看時更容易聚合。

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

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

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

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

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

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

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

gclient

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

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

gcron

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

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

gerror

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

g

改進DumpJson方法，用于實現(xiàn)對任意變量按照JSON格式進行打印。

gcache

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

gcmd

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

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

gfsnotify

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

glog

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

gmetric

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

gproc

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

改進Signal信號監(jiān)聽實現(xiàn)，允許在運行時增加信號監(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改進內(nèi)部Map遍歷邏輯，提高執(zhí)行性能。

社區(qū)組件

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

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組件，實現(xiàn)了對OpenTelemetry Metric的支持：服務(wù)監(jiān)控告警

改進contrib/nosql/redis組件：

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

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

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

改進contrib/rpc/grpcx組件：

對啟用tracing特性時，安全截斷請求內(nèi)容。

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

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

開發(fā)工具

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

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

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

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

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

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

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