👋 Hi,朋友们!GoFrame框架v2.2.0版本在今天正式发布啦!

本次版本的最大的看点在于:

  • 重构并改进了开发者最频繁使用的校验组件,使得社区的开发者可以很方便地开发和维护内置校验规则。并且扩增了一些常用校验规则,使得组件内置规则更加丰富强大。
  • 改建了数据库组件接口设计,使得社区开发者可以更简单地新增一个数据库类型的driver,目前框架通过社区组件的方式提供了9种数据库类型的driver实现,满足绝大部分业务项目的需求。尤其是本次版本新增了对国产达梦数据库的支持,未来我们期望社区的开发者能提供更多国产数据库类型的driver实现,贡献给开源社区。
  • 社区组件的丰富,本次主要新增了3种类型的配置中心接口实现,支持Apollo/Polaris/Kubernetes ConfigMapGoFrame框架采用了模块化低耦设计,组件分为框架主库与社区组件。框架主库提供核心通用轻量的基础组件,而社区组件是与框架主库解耦的单独组件包,保证主库通用轻量的同时为框架扩充了更多的能力。
  • 本次版本的代码贡献者超过44位,框架的贡献者达到了107位。感谢大家为社区付出的努力和贡献!💖

Github ChangeLog:https://github.com/gogf/gf/releases/tag/v2.2.0

新特性

  1. 重构校验组件的内置校验规则管理器,增加并支持到了59种常用内置校验规则:数据校验-校验规则
  2. 新增社区组件contrib/config/kubecm,实现基于kubernetes configmap的配置组件Adapter实现:https://github.com/gogf/gf/tree/master/contrib/config/kubecm
  3. 新增社区组件contrib/config/apollo,实现基于apollo配置中心的配置组件Adapter实现:https://github.com/gogf/gf/tree/master/contrib/config/apollo
  4. 新增社区组件contrib/config/polaris,实现基于polaris配置中心的配置组件Adapter实现:https://github.com/gogf/gf/tree/master/contrib/config/polaris
  5. 新增contrib/drivers/dm国产达梦数据库支持:https://github.com/gogf/gf/tree/master/contrib/drivers

主要改进

社区组件

ORM驱动实现

  1. 改进contrib/drivers/pgsql在ORM组件层面支持更多pgsql内置的数据类型。
  2. 改进contrib/drivers/pgsql支持写入操作下的LastInsertId特性。
  3. 改进contrib/drivers/clickhouse支持decimal.Decimal数据类型。
  4. 新增contrib/drivers/dm国产达梦数据库支持:https://github.com/gogf/gf/tree/master/contrib/drivers

注册发现组件

  1. 改进contrib/registry/etcd实现,将日志对象改为接口属性,允许外部注册自定义的日志对象。

配置组件

  1. 新增社区组件contrib/config/kubecm,实现基于kubernetes configmap的配置组件Adapter实现:https://github.com/gogf/gf/tree/master/contrib/config/kubecm
  2. 新增社区组件contrib/config/apollo,实现基于apollo配置中心的配置组件Adapter实现:https://github.com/gogf/gf/tree/master/contrib/config/apollo
  3. 新增社区组件contrib/config/polaris,实现基于polaris配置中心的配置组件Adapter实现:https://github.com/gogf/gf/tree/master/contrib/config/polaris

数据库ORM

  1. 统一不同数据库类型下,单行字符串配置管理格式,并兼容支持已有不同数据库类型特定的配置格式:ORM使用配置
  2. 改进接口设计,简化driver实现逻辑,后续新增更多的数据库driver支持更加简便。
  3. 新增ToSQL方法,用于将ORM操作生成可供调试的SQL语句,并不真正执行SQL
  4. 新增CatchSQL方法,用于通过闭包方法获取内部执行的SQL语句列表。
  5. 废弃Core对象中的GetStruct/GetStructs方法,统一使用Scan方法操作,以提高易用性。
  6. 数据库对象使用日志对象改为接口属性,允许外部注册自定义的日志对象。
  7. 新增ExtraProtocol配置,用于设置额外的配置参数以及链接协议,默认通过Link配置自动解析。
  8. 去掉Filtered接口,采用默认实现,简化复杂度、提高易用性。
  9. 新增ConvertValueForLocalCheckLocalTypeForField接口,用于自定义的数据类型转换及数据类型获取,并提供默认实现。
  10. 新增ClearTableFields方法,用于清理特定数据表的数据结构缓存:ORM高级特性-字段映射
  11. 新增ClearTableFieldsAll方法,用于清理当前数据库对象所有的数据表数据结构缓存:ORM高级特性-字段映射
  12. 新增ClearCache方法,用于清理特定数据表的所有查询缓存:ORM链式操作-查询缓存
  13. 新增ClearCacheAll方法,用于清理当前数据库对象所有的查询缓存:ORM链式操作-查询缓存
  14. 其他一些改进。

