大家好,GoFrame
框架今天发布了v2.7.0
正式版本啦! 👏👏👏👏👏👏👏👏👏
本次版本最大的看点是提供了metric
监控组件,主库提供了接口化的metric
设计,社区组件提供了基于OpenTelemetry
的metric
接口实现。该特性在默认情况下是关闭的,只有在引入具体的接口实现或者社区实现时才会默认启用。当前版本同时提供了HTTP Client&Server
的监控指标实现,其他组件的监控指标将在后续版本中陆续提供。详情请参考文档:服务监控告警
同时,在本次版本中实现了对dm/mssql/oracle/pgsql/sqlite
数据库的Save
操作支持,感谢社区小伙伴 https://github.com/oldme-git 💖。
此外,值得一提的是,在本次版本中,我们对gcron
定时任务组件对秒级字段增加了忽略符号#
的特性,用于将6
段式的cron pattern
转换为类似于5
段式的linux crontab pattern
功能,用于解决秒级粒度下由于延迟引起的任务执行不准确问题:定时任务-表达式
由于本次版本变更内容较多,以下中文介绍一些较为重要的改进点,详细的ChangeLog
请参考:https://github.com/gogf/gf/releases/tag/v2.7.0
完整代码变更请参考:https://github.com/gogf/gf/compare/v2.6.0...v2.7.0
感谢所有参与本次版本的贡献开发者们💖!
gdb
Stats
接口定义及实现,用于获取当前数据库orm
对象维护的连接池信息:ORM高级特性-连接池状态FormatUpsert
接口定义及实现,用于不同数据库类型实现写入/更新操作,即Save
操作。SqlType
类型,并将已有的sql type
类型定义从string
类型改为了SqlType
类型。Model.OnConflict
方法,用于实现部分数据库类型当字段唯一键冲突时的更新策略,特别是实现Save
操作。ClearTableFieldsAll
方法失效的问题。ghttp
MiddlewareNeverDoneCtx
中间件,开发者可以选择使用,避免客户端取消请求时服务端收到的context cancel
问题:常见问题http server
的监控指标实现,默认关闭不会影响性能,只有在开启metrics
特性时才会自动开启:HTTPServer-监控指标tracing
记录,将span
名称从query uri
改为了route uri
,便于查看时更容易聚合。Request
对象中的EnterTime
及LeaveTime
属性类型,从int64
改为了*gtime.Time
类型。WebSocket
方法标记废弃,将会在未来的大版本中去掉,也会去掉http server
对websocket
的内嵌耦合支持。未来建议通过其他的websocket
开源组件结合http server
一起使用,更加解耦灵活。Request Body
默认可重复读取的问题引发的大文件上传占用内存问题。StartPProfServer
方法的pattern
参数失效问题。Request.ServeFileDownload
方法新增Access-Control-Expose-Headers Header
返回,以支持ajax
文件请求。SwaggerUITemplate
配置项,用于快捷配置SwaggerUI
页面的HTML
内容。http server
启动路由打印时不再打印内置的中间件。gclient
http
请求均会强制走服务发现的域名解析问题。http client
的监控指标实现,默认关闭不会影响性能,只有在开启metrics
特性时才会自动开启:HTTPClient-监控指标gcron
#
,对cron pattern
中的秒字段进行占位,表示忽略秒字段,用于将6
段式的cron pattern
转换为5
段式的linux crontab pattern
:定时任务-表达式2 * * * * *
),当底层时间出现不准确时可能引发两次任务执行。gerror
gerror.HasCode
方法递归逻辑失效的问题。g
DumpJson
方法,用于实现对任意变量按照JSON
格式进行打印。gcache
Cache
对象引发的goroutine
过多问题。gcmd
RunWithSpecificArgs
方法,用于使用自定义的arguments
运行命令对象。gfsnotify
gfsnotify
对象关闭时可能引发的panic
问题。glog
rotate
特性对gz
后缀日志压缩文件的重复rotate
问题。gmetric
gmetric
组件,采用了解耦设计,只有接口定义和Noop
的实现,真实的实现在社区组件中。只有引入具体的实现才会真实开启metric
特性:服务监控告警gproc
windows
下可能失败的问题。Signal
信号监听实现,允许在运行时增加信号监听处理方法。gview
os.Getwd
方法执行失败引起的健壮性问题。gconv
json.RawMessage
支持接受slice
类型的参数转换。MapDeep
内部转换缺失Deep
参数引发的递归转换失败问题。MapRange
改进内部Map
遍历逻辑,提高执行性能。contrib/drivers
数据库组件的改进:contrib/drivers/dm
组件新增对Save
操作的支持。contrib/drivers/mssql
组件新增对Save
操作的支持。contrib/drivers/oracle
组件新增对Save
操作的支持,并修复写入参数不支持gdb.Raw
类型的问题。contrib/drivers/pgsql
组件新增对Save
操作的支持。contrib/drivers/sqlite
组件新增对Save
操作的支持。contrib/drivers/sqlitecgo
组件新增对Save
操作的支持。contrib/metric/otelmetric
组件,实现了对OpenTelemetry Metric
的支持:服务监控告警contrib/nosql/redis
组件:SentinelUsername
及SentinelPassword
参数配置,以扩展对Redis Sentinel
模式的支持:Redis-配置管理Redis
接口实现,开发者可以灵活自定义扩展、覆盖社区组件对象redis.Redis
类型的实现:Redis-接口化设计contrib/registry/etcd
组件,允许开发者配置etcd
链接的校验信息。contrib/rpc/grpcx
组件:tracing
特性时,安全截断请求内容。logger
配置项的支持,允许在配置文件中通过logger
配置项配置grpc server
的日志对象:服务端配置contrib/trace/otlphttp
及contrib/trace/otlpgrpc
组件,修复在短进程场景下正常ShutDown
仍可能会出现的trace
数据丢失问题。gen dao
生成的entity
源文件,增加orm
标签,以提高数据库查询结果转换到entity
对象的效率。gen service
命令,修复生成的源码文件中,方法顺序不一致问题。build
命令,将生成的二进制文件存放目录path
参数的默认值从./temp
改为了.
即当前目录,以解决该参数自定义失效的问题。init
命令,新增-module/g
参数,用于在初始化项目时显式指定go module
名称。gen dao
在多个数据库生成配置下,使用clear
参数时删除已生成的dao
源文件的问题。gen pbentity
命令,使用自定义的jsonCase
参数无效的问题。run
命令的-w
指定监听目录参数失效的问题。