# `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等特性。 ## 特点 * 模块化、松耦合设计； * 模块丰富，开箱即用； * 简便易用，易于维护； * 社区活跃，大牛谦逊低调脾气好； * 高代码质量、高单元测试覆盖率； * 详尽的开发文档及示例； * 完善的本地中文化支持； * 更适合企业及团队使用； ## 地址 - 官网：https://goframe.org - 主库：https://github.com/gogf/gf - 码云：https://gitee.com/johng/gf # 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`的模型生成支持。 1. `gen model`命令生成模型新增公开包变量`Columns`用于获得表的字段名称。 ## `net` 1. `ghttp` - 注意：从该版本开始，`Server`默认关闭了平滑重启特性。开发者可以通过相应的配置选项打开。 - 改进`Client.Get`方法，增加可选的请求参数。 - 新增`Client`链式操作方法：`Header`, `HeaderRaw`, `Cookie`, `ContentType`, `ContentJson`, `ContentXml`, `Timeout`, `BasicAuth`, `Ctx`：https://goframe.org/net/ghttp/client/chain - 新增`Request.GetCtx/GetCtxVar/SetCtxVar/Context`上下文变量管理方法，用于请求内部的上下文变量特性： - 自定义变量：https://goframe.org/net/ghttp/request/custom - 上下文变量：https://goframe.org/net/ghttp/request/context - 新增`Request.GetUploadFile/GetUploadFiles`方法，以及`UploadFile`类型，极大简化文件上传处理逻辑：https://goframe.org/net/ghttp/client/demo/upload - 新增`Request.GetPage`方法，用于便捷地获得分页对象： - 基本介绍：https://goframe.org/util/gpage/index - 动态分页：https://goframe.org/util/gpage/dynamic - 静态分页：https://goframe.org/util/gpage/static - Ajax分页：https://goframe.org/util/gpage/ajax - URL模板：https://goframe.org/util/gpage/template - 自定义分页：https://goframe.org/util/gpage/custom - 改进`Response.Redirect*`方法，增加自定义的跳转HTTP状态码参数。 - 改进`CORS`特性，完善跨域功能处理，并完全遵守`W3C`关于`OPTIONS`请求方法的规范约定：https://goframe.org/net/ghttp/cors - 模板视图对象增加`Request`内置变量，用于模板获得请求参数。由于`GF`框架的模板引擎采用两级缓存设计，减少`IO`开销的同时提升了执行效率，即使增加了大量的内置变量以及内置方法，经过大规模的性能测试，性能比其他`WebServer`库相同逻辑下高出`50% - 200%`的效率。 - 新增`Server`实验性的`Plugin`特性。 - 改进`Server`底层路由存储、检索逻辑，优化代码，提升效率。 - 改进分组路由注册的源码位置记录功能，当路由注册冲突时能够精准定位及提示重复路由源码位置。 - 改进`Server`日志处理。 - 完善单元测试。 ## `database` 1. `gdb` - 代码重构改进，增加`Driver`驱动接口设计，方便开发者自定义驱动实现。新增`Register`包方法，用于开发者注册自定义的数据库类型驱动：https://goframe.org/database/gdb/driver - 新增`GetArray`接口及实现，用于获取指定字段列的数据，构造成数组返回：https://goframe.org/database/gdb/chaining/select - 新增`InsertIgnore`接口及实现，用于写入时忽略写入冲突，仅对`mysql`数据库类型有效：https://goframe.org/database/gdb/chaining/insert-save - 新增`Schema`接口及实现，用于动态切换并获取指定名称的数据库对象：https://goframe.org/database/gdb/chaining/schema - 新增`FieldsStr/FieldsExStr`模型方法，用于获取表字段，并构造成字符串返回：hhttps://goframe.org/database/gdb/chaining/fields-retrieve - 新增`LockUpdate/LockShared`模型链式操作方法，用于实现悲观锁操作：https://goframe.org/database/gdb/chaining/lock - 改进`Where/Data`方法对更新参数输入方式的支持，提高灵活性： - https://goframe.org/database/gdb/chaining/select - https://goframe.org/database/gdb/chaining/update-delete - 查询结果对象`Result`新增`Array`方法，用于获得指定字段的数值，构造成数组返回：https://goframe.org/database/gdb/result - 改进`OmitEmpty`方法对`Data`输入参数的过滤，当给定的`Data`参数为空时间对象时，将会被过滤。 - 增加默认的数据库连接池参数：`MaxIdleConns=10`。 - 其他一些改进。 - 完善单元测试。 1. `gredis` - 增加/修改默认的数据库连接池参数：`MaxIdle=10`, `IdleTimeout=10s`, `MaxConnLifetime=30s`, `Wait=true`。 - 完善单元测试。 ## `container` 1. 所有容器对象新增`UnmarshalValue(interface{}) error`接口方法实现，用于`gconv`转换时根据任意类型变量创建/设置对象内容，`GF`框架的所有容器对象均实现了该接口。 1. `garray` - 新增`RemoveValue`方法，用于根据数值检索并删除元素项。 - 新增`FilterNil`方法，用于遍历并删除数组中的`nil`元素项。 - 新增`FilterEmpty`方法，用于遍历并删除数组中的空值元素项，空值包括：`0, nil, false, "", len(slice/map/chan) == 0`。 - 改进`Set/Fill/InsertBefore/InsertAfter`方法严谨性，将原有的链式操作返回值对象修改为`error`返回值。 - 改进`Get/Remove/PopRand/PopLeft/PopRight/Rand`方法严谨性，增加`found`的`bool`返回值，标识当前方法是否有数据返回，当空数组或者操作越界时`found`返回值为`false`。 - 改变`Rands`方法原有逻辑，保证按照给定大小返回随机数组。 - 完善单元测试。 1. `gpool` - 调整缓存池过期时间参数类型，旧版本为`int`类型表示毫秒，新版本为`time.Duration`类型使得时间控制更灵活。 - 内部代码优化，性能改进。 - 完善单元测试。 - 完善注释。 ## `os` 1. `glog` - 增加`Rotation`日志滚动切分特性，新增按照文件大小或过期时间进行日志切分，并支持切分文件数量限制、对日志文件进行自动压缩、可自定义压缩级别（`1-9`）、支持对切分文件过期时间清理：https://goframe.org/os/glog/rotate - 新增`LevelPrefixes`特性，支持对日志级别的前缀名称进行自定义：https://goframe.org/os/glog/level - 新增`SetLevelStr`方法，并增加按照字符串进行日志级别配置的特性： - https://goframe.org/os/glog/level - https://goframe.org/os/glog/config - 新增`SetDefaultLogger`包方法，用于设置全局默认的`Logger`对象。 1. `gres` 1. 改进资源内容编码设计，采用新的压缩算法，减少资源文件大小，例如原本`15MB`的网站静态资源文件（`css/js/html`等），资源文件打包后约为`4MB`左右：https://goframe.org/os/gres/index 1. 注意：该改进与旧版本无法兼容，需要重新打包原有的资源文件。 1. 完善单元测试。 1. `gcfg` - 去掉配置对象属性的原子并发安全控制，改为普通变量类型。由于配置管理是最常用模块之一，因此确保高效的设计及方法实现。 - 单例对象做较大调整：为方便多文件场景下的配置文件调用，简便使用并提高开发效率，因此当给定的单例名称对应的`toml`配置文件在配置目录中存在时，将自动设置该单例对象的默认配置文件为该文件。例如：`g.Cfg("redis")`获取到的单例对象将会默认去检索并设置默认的配置文件为`redis.toml`，当该文件不存在时，则使用默认的配置文件（`config.toml`）：https://goframe.org/net/ghttp/config - 完善单元测试。 1. `gview` - 新增`concat`内置字符串拼接方法：https://goframe.org/os/gview/function/buildin - 完善单元测试。 1. `gfile` - 改进`SelfPath`获取当前执行文件路径方法，提高执行效率。 - 改进`Join`文件路径连接方法，防止多余的路径连接符号。 - 改建`GetContents`文件内容获取方法执行效率，降低内存占用。 - 新增`StrToSize`方法，用于将大小字符串转换为字节数字，大小字符串例如`10m`, `5KB`, `1.25Gib`等。 - 新增`ReadLines/ReadByteLines`方法，用于按行读取指定文件内容，并给定读取回调函数。 - 完善单元测试。 1. `gtime` - 改进`gtime.Time`对象实现，统一字符串打印时间格式为`Y-m-d H:i:s`，如：`2020-01-01 12:00:00`。 1. `gcmd` - 命令行解析方法增加`strict`参数，用于设置当前解析是否严格解析，严格解析下如果给定了非法的选项，将会停止解析并返回错误。默认情况下为非严格解析。 1. `genv` - 改进`Remove`删除环境变量键值对方法，增加对多个键值对环境变量的删除。 1. `gfpool` - 改进代码实现，提高效率。 - 完善单元测试。 1. `gfsnotify` - 改进包初始化方法，当系统原因引起默认`Watcher`对象创建失败时，直接`panic`。 1. `gproc` - 改进`SearchBinaryPath`方法。 - 改进`Process.Kill`方法在`windows`及`*niux`平台下不同表现的处理。 ## `encoding` 1. `gjson` - 代码改进、完善注释、新增大量代码示例。 - 文档更新： - 基本介绍：https://goframe.org/encoding/gjson/index - 对象创建：https://goframe.org/encoding/gjson/object - 层级访问：https://goframe.org/encoding/gjson/pattern - Struct转换：https://goframe.org/encoding/gjson/conversion-struct - 动态创建修改：https://goframe.org/encoding/gjson/dataset - 数据格式转换：https://goframe.org/encoding/gjson/conversion-format ## `frame` 1. `g` - 新增`IsNil`方法，用于判断当前给定的变量是否为`nil`，该方法有可能会使用到反射来实现判断。 - 新增`IsEmpty`方法，用于判断当前给定的变量是否为`空`，该方法优先使用断言判断但有可能会使用到反射来实现判断。空值包括：`0, nil, false, "", len(slice/map/chan) == 0`。 - 标记废弃`SetServerGraceful`方法，转而统一交给`Server`的配置来管理。 1. `gins` - 改进代码结构，方便维护。 - 改进、完善单元测试。 1. `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`接口的支持。 - 完善单元测试。 1. `grand` - 注意：不兼容调整，原有的`Str`方法更名为`S`方法，用以获取指定长度的随机字符串、数字，并增加`symbol`参数，指定是否可以随机返回特殊可见字符。 - 新增`Str`方法，用于从指定的字符串字符中随机获取指定长度的字符串。该方法同时支持`unicode`字符串，例如：中文：https://goframe.org/util/grand/index - 新增`Symbols`方法，用于随机返回指定场孤独的特殊可见字符：https://goframe.org/util/grand/index - 完善单元测试。 1. `gvalid` - 长度校验规则增加对`unicode`字符串的支持，例如：中文。 # Bug Fix 1. 修复`Server`的视图对象配置失效问题。 1. 修复`Server`中间件在中间件`panic`情况下，忽略`Middleware.Next`方法控制，导致鉴权中间件失效的问题。 1. 修复`gudp.Server`在请求包大小超过`64bytes`时的断包问题，并调整默认缓冲区大小为`1024byte`，开发者可自定义缓冲区大小。 1. 修复`gfile.MTimeMillisecond`方法返回错误的文件修改毫秒时间戳。 1. 修复`gconv.Int64`对负数转换的支持。 1. 其他一些修复。 1. 详见：https://github.com/gogf/gf/issues?q=label%3Abug # `v1.11.2` (2020-01-14) `GF(Go Frame)` https://goframe.org 是一款模块化、高性能、生产级的Go基础开发框架。实现了比较完善的基础设施建设，包括常用的核心开发组件， 如：缓存、日志、文件、时间、队列、数组、集合、字符串、定时器、命令行、文件锁、内存锁、对象池、连接池、资源管理、数据校验、数据编码、文件监控、 定时任务、数据库ORM、TCP/UDP组件、进程管理/通信、并发安全容器等等。 并提供了Web服务开发的系列核心组件，如：Router、Cookie、Session、Middleware、服务注册、配置管理、模板引擎等等， 支持热重启、热更新、多域名、多端口、多服务、HTTPS、Rewrite等特性。 `GF`有着丰富的基础模块、完善的工具链、详尽的开发文档。开源近两年以来，`GF`得到越来越多小伙伴的肯定和支持，从寂寂无名到现在被广泛应用于微服务、物联网、区块链、电商系统、银行系统等企业级的生产项目中，经历了百万级、千万级项目的考验，2019年度被码云`gitee`评选为`GVP`最有价值开源项目。`GF`正在快速地成长中，目前保持着1-2个月迭代版本的发布规律，社区活跃，欢迎加入`GF`大家庭。 最后，祝大家2020新年快乐，鼠年大吉！ ## 新特性 1. 新年新气象，官网文档大量更新：https://goframe.org/index 1. `GF`工具链更新：https://goframe.org/toolchain/cli - 新增`gf run`热编译运行命令； - 新增`gf docker` Docker镜像编译命令； - 新增`gf gen model` 强大的模型自动生成命令； - `gf build`命令增加对配置文件配置支持； - 大量命令行工具改进工作； - 新增自动代理设置特性； 1. 数据库`ORM`新特性： - 增加`prefix`数据表前缀支持：https://goframe.org/database/gdb/config - 新增`Schema`数据库对象并改进数据库切换特性：https://goframe.org/database/gdb/chaining/schema - 新增`WherePri`方法，用于自动识别主键的条件方法：https://goframe.org/database/gdb/chaining/select - 文档及示例大量更新，覆盖95%以上的功能特性； ## 功能改进 ### `container` 1. `garray` - 新增`New*ArrayRange`方法，用于初始化创建指定数值范围的数组。 - 新增`Iterator*`方法，用于数组项元素回调遍历。 - 完善单元测试。 1. `gvar` - 改进`MapStrStr`、`MapStrStrDeep`方法实现。 ### `net` 1. `ghttp` - 改进HTTP客户端，增加对提交参数的自动`Content-Type`识别功能。 - `Request`对象增加`Parse`方法，用于快捷的对象转换即参数校验。 - `Request.GetPost*`方法全部标记为`deprecated`，统一客户端参数提交方式为`QueryString`, `Form`, `Body`。 - 去掉`Response`模板解析时的`Get`/`Post`内置变量，新增`Query`, `Form`, `Request`内置变量：https://goframe.org/net/ghttp/response/template - 改进`Response.WriteJson*`及`Response.WriteXml*`方法，增加对`string`, `[]byte`类型参数的支持。 - `Server`新增`GetRouterArray`方法，用于向应用层暴露并获取`Server`的路由列表。 - `Server`新增`Use`方法，该方法为`BindMiddlewareDefault`的别名，用以全局中间件的注册。 - `Server`新增`RouteOverWrite`配置项，用于控制是否在注册路由冲突时自动覆盖，默认关闭并提示。 - `Server`新增`Graceful`配置项，用于在单服务场景下控制平滑重启特性的开启/关闭，默认开启。 - 完善单元测试。 1. `gtcp` - 改进简单协议下的数据包发送接收功能。 - 将连接池默认的缓存过期时间`30`秒修改为`10`秒。 - 完善单元测试。 ### `database` 1. `gdb` - 新增`As`数据表别名方法。 - 改进数据表、字段的安全字符自动识别添加功能。 - 新增`DB`数据库对象切换方法。 - 新增`TX`链式操作事务支持方法。 - 完善单元测试。 ### `os` 1. `gcfg` - 新增`GetMapStrStr`方法。 1. `gcmd` - 增加参数解析的`strict`严格参数，默认严格解析，不存在指定参数/选项名称时则报错返回。 1. `genv` - 改进`Remove`方法支持多个环境变量的删除。 1. `gfile` - 改进`TempDir`临时目录获取方法，在`*nix`系统下默认为`/tmp`目录。 - 新增`ReadLines`, `ReadByteLines`方法，用以按行回调读取文件内容。 - 新增`Copy*`方法，用以文件/目录的拷贝，支持递归。 - 新增`Replace*`方法，用以目录下的文件内容替换，支持递归。 - 改进`Scan*`方法，用以检索并返回指定目录下的所有文件/目录，支持文件模式指定，支持递归。 - 完善单元测试。 1. `gproc` - 改进命令行运行方法。 - 改进`Shell`命令文件检索逻辑。 - 改进实验性的进程间通信设计。 1. `gtime` - 将包方法以及`Time`对象的时间戳方法`Second`, `Millisecond`, `Microsecond`, `Nanosecond`标记为废除， 并新增`Timestamp`, `TimestampMilli`, `TimestampMicro`, `TimestampNano`替换。 - 需要注意的是以上修改可能和老版本存在兼容性问题。 1. `gview` - 解析功能、缓存设计改进。 - 新增`encode`, `decode`HTML编码/解码模板函数。 - 新增`concat`字符串拼接模板函数。 - 新增`dump`模板函数，功能类似于`g.Dump`方法。 - 新增`AutoEncode`配置项，用于自动转码输出的`HTML`内容，常用于防止`XSS`，默认关闭。需要注意的是该特性并不会影响`include`内置函数: https://goframe.org/os/gview/xss - 单元测试完善。 ### `crypto` 1. `gmd5` - 增加`MustEncrypt`, `MustEncryptBytes`, `MustEncryptString`, `MustEncryptFile`方法。 1. `gsha1` - 增加`MustEncryptFile`方法 ### `encoding` 1. `gbase64` - 新增`MustEncodeFile`, `MustEncodeFileToString`, `MustDecode`, `MustDecodeToString`方法。 1. `gjson`/`gparser` - 新增`GetMapStrStr`方法。 - 新增`Must*`方法，用于指定数据格式的转换失败时产生`panic`错误，而不会返回`error`参数。 ### `util` 1. `gconv` - 改进`Convert`方法增加对`[]int32`, `[]int64`, `[]uint`, `[]uint32`, `[]uint64`, `[]float32`, `[]float64`数据类型的转换支持。 - 改进`String`字符串转换方法对指针参数的支持。 - 改进`Map*` Map转换方法的代码结构及性能。 - 新增`Floats`, `Float32s`, `Float64s`对`[]float32`, `[]float64`类型转换方法。 - 新增`Ints`, `Int32s`, `Int64s`对`[]int`, `[]int32`, `[]int64`类型转换方法。 - 新增`Uints`, `Uint32s`, `Uint64s`对`[]uint`, `[]uint32`, `[]uint64`类型转换方法。 - 完善单元测试。 ### `frame` 1. `gins` - 所有的单例对象在获取失败时产生`panic`错误。 ## Bug Fix 1. 增加对常见错误路由格式例如`/user//index`的兼容支持。 1. 修复`gtcp`/`gudp`在数据接收时的间隔时间单位问题。 1. 修复`gfile`/`gspath`/`gfsnotify`包对文件的存在性判断不严谨问题。 1. 修复`gproc.Kill`方法在`windows`系统下的运行阻塞问题。 1. 修复`gstr.TrimLeftStr`/`gstr.TrimRightStr`在被替换字符串长度小于替换字符串长度时的数组溢出问题。 # `v1.10.0` (2019-12-05) 各位`gfer`久等了，较上一次发布时间过去已有两个多月了，这段时间`GF`也在不断地迭代改进，细节比较多，拟了个大概，以下是`release log`。 另外，`GoFrame`也参加了2019最受欢迎中国开源软件评选投票，明天就结束了，欢迎为`GF`投票啊：https://www.oschina.net/project/top_cn_2019 网页可以投一票，微信也可以投一票。 ## 新特性 1. `Web Server`新特性： - 改进中间件及分组路由实现：https://goframe.org/net/ghttp/router/middleware - 增加文件配置管理特性：https://goframe.org/net/ghttp/config - 改进参数获取：https://goframe.org/net/ghttp/request - 改进文件上传：https://goframe.org/net/ghttp/client/demo/upload 1. `Session`增加内置的多种`Storage`实现： - 基本介绍：https://goframe.org/os/gsession/index - 文件存储：https://goframe.org/os/gsession/file - 内存存储：https://goframe.org/os/gsession/memory - `Redis`存储：https://goframe.org/os/gsession/redis 1. 增加日志组件单例对象，并优化配置管理： - https://goframe.org/frame/g/index - https://goframe.org/os/glog/config 1. 常用的`container`容器增加`JSON`数据格式的`Marshal`/`UnMarshal`接口实现： - https://goframe.org/container/gmap/index - https://goframe.org/container/garray/index - https://goframe.org/container/gset/index - https://goframe.org/container/gvar/index - https://goframe.org/container/gtype/index - https://goframe.org/container/glist/index - https://goframe.org/container/gvar/index 1. 新增`guuid`模块，用于通用的`UUID`生成：https://goframe.org/util/guuid/index ## 功能改进 ### `net` 1. `ghttp` - 改进请求流程处理性能； - `Server`增加对`Logger`日志对象的配置； - `Server`开放了`GetRouterMap`方法，用于获得当前服务的路由列表信息，使得开发者可以更方便地实现自定义权限管理； - `Server`配置管理优化； - `Client`客户端对象进行了大量的改进工作； - `Client`客户端对象增加多文件上传功能； - `Request`对象增加`GetError`方法，用于获取当前处理错误； - `Request`对象增加独立的视图对象及视图变量绑定功能，使得每个请求可以独立视图管理，也可以通过中间件切换请求对象的视图对象。默认情况下该功能关闭，视图解析时使用的是`Server`对象的视图对象； - 改建`Response`对象的`CORS`功能； - 增加`Response.WriteTplDefault`方法，用于解析并返回默认的模板内容； - 增加更多的单元测试用例； - 其他改进； 1. `gipv4`/`gipv6` - 一些改进工作； 1. `gtcp`/`gudp` - 一些改进工作； ### `database` 1. `gdb` - 大量细节改进工作； - 去掉查询数据为空时的`sql.ErrNoRows`错误返回，保留`Struct`/`Structs`/`Scan`方法在操作数据为空的该错误返回； - 调试模式开启时，输出的SQL语句改进为完整的带参数的SQL，仅作参考； - `Where`方法增加对`gmap`数据类型支持，包括顺序性的`ListMap`/`TreeMap`等等； - 查询缓存方法`Cache`的缓存时间参数类型修改为`time.Duration`； - 修改`Record`/`Result`的数据类型转换方法名称，原有的转换方法标记为`deprecated`； - `Record`/`Result`查询结果类型增加`IsEmpty`方法，用于判断结果集是否为空； - `Record`类型增加`GMap`方法，用于将查询记录转换为`gmap`类型； - 增加`Option`/`OptionOmitEmpty`方法，用于输入参数过滤，包括`Data`参数及`Where`参数：https://goframe.org/database/gdb/empty - 增加字段排除方法`FieldsEx`：https://goframe.org/database/gdb/senior - 增加日志功能特性：https://goframe.org/database/gdb/senior - 改进数据库配置管理：https://goframe.org/database/gdb/config - 增加大量单元测试； 1. `gredis` - 返回数据类型转换改进：https://github.com/gogf/gf/issues/415 - 完善单元测试； - 其他改进； ### `os` 1. `gcache` - 需要注意了：缓存的有效时间参数从`interface{}`类型调整为了`time.Duration`类型，因此不再兼容之前的`int`参数类型，以保证更好的性能； 1. `gfcache` - 由于`gcache`组件的缓存时间参数类型的变更，因此该组件的时间参数也变更为了`time.Duration`类型； 1. `gcfg` - 增加`Available`方法，用以判断配置是否有效； 1. `gfile` - 增加`Chdir`方法，用于工作目录切换； 1. `gtime` - 增加`JSON`数据格式的`Marshal`/`UnMarshal`接口实现； ### `container` 1. `gmap` - 增加`MapStrAny`方法，用于常见`map`类型的转换； - 增加`MapCopy`方法，用于底层`map`数据复制； - 增加`FilterEmpty`方法，用于`map`空值过滤； - 增加`Pop`/`Pops`方法，用于随机返回`map`中的数据项（并删除）； - 增加`Replace`方法，用于给定的`map`数据覆盖底层`map`数据项； - 完善单元测试； - 其他改进； 1. `garray` - 增加`Interfaces`转换方法，返回`[]interface{}`类型； - 对排序数组增加`SetComparator`方法用户自定义修改比较器； - 完善单元测试； - 其他改进； 1. `glist` - 增加`NewFrom`方法，基于给定的`[]interface{}`变量创建链表； - 增加`Join`方法，用于将链表项使用给定字符串连接为字符串返回； - 完善单元测试； - 其他改进； 1. `gset` - 增加`AddIfNotExistFunc`/`AddIfNotExistFuncLock`方法； - 完善单元测试； - 其他改进； 1. `gtree` - 增加`Replace`方法，用于更新现有树的数据项； - 其他改进； 1. `gtype` - 一些细节改进工作，不一一列出； - 完善基准测试、单元测试； 1. `gvar` - 增加`Ints`/`Uints`类型转换方法； - 其他改进； ### `crypto` 1. `gmd5` - 小细节改进； 1. `gsha1` - 小细节改进； ### `text` 1. `gstr` - 改进`SplitAndTrim`方法，将`SplitAndTrimSpace`标记为`deprecated`； - 增加`TrimStr`方法； - 完善单元测试； - 其他改进； ### `debug` 1. `gdebug` - 增加`CallerFileLineShort`/`FuncPath`/`FuncName`方法； - 其他改进； ### `encoding` 1. `gbase64` - 增加`EncodeToString`/`EncodeFile`/`EncodeFileToString`/`DecodeToString`方法； - 完善单元测试； 1. `gjson` - 完善单元测试； ### `frame` 1. `g`/`gins` - https://goframe.org/frame/g/index - 增加`CreateVar`方法； - 完善单元测试； - 其他改进； ### `util` 1. `gconv` - 改进优化部分类型转换方法性能； - 增加`Uints`/`SliceUint`类型转换方法； - 增加`UnsafeStrToBytes`/`UnsafeBytesToStr`高性能的类型转换方法； - 增加对`MapStrAny`接口方法的支持，用于常见`map`类型的转换； - 其他改进； 1. `gvalid` - 改进对中国身份证号的识别校验功能； - 增加`luhn`银行卡号的校验功能； 1. `grand` - 一些性能改进工作； ## Bug Fix 1. 解决`WebSocket`关闭时的`hijacked`报错问题：https://github.com/gogf/gf/issues/381 1. 解决静态文件服务时大文件的内存占用问题； 1. 修复前置`Nginx`后默认情况下的`Cookie`域名设置问题； 1. 修复`gconv.Struct`在属性为`[]struct`并且输入属性参数为空时的转换失败问题：https://github.com/gogf/gf/issues/405 1. 其他一些修复； # `v1.9.3` (2019-09-24) 该版本实际为`v2.0`的大版本发布，为避免`go module`机制严格要求`v2`版本以上需要修改`import`并加上`v2`后缀，因此使用了`v1.9`版本进行发布。 ## 新特性 1. 新增`gf`命令行开发辅助工具：https://goframe.org/toolchain/cli 1. 新增`gres`资源管理器模块：https://goframe.org/os/gres/index 1. 重构`Session`功能，新增`gsession`模块，`WebServer`默认使用文件存储`Session`：https://goframe.org/net/ghttp/session 1. `WebServer`新增中间件特性，并保留原有的HOOK设计，两者都可实现请求拦截、预处理等等特性：https://goframe.org/net/ghttp/router/middleware 1. 新增`gi18n`国际化管理模块：https://goframe.org/i18n/gi18n/index 1. 新增`gini`模块：https://goframe.org/encoding/gini/index 1. `WebServer`新增更便捷的层级路由注册方式：https://goframe.org/net/ghttp/group/level 1. `gcmd`命令行参数解析模块重构，增加`Parser`解析对象：https://goframe.org/os/gcmd/index 1. 新增`gdebug`模块，用于堆栈信息获取/打印：https://goframe.org/debug/gdebug/index ## 重大调整 1. 去掉`1.x`版本中已经被标记为`deprecated`的方法； 1. 调整`container`分类的容器模块，将默认并发安全参数调整为默认非并发安全； 1. 目录调整: - 去掉`third`目录，统一使用`go module`管理包依赖； - 将原有`g`目录中的模块移出到框架主目录，原有的`g`模块移动到`frame/g`目录； - 将原有`geg`示例代码目录名称修改为`.example`； ## 功能改进 1. `ghttp` - 改进`Request`参数解析方式：https://goframe.org/net/ghttp/request - 改进跨域请求功能，新增`Origin`设置及校验功能：https://goframe.org/net/ghttp/cors - `Cookie`及`Session`的`TTL`配置数据类型修改为`time.Duration`; - 新增允许同时通过`Header/Cookie`传递`SessionId`； - 新增`ConfigFromMap/SetConfigWithMap`方法，支持通过`map`参数设置WebServer； - 改进默认的`CORS`配置，增加对常见`Header`参数的默认支持； - 新增`IsExitError`方法，用于开发者自定义处理`recover`错误处理时，过滤框架本身自定义的非异常错误； - 新增`SetSessionStorage`配置方法，用于开发者自定义`Session`存储； - `ghttp.Request`新增更多的参数获取方法； 1. `gdb` - 增加对SQL中部分字段的自动转义(`Quote`)功能； - 增加对方法操作以及链式操作中的`slice`参数的支持； - 增加`SetLogger`方法用于开发者自定义数据库的日志打印； - 增加`Master/Slave`方法，开发者可自主选择数据库操作执行的主从节点； - 增加对`mssql/pgsql/oracle`的单元测试； - 在`debug`模式支持完整带参数整合的SQL语句调试打印； - 增加了更多的功能方法； 1. `glog` - 新增`Default`方法用于获取默认的`Logger`对象； - 新增`StackWithFilter`方法用于自定义堆栈打印过滤； - 增加了更多的功能方法； 1. `gfile` - 部分方法名称调整：`Get/PutBinContents`修改为`Get/PutBytes`； - 增加`ScanDirFile`方法，用于仅检索文件目录，支持递归检索； - 增加了更多的功能方法； 1. `gview` - 新增`SetI18n`方法用于设置视图对象自定义的`gi18n`国际化对象； - 新增对`gres`资源管理器的内置支持； 1. `gcompress` - 增加`zip`算法的文件/目录的压缩/解压方法； - 文件/目录压缩参数支持多路径； 1. `gconv` - 改进对`[]byte`数据类型参数的支持； - 新增`Unsafe`转换方法，开发者可在特定场景下使用，提高转换效率； - 新增`MapDeep/StructDeep/StructsDeep`方法，支持递归`struct`转换； 1. `gjson/gparser` - 改进类型自动识别功能； - 新增`LoadJson/LoadXml/LoadToml/LoadYaml/LoadIni`方法用于自定义的数据类型内容加载； - 增加了更多的功能方法； 1. `gerror` - 改进错误堆栈获取逻辑； - 增加了更多的功能方法； 1. `gmap/garray/gset/glist/gvar` - 改进并发安全基准测试脚本； - 修改`garray.StringArray`为`garray.StrArray`； - 增加了更多的功能方法； 1. `gdes` - 规范化修改方法名称； 1. `gstr` - 增加`Camel/Snake`相关命名转换方法； - 增加了更多的功能方法； 1. `genv` - 增加了更多的功能方法； ## Bug Fix 1. 修复`gvalid`校验`struct`时的`tag`自定义错误失效的问题； 1. 修复`gcfg`配置管理模块在特定情况下的内容类型自动识别失败问题； 1. 修复`gqueue`在用户主动关闭队列时的并发安全问题； 1. 修复`session`在开发者设置的`TTL`过大时的整型变量溢出问题；