大家好啊!万众瞩目的GoFrame v2版本终于发布了正式版本!本次版本包含了大量改进以及新特性,同时新增了一些开创性的功能特性。

去年夏天到今年春天,一路以来的努力,希望大家满意。

感谢所有社区小伙伴的贡献,感谢社区朋友们的支持!

新的一年,我们继续,脚踏实地,不忘初心!

升级指导:如何从v1愉快升级到v2

一、重要特性

1、新版工程设计

  • 更加严谨规范
  • 命名风格的规范
  • 指针与值传递参数的规范
  • 进一步简便、提高开发效率
  • 新版开发工具支持工程规范准确落地
  • Entity/DAO/DO特性
  • 面向接口化设计
  • 更多详细介绍:工程开发设计

2、全链路跟踪特性

  • 可观测性更进一步:大胆的前瞻以及决心
  • 框架默认启用OpenTelemetry特性
  • 框架默认创建TraceID,按照OpenTelemetry生成标准
  • 框架核心组件均支持链路跟踪信息传递
  • 日志组件支持链路信息打印
  • 更多详细介绍:全链路跟踪设计

3、规范路由注册特性

  • 规范化API按照结构化编程设计
  • 规范化API接口方法参数风格定义
  • 更加简化的路由注册与维护
  • 统一接口返回数据格式设计
  • 自动的API参数对象化接收与校验
  • 自动生成基于标准OpenAPIv3协议的接口文档
  • 自动生成SwaggerUI页面
  • 更多详细介绍:路由注册-规范路由

4、全错误堆栈特性

  • 框架层面所做的重大决定
  • 框架 所有 组件错误均支持错误堆栈
  • 详细介绍:全错误堆栈设计

5、全新错误码特性

  • 采用接口化设计,扩展性高
  • 提供可供选择的常见错误码
  • 框架核心组价底层已增加错误码支持,例如根据error中的错误码可以识别是否DB执行错误
  • 更多详细介绍:错误处理-错误码特性

6、组件接口化设计

  • 自顶向下统一化的接口化设计
  • 核心组件均采用接口化设计
  • 更高的扩展性、可定制性
  • 更多详细介绍:接口化与泛型设计

7、框架泛型的支持

  • 什么是框架gvar泛型?
  • 框架gvar泛型在框架核心组件中的大量使用
  • 框架gvar泛型的重要价值
  • 为什么不建议在顶层业务中使用泛型
  • 更多详细介绍:接口化与泛型设计

8、ORM的大量改进

9、其他重要改进

1)日志组件Handler特性

  • 采用中间件设计
  • 支持多个Handler处理
  • 为开发者自定义日志处理提供了更灵活强大的支持
  • 更多详细介绍:日志组件-Handler

2)日志组件颜色打印

  • 在终端中默认输出颜色打印
  • 默认不同级别不同的颜色,可配置
  • 输出到文件/自定义Writer默认关闭,可通过相关配置开启
  • 更多详细介绍:日志组件-颜色打印

4)调试模式介绍完善

二、功能改进

