Skip to main content
Version: Latest

大家好啊， GoFrame 框架今天发布了 v2.5.0 正式版本啦！👏👏👏👏

本次版本主要是对已有功能组件以及开发工具上的改进工作。其中：

  • 开发工具新增了 gf gen ctrl 命令，以规范化定义、开发API接口，增加控制器、SDK的代码生成提高开发效率，以解决 Golang 工程开发中接口层面的规范和效率问题，详情请参考： 接口规范-gen ctrl。
  • 原有 gf gen dao 命令新增了 TypeMapping 特性，允许开发者自定义生成的数据表实体对象属性字段的 Golang 类型： 数据规范-gen dao

其他变更内容请参考以下 change log。 Enjoy! 🍺🍺🍺🍺🍺🍺🍺🍺

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

完整代码变更:v2.4.0...v2.5.0，感谢本次所有的贡献开发者：

功能改进​

  1. gdb
    1. 改进 ORM SQL 日志记录，操作的字段按照数据表字段定义顺序进行操作。
    2. 改进 HOOK 方法实现，支持修改 in 参数的 Table 字段后修改执行的表名。
    3. 新增 AllAndCount/ScanAndCount 方法，用于实现便捷的分页查询场景。
    4. 新增 Model.WhereOrNot/WhereOrPrefixNot 条件方法。
  2. gi18n
    1. 改进支持中文（ Unicode）作为转译的键名。
  3. gclient
    1. 新增 Discovery 链式操作方法，用于设置本次请求的服务发现组件。
  4. ghttp
    1. 改进请求 Context 上下文处理，每次 Context 的变更将会影响底层的 http.Request 对象。以支持自定义 HTTP Handler 的数据交互场景。
    2. 新增 Endpoints 配置项支持，用于自定义 Server 的服务注册发现地址，而可以使用当前监听的地址。
  5. goai
    1. 改进参数校验识别，如果参数为必须参数，则在 OpenAPIv3 结果中进行标记。
  6. gsel
    1. 修复 RoundRobin 实现中 Endpoints 更新的锁机制问题。
  7. glog
    1. 新增 TimeFormat 配置，用于自定义日志输出的时间格式： 日志组件-配置管理
    2. 改进 Rotation 实现，支持短运行程序的日志文件切分。
  8. gtag
    1. 新增 GetGlobalEnums 方法，用于获取全局注册的枚举类型。
  9. gutil
    1. 新增 DumpJson 方法，用于将任意类型变量按照 JSON 格式化打印到终端，便于人工阅读。
  10. gvalid
    1. 新增 enums 校验规则，用于实现枚举类型的自动识别和校验： 数据校验-校验规则

社区组件​

  1. 修复 contrib/registry/polaris 组件在多个服务端时的负载均衡问题。
  2. 改进 contrib/drivers/pgsql 在 TableFields 返回的 Index 字段序号统一从 0 开始。
  3. 改进 contrib/nosql/redis 新增用户配置项支持。
  4. 改进 contrib/rpc/grpcx 组件， grpcx.Server 新增 Endpoints 配置项支持，用于自定义服务注册发现的地址。
  5. 新增 contrib/sdk/httpclient 组件，用于本次版本新增的 gf gen ctrl 命令生成的 HTTP SDK 代码文件依赖库。
  6. 新增 contrib/trace/otlpgrpc 及 contrib/trace/otlphttp 组件，用以实现基于 OpenTelemetry 的链路跟踪统一对接组件。

开发工具​

  1. 新增 gf gen ctrl 命令，用于编译 api 定义目录，自动生成规范的 controller、 HTTP SDK 代码： 接口规范-gen ctrl
  2. 改进 gf gen dao 命令，新增 TypeMapping 特性，开发者可自定义数据表字段类型与生成的 Go 实体数据结构属性类型映射，并且可以方便引入第三方包类型（如 decimal 包以支持高精度类型）： 数据规范-gen dao
  3. 改进 gf gen enums 命令，其中的 Prefix 参数改为 Prefixes，以支持多个生成枚举类型的包前缀指定： 枚举维护-gen enums
  4. 改进 gf gen service 命令：
    • 生成的 service 文件中，增加方法注释生成。
    • 当生成的 service 文件中存在 import 冲突时，自动生成 import alias。
  5. 改进命令行封装，暴露 gfcmd.Command 类型，便于开发者可以继承扩展自定义命令行功能。
  6. 改进 gf docker 命令，将构建文件参数设置为非必须（考虑兼容），未来将会只用于 Docker 构建，不再耦合二进制构建功能。如果有完整构建需求，建议未来结合 gf build 功能共同使用。并更新项目工程模板的 make image 命令，使用 gf build+gf docker 命令实现。
  7. 改进 gf init 命令，修复在部分场景下初始化项目覆盖已存在的 .git/.gitignore 目录及文件问题或权限报错问题。
  8. 改进 gf up 命令，修复在部分场景下的框架版本更新问题，以及在 windows 系统下的下载安装问题。
  9. 改进 gf version 命令，修复在部分场景下的框架版本识别问题。
  10. 修复 gf gen pbentity 命令，生成的 proto 文件实体数据结构的 float32/float64/[]byte 类型修改为 float/double/bytes 类型。
  11. 改进开发工具，部分命令可以不用显示配置 importPrefix 参数，如： gf gen dao/service

兼容提示​

  1. ghttp.Request 中的 Context 及 GetCtx 方法返回的 context.Context 继承去掉了 NeverDoneCtx 的嵌套，意味着控制器中默认传递的 ctx 上下文对象完全继承于标准库的 http.Request 中的 ctx。在请求结束时将会自动调用 Done 方法结束掉，不能将该 ctx 传播给需要进一步执行的异步流程。因此，从这个版本开始，使用者可能会遇到以下两个问题：
    • 如果需要传播给 异步流程或者保持和之前逻辑兼容：增加一个中间件，在中间件中调用 r.SetCtx(r.GetNeverDoneCtx()) 全局覆盖后续使用的 ctx 为不会结束的 ctx。

  • 当客户端主动取消请求后，服务端可能会遇到 context canceled 的错误。这个属于正常现象，当客户端不在需要这个请求的结果时会取消请求，这时服务端继续往下执行也没有了意义。如果介意这个错误，可以参考上面的中间件增加 NeverDoneCtx 的处理逻辑，这个时候服务端会忽略客户端的取消请求并继续往下执行。