v1.13.1 (2020-06-10)

GoFrame

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

特点

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

发展

GoFrame开始得比较早，2011年始于北京一个智能物联网平台项目，那时还没有这么多物联网的现行标准，Go的标准库以及生态也未如此丰富。2017年的时候GF才开始发布测试版，2018年1024程序员节日的时候才发布v1.0正式版，为Go生态发展添砖加瓦。开源以来快速迭代、发展成长，广受开发者和企业的青睐，也有许多的开发者加入了贡献行列。GF原本是为开发团队设计的，因此她的开发效率和可维护性做得非常好，有着很高的代码质量以及丰富的单元测试和示例，并且GF是目前中文化文档做的最好的Golang开发框架。

Change Log

1. 应多数开发者的要求，框架要求的最低Golang运行版本降级为了v1.11。
2. 新增GoFrame视频教程地址：
   • bilibili：https://www.bilibili.com/video/av94410029
   • 西瓜视频： https://www.ixigua.com/pseries/6809291194665796100/
3. 将不常用的guuid模块迁移到 github.com/gogf/guuid 作为社区模块维护，保持gf主仓库的轻量级。
4. 新增guid模块，用于高效轻量级的唯一字符串生成：https://goframe.org/util/guid/index

tool chain

1. 工具链更新：https://goframe.org/toolchain/cli
2. 新增gf env命令，更优雅地查看当前Golang环境变量信息。
3. 新增gf mod path命令，用于将当前go modules包拷贝到GOPATH中，以便使用原始的GOPATH方式开发项目。
4. 对现有cli命令进行了一些改进，提高使用体验；预编译二进制版本在部分平台下提供了upx压缩，使得下载的文件更小。

container

1. garray
   • https://goframe.org/container/garray/index
   • 简化数组使用方式，支持类似于var garray.Array的变量定义使用方式；
   • 增加Walk方法，用于自定义的数组元素处理方法；
   • 增加ContainsI方法，用于大小写忽略匹配的数组元素项存在性查找；
   • 完善单元测试，代码覆盖率94%；
   • 代码改进，提高性能；
   • 修复一些问题；
2. gchan
   • 由于该封装包实际意义不是很大，因此从主框架中删除；
3. glist
   • https://goframe.org/container/glist/index
   • 简化链表使用方式，支持类似于var glist.List的变量定义使用方式；
   • 完善单元测试，代码覆盖率99%；
4. gmap
   • https://goframe.org/container/gmap/index
   • 简化Map使用方式，支持类似于var gmap.Map的变量定义使用方式；
   • 完善单元测试，代码覆盖率81%；
   • 代码改进，提高性能；
5. gset
   • https://goframe.org/container/gset/index
   • 简化集合使用方式，支持类似于var gset.Set的变量定义使用方式；
   • 增加Walk方法，用于自定义的集合元素处理方法；
   • 完善单元测试，代码覆盖率90%；
   • 代码改进，提高性能；
6. gtree
   • https://goframe.org/container/gtree/index
   • 简化树型使用方式，支持类似于var gtree.BTree的变量定义使用方式；
   • 完善单元测试，代码覆盖率90%；
7. gvar
   • https://goframe.org/container/gvar/index
   • 完善单元测试，代码覆盖率69%；
   • 代码组织结构调整，提高维护性；
   • 代码改进，提高性能；

database

1. gdb
   • 增加Transaction(f func(tx *TX) error) (err error)接口方法，用于通过闭包实现事务封装处理：https://goframe.org/database/gdb/transaction
   • 去掉不常用的From接口方法，改进Table及Model方法的参数为不定参数，并支持通过不定参数传递表别名：https://goframe.org/database/gdb/model/select
   • 增加DryRun特性，支持空跑时只执行查询不执行写入/更新/删除操作：https://goframe.org/database/gdb/senior
   • 增加create_at, update_at写入时间、更新时间字段自动填充特性：https://goframe.org/database/gdb/model/auto-time
   • 增加delete_at软删除特性：https://goframe.org/database/gdb/model/auto-time
   • 增加Having链式操作方法，用于having条件查询：https://goframe.org/database/gdb/model/select
   • Result结果对象增加Chunk方法，用于自定义的数据分批处理：https://goframe.org/database/gdb/result
   • 改进Schema数据库运行时切换特性；
   • 改进对pgsql, mssql, sqlite, oracle数据库字段类型的支持；
   • 进一步完善单元测试；
   • 代码组织结构调整，提高维护性；
   • 代码改进，提高性能；
2. gredis
   • 增加MaxActive连接池参数默认配置为100，限制默认的连接数量；
   • 改进Conn连接对象的Do方法，支持对map/slice/struct类型进行自动的json.Marshal处理，注意获取数据时使用DoVar方法获取：https://goframe.org/database/gredis/usage
   • 完善单元测试，代码覆盖率72%；

net

