v1.12.1 (2020-03-31)

大家好啊!久等啦!

由于自从上次版本的发布以来,越来越多小伙伴加入了GF的大家庭,并提供了许多不错的建议和反馈,这次版本对其中大部分反馈进行了处理,包括大部分的改进建议和部分新特性,因此这次的版本发布时隔了两个多月。GF非常注重代码质量以及可持续维护性,这次版本也进一步对框架大部分模块的示例、注释和单元测试用例进行了完善,目前单元测试用例数量约为1991例,代码覆盖率为71%,覆盖了所有模块的绝大部分主要功能。

GF框架提供了比较常用、高质量的基础开发模块,轻量级、模块化、高性能,推荐大家阅读框架源码了解更多细节。本次发布有个别的不兼容升级,往往批量替换即可,以下change log比较完善,建议升级前仔细阅读。

本次发布即意味下一版本开发计划的开启,欢迎更多小伙伴参与开源贡献:https://github.com/gogf/gf/projects/8

感谢大家支持!Enjoy your GF

GoFrame

GF(Go Frame)是一款模块化、高性能、生产级的Go基础开发框架。实现了比较完善的基础设施建设以及开发工具链,提供了常用的基础开发模块,如:缓存、日志、队列、数组、集合、容器、定时器、命令行、内存锁、对象池、配置管理、资源管理、数据校验、数据编码、定时任务、数据库ORM、TCP/UDP组件、进程管理/通信等等。并提供了Web服务开发的系列核心组件,如:Router、Cookie、Session、Middleware、服务注册、模板引擎等等,支持热重启、热更新、域名绑定、TLS/HTTPS、Rewrite等特性。

特点

  • 模块化、松耦合设计;
  • 模块丰富,开箱即用;
  • 简便易用,易于维护;
  • 社区活跃,大牛谦逊低调脾气好;
  • 高代码质量、高单元测试覆盖率;
  • 详尽的开发文档及示例;
  • 完善的本地中文化支持;
  • 更适合企业及团队使用;

地址

Change Log

GF v1.12版本开始,框架要求的最低Golang运行版本为v1.13,由于Golang新版本都是向后兼容的,因此推荐大家更新使用Golang新版本:https://golang.google.cn/dl/

本次版本也新增了Swagger的工具及插件支持,另行独立发布。

tool chain

  1. gen model命令新增对pgsql/mssql/sqlite/oracle的模型生成支持。
  2. gen model命令生成模型新增公开包变量Columns用于获得表的字段名称。

net

  1. ghttp

database

  1. gdb

  2. gredis

    • 增加/修改默认的数据库连接池参数:MaxIdle=10, IdleTimeout=10s, MaxConnLifetime=30s, Wait=true
    • 完善单元测试。

container

  1. 所有容器对象新增UnmarshalValue(interface{}) error接口方法实现,用于gconv转换时根据任意类型变量创建/设置对象内容,GF框架的所有容器对象均实现了该接口。

  2. garray

    • 新增RemoveValue方法,用于根据数值检索并删除元素项。
    • 新增FilterNil方法,用于遍历并删除数组中的nil元素项。
    • 新增FilterEmpty方法,用于遍历并删除数组中的空值元素项,空值包括:0, nil, false, "", len(slice/map/chan) == 0
    • 改进Set/Fill/InsertBefore/InsertAfter方法严谨性,将原有的链式操作返回值对象修改为error返回值。
    • 改进Get/Remove/PopRand/PopLeft/PopRight/Rand方法严谨性,增加foundbool返回值,标识当前方法是否有数据返回,当空数组或者操作越界时found返回值为false
    • 改变Rands方法原有逻辑,保证按照给定大小返回随机数组。
    • 完善单元测试。
  3. gpool

    • 调整缓存池过期时间参数类型,旧版本为int类型表示毫秒,新版本为time.Duration类型使得时间控制更灵活。
    • 内部代码优化,性能改进。
    • 完善单元测试。
    • 完善注释。

