我们很高兴宣布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团队感谢每一位社区用户的支持。 我们将继续倾听社区反馈，为用户提供更丰富的功能和更高效的开发支持。

特别致谢

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

主要内容

本次版本变更内容较多，以下为本次版本的主要内容，详细的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/naco-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参数失效问题。