1、数据组件

  1. /database/gdb
    1. 废弃Table方法,统一使用Model方法创建Model对象。
    2. 废弃Model中的Struct/Structs方法,统一使用Scan方法执行查询结果到Struct对象/对象数组映射转换:ORM查询-Scan
    3. 废弃BatchInsert/BatchReplace/BatchSave方法,统一使用Insert/Replace/Save方法实现,内部自动实现参数类型识别采用单条写入还是批量写入:ORM链式操作-写入保存
    4. 增加DoFilter接口方法,用于ORM提交执行SQL&Args到底层driver之前的SQL&Args自定义过滤:ORM接口开发-回调处理
    5. 增加DoCommit接口方法,用于ORM提交执行SQL&Args到底层driver之前的自定义处理
    6. 增加ConvertDataForRecord接口方法,用于自定义的数据转换处理。ORM接口开发-回调处理
    7. 增加Raw方法,用于通过原始SQL语句构建Model对象,随后可以使用Model的链式操作以及各种特性:ORM链式操作-模型创建
    8. 增加Handler特性,用于自定义的Model对象修改,并返回新的Model对象,可轻松地复用常见的逻辑:ORM链式操作-Handler特性
    9. 增加Union/UnionAll特性,用于多条SQL/Model的查询结果合并:ORM查询-Union/UnionAll
    10. 增加With特性对条件查询以及排序语句的配置支持:模型关联-静态关联-With特性
    11. 增加OnDuplicate/OnDuplicateEx方法,用于指定Save方法的更新/不更新字段:ORM链式操作-写入保存
    12. 增加Wheref/WhereOrf方法,用于带有格式化字符串语句的条件传递:ORM查询-Where/WhereOr/WhereNot
    13. 增加WhereLT/WhereLTE/WhereGT/WhereGTE以及WhereOrLT/WhereOrLTE/WhereOrGT/WhereOrGTE方法,用以为ORM添加常见的比较条件:https://
    14. 增加WherePrefix/WhereOrPrefix方法,用以在为条件字段加上表前缀,常用于关联查询中
    15. 增加FieldsPrefix/FieldsExPrefix方法,用于为查询的字段增加自定义的表前缀,常用于关联查询中
    16. 增加FieldsCount/FieldsSum/FieldsMin/FieldsMax/FieldsAvg方法,用于增加常见的统一查询条件
    17. 增加LeftJoinOnField/RightJoinOnField/InnerJoinOnField方法,用于便捷关联带有相同字段名称的表
    18. 增加OmitEmptyWhere/OmitEmptyData方法,用于特定过滤Where条件和Data数据中的空值数据:ORM链式操作-字段过滤
    19. 增加OmitNil/OmitNilWhere/OmitNilData方法,用于特定过滤Where条件和Data数据中的nil数据:ORM链式操作-字段过滤
    20. 增加TimeZone配置项,用于数据库查询的自定义时区转换(目前支持mysql/pgsql):ORM使用配置
    21. 改进Cache缓存特性,支持增加准确的缓存参数控制
    22. 增加Close方法,用于手动关闭数据库连接
    23. 去掉ORM在使用没有自定义配置时默认100连接数的配置限制。
    24. 改进时间维护特性,不再自动过滤开发者提交的CreatedAt/UpdatedAt/DeletedAt相关参数,意味着开发者可以在ORM操作中自定义相关时间字段的更新。
    25. 改进数据库执行的SQL日志记录,增加影响行数记录
    26. 接口方法HandleSqlBeforeCommit名称修改为了DoCommit
    27. 数据库方法操作统一增加context.Context作为第一必须参数。
    28. 修复gdb组件的With特性多层级查询失效问题。
    29. 删除查询结果类型Record/Result的所有已废弃的方法。
    30. 单元测试完善。
  2. /database/gredis

    1. 采用适配器模式,以接口化设计重构该组件,以提高扩展性:Redis-接口化设计

    2. 默认提供基于第三方goredis包的适配器实现,增加了对Redis集群的支持:Redis-配置管理

    3. 由于集群特性的支持,配置文件格式发生改变:Redis-配置管理