os

  1. glog

  2. gres

    1. 改进资源内容编码设计,采用新的压缩算法,减少资源文件大小,例如原本15MB的网站静态资源文件(css/js/html等),资源文件打包后约为4MB左右:https://goframe.org/os/gres/index
    2. 注意:该改进与旧版本无法兼容,需要重新打包原有的资源文件。
    3. 完善单元测试。
  3. gcfg

    • 去掉配置对象属性的原子并发安全控制,改为普通变量类型。由于配置管理是最常用模块之一,因此确保高效的设计及方法实现。
    • 单例对象做较大调整:为方便多文件场景下的配置文件调用,简便使用并提高开发效率,因此当给定的单例名称对应的toml配置文件在配置目录中存在时,将自动设置该单例对象的默认配置文件为该文件。例如:g.Cfg("redis")获取到的单例对象将会默认去检索并设置默认的配置文件为redis.toml,当该文件不存在时,则使用默认的配置文件(config.toml):https://goframe.org/net/ghttp/config
    • 完善单元测试。
  4. gview

  5. gfile

    • 改进SelfPath获取当前执行文件路径方法,提高执行效率。
    • 改进Join文件路径连接方法,防止多余的路径连接符号。
    • 改建GetContents文件内容获取方法执行效率,降低内存占用。
    • 新增StrToSize方法,用于将大小字符串转换为字节数字,大小字符串例如10m, 5KB, 1.25Gib等。
    • 新增ReadLines/ReadByteLines方法,用于按行读取指定文件内容,并给定读取回调函数。
    • 完善单元测试。
  6. gtime

    • 改进gtime.Time对象实现,统一字符串打印时间格式为Y-m-d H:i:s,如:2020-01-01 12:00:00
  7. gcmd

    • 命令行解析方法增加strict参数,用于设置当前解析是否严格解析,严格解析下如果给定了非法的选项,将会停止解析并返回错误。默认情况下为非严格解析。
  8. genv

    • 改进Remove删除环境变量键值对方法,增加对多个键值对环境变量的删除。
  9. gfpool

    • 改进代码实现,提高效率。
    • 完善单元测试。
  10. gfsnotify

    • 改进包初始化方法,当系统原因引起默认Watcher对象创建失败时,直接panic
  11. gproc

    • 改进SearchBinaryPath方法。
    • 改进Process.Kill方法在windows*niux平台下不同表现的处理。

encoding

  1. gjson

frame

  1. g
    • 新增IsNil方法,用于判断当前给定的变量是否为nil,该方法有可能会使用到反射来实现判断。
    • 新增IsEmpty方法,用于判断当前给定的变量是否为,该方法优先使用断言判断但有可能会使用到反射来实现判断。空值包括:0, nil, false, "", len(slice/map/chan) == 0
    • 标记废弃SetServerGraceful方法,转而统一交给Server的配置来管理。
  2. gins
    • 改进代码结构,方便维护。
    • 改进、完善单元测试。
  3. gmvc
    • 新增M类型,为*gdb.Model的别名简称,用于工具链自动生成模型中的M属性。

text

  1. gstr
    • 新增HasPrefix/HasSuffix方法。
    • 新增OctStr方法,用于将八进制字符串转换为其对应的unicode字符串,例如转换为中文。常用于gRPC底层通信编码中。
    • 完善单元测试。

debug

  1. gdebug
    • 改进代码结构,方便维护。
    • 新增TestDataPath方法,用于当前包单元测试中获得当前包中testdata目录的绝对路径。

util

  1. gconv

    • 改进String字符串转换方法,增加对time.Time/*time.Time/gtime.Time类型的内置支持。
    • 改进Map/Struct转换方法,增加对一些特殊场景的细节处理。经过大规模的使用,大量的反馈改进,不断完善了细节。
    • 改进Struct转换方法,增加对UnmarshalValue(interface{}) error接口的支持。
    • 完善单元测试。
  2. grand

    • 注意:不兼容调整,原有的Str方法更名为S方法,用以获取指定长度的随机字符串、数字,并增加symbol参数,指定是否可以随机返回特殊可见字符。
    • 新增Str方法,用于从指定的字符串字符中随机获取指定长度的字符串。该方法同时支持unicode字符串,例如:中文:https://goframe.org/util/grand/index
    • 新增Symbols方法,用于随机返回指定场孤独的特殊可见字符:https://goframe.org/util/grand/index
    • 完善单元测试。
  3. gvalid

    • 长度校验规则增加对unicode字符串的支持,例如:中文。

Bug Fix

  1. 修复Server的视图对象配置失效问题。
  2. 修复Server中间件在中间件panic情况下,忽略Middleware.Next方法控制,导致鉴权中间件失效的问题。
  3. 修复gudp.Server在请求包大小超过64bytes时的断包问题,并调整默认缓冲区大小为1024byte,开发者可自定义缓冲区大小。
  4. 修复gfile.MTimeMillisecond方法返回错误的文件修改毫秒时间戳。
  5. 修复gconv.Int64对负数转换的支持。
  6. 其他一些修复。
  7. 详见:https://github.com/gogf/gf/issues?q=label%3Abug