v1.10.0

各位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
2. 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
3. 增加日志组件单例对象，并优化配置管理：
   • https://goframe.org/frame/g/index
   • https://goframe.org/os/glog/config
4. 常用的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
5. 新增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方法，用于解析并返回默认的模板内容；
   • 增加更多的单元测试用例；
   • 其他改进；
2. gipv4/gipv6
   • 一些改进工作；
3. 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
   • 增加大量单元测试；
2. gredis
   • 返回数据类型转换改进：https://github.com/gogf/gf/issues/415
   • 完善单元测试；
   • 其他改进；

os

1. gcache
   • 需要注意了：缓存的有效时间参数从interface{}类型调整为了time.Duration类型，因此不再兼容之前的int参数类型，以保证更好的性能；
2. gfcache
   • 由于gcache组件的缓存时间参数类型的变更，因此该组件的时间参数也变更为了time.Duration类型；
3. gcfg
   • 增加Available方法，用以判断配置是否有效；
4. gfile
   • 增加Chdir方法，用于工作目录切换；
5. gtime
   • 增加JSON数据格式的Marshal/UnMarshal接口实现；

container

1. gmap
   • 增加MapStrAny方法，用于常见map类型的转换；
   • 增加MapCopy方法，用于底层map数据复制；
   • 增加FilterEmpty方法，用于map空值过滤；
   • 增加Pop/Pops方法，用于随机返回map中的数据项（并删除）；
   • 增加Replace方法，用于给定的map数据覆盖底层map数据项；
   • 完善单元测试；
   • 其他改进；
2. garray
   • 增加Interfaces转换方法，返回[]interface{}类型；
   • 对排序数组增加SetComparator方法用户自定义修改比较器；
   • 完善单元测试；
   • 其他改进；
3. glist
   • 增加NewFrom方法，基于给定的[]interface{}变量创建链表；
   • 增加Join方法，用于将链表项使用给定字符串连接为字符串返回；
   • 完善单元测试；
   • 其他改进；
4. gset
   • 增加AddIfNotExistFunc/AddIfNotExistFuncLock方法；
   • 完善单元测试；
   • 其他改进；
5. gtree
   • 增加Replace方法，用于更新现有树的数据项；
   • 其他改进；
6. gtype
   • 一些细节改进工作，不一一列出；
   • 完善基准测试、单元测试；
7. gvar
   • 增加Ints/Uints类型转换方法；
   • 其他改进；

crypto

1. gmd5
   • 小细节改进；
2. gsha1
   • 小细节改进；

text

1. gstr
   • 改进SplitAndTrim方法，将SplitAndTrimSpace标记为deprecated；
   • 增加TrimStr方法；
   • 完善单元测试；
   • 其他改进；

debug

1. gdebug
   • 增加CallerFileLineShort/FuncPath/FuncName方法；
   • 其他改进；

encoding

1. gbase64
   • 增加EncodeToString/EncodeFile/EncodeFileToString/DecodeToString方法；
   • 完善单元测试；
2. gjson
   • 完善单元测试；

frame

1. g/gins
   • https://goframe.org/frame/g/index
   • 增加CreateVar方法；
   • 完善单元测试；
   • 其他改进；

util

1. gconv
   • 改进优化部分类型转换方法性能；
   • 增加Uints/SliceUint类型转换方法；
   • 增加UnsafeStrToBytes/UnsafeBytesToStr高性能的类型转换方法；
   • 增加对MapStrAny接口方法的支持，用于常见map类型的转换；
   • 其他改进；
2. gvalid
   • 改进对中国身份证号的识别校验功能；
   • 增加luhn{敏感词}号的校验功能；
3. grand
   • 一些性能改进工作；

Bug Fix

1. 解决WebSocket关闭时的hijacked报错问题：https://github.com/gogf/gf/issues/381
2. 解决静态文件服务时大文件的内存占用问题；
3. 修复前置Nginx后默认情况下的Cookie域名设置问题；
4. 修复gconv.Struct在属性为[]struct并且输入属性参数为空时的转换失败问题：https://github.com/gogf/gf/issues/405
5. 其他一些修复；

GF(Go Frame)是一款模块化、高性能、生产级Go应用开发框架。提供了常用的核心开发组件，如：缓存、日志、文件、时间、队列、数组、集合、字符串、定时器、命令行、文件锁、内存锁、对象池、连接池、资源管理、数据校验、数据编码、文件监控、定时任务、数据库ORM、TCP/UDP组件、进程管理/通信、 并发安全容器等等。并提供了Web服务开发的系列核心组件，如：Router、Cookie、Session、Middleware、服务注册、配置管理、模板引擎等等，支持热重启、热更新、多域名、多端口、多服务、HTTPS、Rewrite等特性。

特点

• 模块化、松耦合设计；
• 模块丰富，开箱即用；
• 详尽的开发文档及示例；
• 完善的本地中文化支持；
• 致力于项目的通用方案；
• 更适合企业及团队使用；
• 更多请查阅文档及源码；

安装

go get -u -v github.com/gogf/gf

推荐使用 go.mod:

require github.com/gogf/gf latest

限制

golang版本 >= 1.10

架构

文档

开发文档：https://goframe.org

接口文档：https://godoc.org/github.com/gogf/gf

使用

package main

import (
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/net/ghttp"
)

func main() {
    s := g.Server()
    s.BindHandler("/", func(r *ghttp.Request) {
        r.Response.Write("Hello World")
    })
    s.Run()
}

更多..

协议

GF 使用非常友好的 MIT 开源协议进行发布，永久100%开源免费。