2、网络组件

  1. /net/ghttp
    1. 新增路由注册方式:路由注册-规范路由
    2. 默认将Request对象注入到ctx上下文对象中,并增加RequestFromCtx/g.RequestFromCtx方法获取ctx中的Request对象。
    3. Client功能特性进行抽离,封装为gclient组件:HTTPClient
    4. Server日志增加对ctx上下文链路信息打印的支持,并改进日志格式:链路跟踪
    5. 参数获取返回统一使用*gvar.Var泛型对象。
    6. 废弃ghttp中相关的HTTP Client直接操作方法,必须通过创建Client对象来实现客户端访问操作。
    7. 废弃Controller路由注册方式,并删除相关实现逻辑代码。
  2. /net/gtrace
    1. 升级[go.opentelemetry.io/otel](http://go.opentelemetry.io/otel)到最新的正式版。
    2. 完善全新的链路跟踪使用文档:链路跟踪

3、系统组件

  1. /os/glog
    1. 为推进可观测性特性,落实链路跟踪规范,所有日志打印方法均增加context.Context参数。
    2. 日志组件增加了Handler特性,采用中间件设计、支持多个Handler处理,为开发者自定义日志处理提供了更灵活强大的支持:日志组件-Handler
    3. 日志组件增加了对内容的颜色打印特性支持,在终端中默认输出颜色打印,输出到文件/自定义Writer默认关闭、可通过相关配置开启:日志组件-颜色打印
    4. 废弃Println方法。
    5. 文档更新:日志组件
  2. /os/gres
    1. 新增Export方法用于将资源组件中的文件导出到本地磁盘:资源管理-方法介绍
  3. /os/gfile
    1. 新增SizeFormat方法用于获取指定文件格式化后的大小字符串。
    2. 文档更新:文件管理-gfile
  4. /os/gcache
    1. 采用适配器模式,以接口化设计重构该组件,以提高扩展性:缓存管理-接口设计
    2. 默认提供了基于进程内存的缓存实现:缓存管理-内存缓存
    3. 所有操作方法增加了context.Context上下文参数。
    4. 参数获取返回统一使用*gvar.Var泛型对象。
    5. 增加Must*方法,用以直接获取参数并在产生错误时直接panic
  5. /os/gcfg
    1. 采用适配器模式,以接口化设计重构该组件,以提高扩展性:配置管理-接口化设计
    2. 默认提供了基于文件系统的配置管理实现:配置管理
    3. 参数获取返回统一使用*gvar.Var泛型对象。
    4. 所有操作方法增加了context.Context上下文参数。
    5. 增加GetWithEnv方法,当配置适配器中无法查找到对应的参数时,将会自动读取环境变量中的相应参数:配置管理-配置读取
    6. 增加GetWithCmd方法,当配置适配器中无法查找到对应的参数时,将会自动读取命令行参数中的相应参数:配置管理-配置读取
    7. 增加Must*方法,用以直接获取参数并在产生错误时直接panic
    8. 配置组件易用性改进,通过单例对象访问配置组件将会按照toml/yaml/yml/json/ini/xml文件后缀自动检索配置文件:配置管理
  6. /os/gcmd
    1. 参数获取返回统一使用*gvar.Var泛型对象。
    2. 全新的多层级命令行管理方式,支持自动生成命令行使用提示:命令管理-命令行对象
    3. 增加基于对象的命令行管理方式,更适合大量的终端命令场景:命令管理-结构化参数
  7. /os/genv
    1. 参数获取返回统一使用*gvar.Var泛型对象。
  8. /os/gcron
    1. 定时任务方法定义增加context.Context参数。
    2. 所有创建定时任务方法增加context.Context参数。
    3. 文档更新:定时任务-gcron
  9. /os/gtime
    1. 废弃Second/Millisecond/Microsecond/Nanosecond包方法,使用Timestamp/TimestampMilli/TimestampMicro/TimestampNano方法替代。
    2. 文档更新:时间管理-gtime
  10. /os/gtimer
    1. 定时器方法定义增加context.Context参数。
    2. 所有创建定时器方法增加context.Context参数。
    3. 改进基于优先级队列数据结构存储的定时任务执行检测机制,提高执行性能。
    4. 文档更新:定时器-gtimer
  11. /os/grpool
    1. 回调方法定义增加context.Context参数。
    2. goroutine池任务添加方法增加context.Context参数。
    3. 文档更新:协程管理-grpool
  12. /os/gsession
    1. gsession.Storage接口增加ctx上下文参数输输入,用于承接上下文信息、实现完整的链路跟踪。并未保证严谨性增加error返回参数:Session
    2. 参数获取返回统一使用*gvar.Var泛型对象。
  13. /os/gview
    1. 模板解析方法统一增加context.Context参数。
    2. 增加plus/minus/times/divide四则运算内置模板方法。
    3. 文档更新:模板引擎
  14. /os/gstructs
    1. 将框架internal中的structs包开放,命名为gstructs,用于struct反射操作的高级使用包:对象信息-gstructs

4、错误处理

  1. /errors/gerror
    1. 增加Message方法,用于获取指定错误码的错误信息。
    2. 增加CodeMessage方法,用于获取指定错误的错误码信息。
    3. 增加NewOption方法,用于自定义配置的错误对象创建,献给框架高级玩家。
    4. 增加HasStack方法,用于判断给定的error接口对象是否实现(包含)了堆栈信息。
    5. 错误码从整型改为接口对象,以实现可定制性并提高可扩展性,详情参考gcode组件介绍:错误处理-错误码特性
    6. 提高易用性,改进NewCode/NewCodeSkip/WrapCode/WrapCodeSkip方法,调增text输入参数为非必须,默认使用对应错误码的Message信息。
  2. /errors/gcode
    1. 增加gcode错误码组件,提供可定制型和扩展性极强的错误码管理,结合gerror组件实现强大的错误处理:错误处理-错误码使用

5、其他组件

  1. /container/garray
    1. 各数组类型统一增加At方法,用于直接获取返回索引位置的数据。
    2. 文档更新:数组类型-方法介绍
  2. /debug/gdebug
    1. 增加TestDataContent方法,用于直接获取测试包下testdata目录下指定路径文件内容。
    2. 文档更新:调试功能-gdebug
  3. /encoding/gjson
    1. 废弃大部分的Get*方法,统一使用Get方法获取指定pattern的内容,并统一返回*gvar.Var泛型对象,开发者根据业务场景自行通过对应方法便捷转换为特定类型变量。
    2. 增加若干Must*方法。
    3. 使用文档全面更新
  4. /frame/g
    1. 增加ModelRaw方法,用于便捷创建基于原生SQL的数据库Model对象。
    2. 为通过/frame/g模块创建的ORM对象增加logger配置,通过自动读取配置文件,自动初始化:ORM使用配置
    3. 为通过/frame/g模块创建的Server对象增加logger配置,通过自动读取配置文件,自动初始化:服务配置
  5. /frame/gmvc
    1. 标记废除gmvc耦合模块,未来不再进一步支持。
  6. /util/gutil
    1. 改进实现Dump方法,不再使用json包实现类型打印,而是自实现了对任意类型的打印特性,并且支持打印详细的数据类型:工具方法-gutil
    2. 增加SliceToMapWithColumnAsKey方法,用以将Slice按照一定规则转换为Map
  7. /utils/gvalid
    1. 增加bail校验规则,以及Bail链式操作方法,用以在数据校验不通过时直接退出校验,不再执行后续校验规则。
    2. 增加datetime校验规则,用以校验常用日期时间类型,其中日期之间支持的连接符号只支持-,格式如:2006-01-02 12:00:00
    3. 去掉包校验方法,统一使用链式操作实现数据校验。
    4. 所以校验方法增加context.Context参数。
    5. 全新、超完善的数据校验组件使用文档:数据校验

其他大量的改进细节,这里不再赘述,感兴趣的小伙伴可参阅官网 goframe.org

三、CLI工具链

  1. 采用全新gcmd命令行对象封装重构实现。
  2. 改进init命令,支持SingleRepo/MonoRepo两种仓库初始化。并且项目初始化不再依赖远端仓库。
  3. 改进gen dao命令,采用全新的V2工程化设计,自动生成entity/dao/do代码文件。
  4. 去掉update命令,工具的更新统一走 https://github.com/gogf/gf/tree/master/cmd/gf
  5. 去掉get命令。
  6. 全新文档:开发工具