1. ghttp

   • 增加Prefix及Retry客户端链式操作方法；
   • 增加客户端原始请求打印特性：https://goframe.org/net/ghttp/client/demo/dump
   • 增加ClientMaxBodySize的服务端配置，用于限制客户端提交的Body大小，默认为8MB；在涉及到上传的Server中需要增加该配置的大小，在配置文件中指定对应的大小即可，如ClientMaxBodySize="100MB"：https://goframe.org/net/ghttp/config
   • 改进SessionId生成的随机性，提高Session安全性：https://goframe.org/os/gsession/index
   • 改进ghttp.Server实现了标准库的http.Handler接口，便于与其他第三方的服务如Prometheus进行代码集成；
   • 其他大量的代码细节改进工作，提高性能及持久维护性；
   • 完善单元测试，代码覆盖率61%；

2. gipv4

   • 增加GetIpArray方法，用于获取当前主机的所有IPv4地址；
   • 增加GetMacArray及GetMac方法，用于获取当前主机的MAC地址信息；
   • 修改IntranetIP方法名称为GetIntranetIp，修改IntranetIPArray方法名称为GetIntranetIpArray；

encoding

1. gjson
   • 新增GetMaps获取JSON内部节点变量方法；
   • 改进NewWithTag方法对map/struct的处理；
   • 完善单元测试，代码覆盖率77%；
2. gyaml
   • 升级依赖的第三方yaml解析包，解决了map[interface{}]interface{}转换问题；

error

1. gerror
   • 新增NewfSkip方法，用于创建skip指定堆栈的错误对象；
   • 放开框架所有的堆栈链路打印，展示错误时真实的链路调用详情；

os

1. gcache

   • 增加GetVar方法，用于获得可以便捷转换为其他数据类型的”泛型”变量；
   • 标记Removes方法废弃，改进Remove方法参数为不定参数，统一使用Remove方法删除单个/多个键值对；
   • 完善单元测试，代码覆盖率96%；

2. genv

   • 增加GetVar方法，用于获得可以便捷转换为其他数据类型的”泛型”变量；

3. gfile

   • 改进CopyDir/CopyFile复制目录/文件方法；
   • 新增ScanDirFunc方法，用于支持自定义处理回调的目录检索；
   • 完善单元测试，代码覆盖率64%；

4. glog

   • 增加支持Context上下文变量的日志打印特性：https://goframe.org/os/glog/context

5. gres

   • 改进打包特性，增强生成二进制文件及Go文件的压缩比，比旧版本增加20%压缩率，使得编译生成的二进制文件体积更小；
   • 代码结构改进，提高执行效率及可持久维护性；

6. gsession

   • 改进SessionId默认生成方法，采用guid.S方法生成；
   • 增加SetId及SetIdFunc方法，用于自定义SessionId及自定义的SessionId生成方法；

frame

1. g
   • 新增g.Table方法，用于快速创建数据库模型操作对象；

i18n

1. gi18n
   • 新增GetContent方法，用于获取指定i18n关键字为转译内容；
   • 改进代码细节，提高性能和持久可维护性；
   • 完善单元测试，代码覆盖率74%；

test

1. gtest
   • 增加AssertNQ断言方法，用于强类型的不相等判断；

text

1. gstr
   • 增加SubStrRune方法，用于支持unicode的字符串截取；
   • 增加StrLimitRune方法，用于支持unicode的字符串截断隐藏；
   • 增加LenRune方法，用于替换RuneLen方法，统一方法命名风格；
   • 增加PosRune/PosIRune/PosRRune/PosRIRune方法，用于支持unicode的字符串左右位置查找；
   • 增加CompareVersionGo方法，用于Golang风格的版本号大小比较；
   • 完善单元测试，代码覆盖率75%；

util

1. gconv

   • 改进Convert转换方法，支持常见map类型的转换；
   • 改进类型转换过程中异常错误的捕获，通过error返回；
   • 其他一些细节改进；
   • 完善单元测试，代码覆盖率63%；

2. grand

   • 增加B方法，用于获得随机的二进制数据；
   • 改进代码底层实现，部分接口性能提高50%；
   • 完善单元测试，代码覆盖率74%；

3. guid

   • 新增guid模块，用于高效轻量级的唯一字符串生成：https://goframe.org/util/guid/index

4. gutil

   • 增加MapContains方法，用于判断map中是否包含指定键名；
   • 增加MapDelete方法，用于删除map中指定的键名，可以为多个键名；
   • 增加MapMerge方法，用于合并两个map；
   • 增加MapMergeCopy方法，用于拷贝多个map；
   • 增加MapContainsPossibleKey方法，用于查找指定键名，忽略大小写及字符'-'/'_'/'.'/' '；

5. gvalid

   • 所有默认的错误提示改为了英文；
   • 错误提示的配置改为了通过i18n来配置实现，以便支持国际化：https://goframe.org/util/gvalid/message
   • 身份证号规则名称从id-number改为了resident-id；
   • 银行卡号规则名称从luhn改为了bank-card；
   • 完善单元测试，代码覆盖率96%；

Bug Fix

1. 修复gcompress的多文件zip压缩问题；
2. 修复ghttp.Client获取返回的过期Cookie的问题；
3. 修复gres.File对于http.File接口的实现细节；
4. 修复garray.Pop*方法的边界问题；
5. 修复gres中Readdir方法参数为0时报错的问题；
6. 其他一些修复：https://github.com/gogf/gf/issues?q=is%3Aissue+label%3Abug