我们很高兴宣布GoFrame迎来了v2.8.0正式版本的发布！ 本次更新带来了重要的改进和新特性，使GoFrame在开发效率、执行性能、稳定性和扩展性方面取得了显著提升。

版本亮点

  1. 兼容性更新

    • GoFrame v2.8.0要求最低 Golang 版本为 1.20，提供更高效的性能和稳定性。
    • container/gring 组件已被废弃，同时 contrib/trace/jaeger 组件从源码仓库移除，简化了依赖管理。

  2. 组件改进

    • database/gdb模块现在支持created_at/updated_at/deleted_at整型时间戳字段、unix socket连接、time/year 字段类型，并增加了 Model.Exist 方法，显著提升了数据库操作的灵活性和效率。
    • util/gconv组件使用类型缓存提升转换性能，针对复杂数据类型的转换性能提升约300%。
    • net/ghttp 和 net/gudp 网络服务组件优化了参数配置和请求处理逻辑，为用户提供更简洁的开发体验。

  3. 开发工具升级

    • gf init 命令支持生成单仓多应用项目结构。
    • gf gen ctrl、gf gen dao 和 gf run 等命令的优化，进一步增强了代码生成的灵活性与执行效率，简化了项目搭建流程。

  4. 社区组件支持

    • 为 contrib/drivers/mssql 和 contrib/registry/etcd 等多个社区驱动增加了对最新功能的支持，提升了与外部服务集成的便捷性。

未来展望

GoFrame团队感谢每一位社区用户的支持。 我们将继续倾听社区反馈，为用户提供更丰富的功能和更高效的开发支持。

特别致谢

💖💖💖 感谢所有参与本次版本的贡献开发者们 💖💖💖

alt text

主要内容

本次版本变更内容较多，以下为本次版本的主要内容，详细的Change Log请参考： https://github.com/gogf/gf/releases/tag/v2.8.0

完整的代码变更请参考：https://github.com/gogf/gf/compare/v2.7.0…v2.8.0

兼容提示

  1. 最低Golang版本要求从1.18调整为了1.20。
  2. 组件container/gring标记废弃，未来不再继续维护。
  3. 组件contrib/trace/jaeger已从源码仓库删除。
  4. 组件encoding/gjson的Load*方法参数，从interface{}调整为了[]byte参数，以提高性能。
  5. 组件net/ghttp的StartPProfServer方法端口参数从port int调整为了address string以提高灵活性。
  6. 组件net/gudp重构，个别方法参数有调整：UDP组件

组件改进

  1. database/gdb
    • 时间维护特性增加对整型字段的支持，当created_at/updated_at/deleted_at为整型字段时，将使用时间戳更新该字段，详见：ORM链式操作-时间维护
    • 新增Model.Exist方法，用于判断满足所给条件的数据是否存在：ORM查询-Exist
    • 新增对数据库time/year字段类型的支持：ORM高级特性-类型识别
    • 新增OrderRandomFunction接口方法，并为常用数据库实现并支持了OrderRandom排序方法。
    • 改进Model.Fields方法，增加对gdb.Raw类型参数的支持：ORM链式操作-字段获取
    • 改进With特性中的orm标签，增加对unscoped的支持：模型关联-静态关联-With特性
    • 配置文件增加对unix socket本地数据库服务连接的支持。
    • 去掉链路跟踪trace信息中的sql语句，以减少trace包大小。
    • 改进查询结果到struct的转换性能。
  2. net/ghttp
    • 取消了规范路由注册中对输入输出对象的XxxReq/XxxRes命名限制。
    • StartPProfServer的端口参数从port int调整为了address string以提高灵活性。
    • 去掉了链路跟踪trace信息中的请求/返回数据内容，以减少trace包大小。
    • 修复/debug/admin/shutdown接口关闭Server时的优雅关闭问题。
  3. net/goai
    • 允许在请求/返回结构体属性中通过type标签指定参数的类型。
  4. container/gtree
    • 使用第三方数据结构组件github.com/emirpasic/gods重构gtree实现，以提高可扩展性，利于维护。
  5. encoding/gjson
    • Load*方法参数，从interface{}调整为了[]byte参数，以提高性能。
  6. os/gcron
    • 新增StopGracefully方法，用于等待当前正在执行的定时任务完成后再停止定时任务：定时任务-基本使用
  7. os/gfsnotify
    • 改进文件递归监听实现，当监听目录时，如果后续在目录中创建子级目录，或者子级目录的子级目录，以此类推，也将会被递归监听：文件监控-gfsnotify
  8. test/gtest
    • 改进AssertIN/AssertNI断言方法，增加对字符串子串的包含断言支持。
  9. util/gvalid
    • 新增required-if-all校验规则，所有指定的参数和对应的数值相等时，该参数为必须参数：数据校验-校验规则
    • 改进phone校验规则，增加对171系列手机号码的验证支持。
  10. util/gconv
    • 使用类型缓存提升转换性能，针对复杂数据类型的转换性能提升约300%。

社区组件

  1. drivers/mssql
    • 基础driver从github.com/denisenkom/go-mssqldb改为了官方组件github.com/microsoft/go-mssqldb。
  2. contrib/drivers/pgsql
    • 增加InsertIgnore操作支持。
    • 增加对Golang数组类型到数据库数组字段类型操作的支持。
  3. contrib/registry/etcd
    • 增加DialTimeout及AutoSyncInterval配置项。
  4. contrib/registry/nacos
    • 使用官方组件依赖github.com/nacos-group/nacos-sdk-go/v2替换掉github.com/joy999/nacos-sdk-go
  5. contrib/rpc/grpcx
    • 去掉了链路跟踪trace信息中的请求/返回数据内容，以减少trace包大小。
    • 由于grpc组件已启用grpc.Dial方法，这里使用grpc.NewClient替换掉了grpc.Dial。
  6. contrib/sdk/httpclient
    • 新增Handler接口，允许使用者自定义处理HTTP Client返回数据。

开发工具

  1. 改进gf init命令，新增-a/monoApp选项，用于在大仓下新创建应用项目模板：项目创建-init
  2. 改进gf pack命令，新增对命令参数选项的配置文件支持，配置项路径为gfcli.pack。
  3. 改进gf tpl命令，新增对命令参数选项的配置文件支持，配置项路径为gfcli.tpl.parse。
  4. 改进gf gen ctrl命令，使用AST重新实现解析逻辑，提高生成Go代码文件内容的准确性，并提升该功能的可扩展性。
  5. 改进gf run命令：
    • 新增对命令参数选项的配置文件支持，配置项路径为gfcli.run。
    • 在临时的子进程结束时，如新进程替换老进程时，自动删除临时的老进程二进制文件。
  6. 改进gf gen dao命令：
    • 增加field mapping特性，支持对指定字段配置生成的Golang数据类型：数据规范-gen dao
    • 整型字段如果长度为1，例如：bit(1)/tinyint(1)/int(1)，那么自动识别生成为bool类型的Golang数据类型。
    • 自动读取生成代码文件的目录名称，作为生成的dao/do/entity文件的包名称。
    • 由于dm数据库限制了cli支持的平台，因此cli去掉了对dm数据库的默认支持，若有需要请手动修改源码安装cli。
    • 修复传递link参数和配置文件同时存在的场景下，link参数失效问题。