编解码组件

  1. gcompress
    1. 新增GzipPathWriter方法没用与将特定路径下的文件压缩到指定的io.Writer中。
    2. 新增ZipPathContent方法,用于使用zip算法打包压缩文件/目录并返回字节内容。
  2. gjson
    1. ContentTypeJson等字符串参数调整为ContentType类型

错误处理

  1. 增加命令行参数--gf.gerror.briefGF_GERROR_BRIEF环境变量开关,控制是否在错误堆栈打印时过滤框架堆栈:错误处理-其他特性
  2. 其他一些细节改进。

网络组件

  1. ghttp
    1. 新增常用中间件MiddlewareJsonBody用于校验请求Body是否JSON格式。
    2. 新增GetListenedAddress方法,用于获取HTTP Server在指定:0监听端口时系统随机分配的监听地址。
    3. 当服务端执行出错时,修改返回HTTP状态码为500
  2. gtcp
    1. 新增GetListenedAddress/GetListenedPort方法,用于获取TCP Server在指定:0监听端口时系统随机分配的监听地址/端口。
  3. gudp
    1. 新增GetListenedAddress/GetListenedPort方法,用于获取UDP Server在指定:0监听端口时系统随机分配的监听地址/端口。
  4. goai
    1. 生成接口文档时,支持内嵌结构体定义的属性。
    2. 去掉接口文档中重复的参数说明,特别是在URLBody中存在相同参数时。
  5. gtrace
    1. 改进WithTraceID方法的错误提示为更明确的信息。
    2. 新增WithUUID方法,用于将标准的UUID转换为OpenTelemetryTraceID

系统组件

  1. gcfg
    1. 调整Available接口方法定义,将resource参数改为非必须参数。
  2. gcron
    1. 针对定时任务延迟的场景,增加时间差异计算逻辑,尽可能减少对定时任务的影响。
  3. gctx
    1. 新增跨进程的链路跟踪支持。
    2. 新增GetInitCtx/SetInitCtx方法,用于main包及包init包初始化方法执行时的context获取和设置。
  4. glog
    1. 新增ILogger接口定义,用于跨组件使用日志组件时的接口化解耦。
    2. 其他细节改进。
  5. gres
    1. 资源File对象新增Export方法,用于将该对象关联的资源导出到指定的磁盘路径。
  6. gstructs
    1. RecursiveOptionint类型改进为自定义类型,并调整对应的方法参数定义。

文本处理

  1. 新增gstr.IsGNUVersion方法,用于判断给定的字符串是否满足GNU版本规则。

工具方法

  1. gconv
    1. 改进对NaN特殊字符串的int64/uint64转换支持。
  2. gutil
    1. 新增GetOrDefaultStr/GetOrDefaultAny方法,用于默认值和非必须参数的便捷处理。
  3. gvalid
    1. 重构内置校验规则管理器,使得新增一个内置校验非常简便。
    2. 增加并支持到了59种常用内置校验规则:数据校验-校验规则

功能修复

  1. 修复garray/gmap/gset/glist/gtype/gvar在容器对象为nil场景下DeepCopypanic问题。
  2. 修复gtime在对象为nil场景下DeepCopypanic问题。
  3. 修复数据库ORM链式操作Group方法在给定多个排序条件时的覆盖问题。
  4. 修复HTTP ServerJSON格式字符串返回时的内容重复输出问题。
  5. 修复gstr.Nl2Br方法在部分场景下由于逻辑判断引起的数组访问越界问题。
  6. 修复查询数据表字段信息时表名为空场景的错误打印问题。
  7. 修复Req对象属性为*gjson.Json类型的参数接收问题。

开发工具

  1. 改进gen dao命令,增加clear参数,用于自动清理目标数据库中不存在的本地数据模型Go文件:数据规范-gen dao
  2. 改进gen service命令:模块规范-gen service
    1. 按照业务模块对结构体对象生成的接口进行整合。
    2. 增加clear参数,用于自动清理在logic没有对应的接口代码及文件。
    3. 其他一些细节改进。
  3. 改进run命令,增加自定义的程序运行参数。