gf

package module

v0.0.0-...-c9a36a8 Latest Latest Go to latest Published: Jun 27, 2018 License: MIT Imports: 0 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

gitee.com/limingsky/gf

Links

Open Source Insights

README ¶

安装

go get -u gitee.com/johng/gf

介绍

gf是一款模块化、松耦合、轻量级、高性能的Web开发框架。开源项目地址(仓库保持实时同步)： Gitee，Github

使用中有任何问题/建议，欢迎加入技术QQ群交流：116707870。如有优秀的框架使用案例，欢迎联系作者将地址展示到项目库中，您的牛逼将被世人所瞻仰。

特点

轻量级、高性能，模块化、松耦合设计，丰富的开发模块；
热重启、热更新特性，并支持Web界面及命令行管理接口；
专业的技术交流群，完善的开发文档，良好的中文化支持；
支持多种形式的服务注册特性，灵活高效的路由控制管理；
支持服务事件回调注册功能，可供选择的pprof性能分析模块；
支持配置文件及模板文件的自动检测更新机制，即修改即生效；
强大的数据/表单校验模块，支持常用的40种及自定义校验规则；
提供了对基本数据类型的并发安全封装，提供了常用的并发安全容器；
支持Go变量/Json/Xml/Yml/Toml任意数据格式之间的相互转换及创建；
强大的数据库管理模块，支持应用层级的集群管理、读写分离、负载均衡，方法及链式ORM操作；
更多特点请查阅框架手册( http://gf.johng.cn )；

文档

贡献

gf是开源的、免费的软件，这意味着任何人都可以为其开发和进步贡献力量。 gf的项目源代码目前同时托管在 Gitee 和 Github 平台上，您可以选择您喜欢的平台来 fork 项目和合并你的贡献，两个平台的仓库将会保持即时的同步。我们非常欢迎有更多的朋友加入到gf框架的开发中来，您为gf所做出的任何贡献都将会被记录到gf的史册中。

使用

哈喽世界！

package main

import (
    "gitee.com/johng/gf/g"
    "gitee.com/johng/gf/g/net/ghttp"
)

func main() {
    s := g.Server()
    s.BindHandler("/", func(r *ghttp.Request) {
        r.Response.Write("哈喽世界！")
    })
    s.Run()
}

多域名支持

package main

import (
    "gitee.com/johng/gf/g"
    "gitee.com/johng/gf/g/net/ghttp"
)

func main() {
    s := g.Server()
    s.Domain("localhost1，localhost2，localhost3").BindHandler("/", func(r *ghttp.Request) {
        r.Response.Write("localhostx")
    })
    s.Run()
}

多端口支持

package main

import (
    "gitee.com/johng/gf/g"
    "gitee.com/johng/gf/g/net/ghttp"
)

func main() {
    s := g.Server()
    s.BindHandler("/", func(r *ghttp.Request){
        r.Response.Writeln("go frame!")
    })
    s.SetPort(8080, 8081, 8082)
    s.Run()
}

服务注册

package main

import (
    "gitee.com/johng/gf/g/net/ghttp"
    "gitee.com/johng/gf/g/frame/gmvc"
)

// 定义业务相关的控制器对象
type ControllerUser struct {
    gmvc.Controller
}

// 定义操作逻辑 - 展示姓名
func (c *ControllerUser) Name() {
    c.Response.Write("John")
}

func main() {
    // 绑定控制器到指定URI，所有控制器的公开方法将会映射到指定URI末尾
    // 例如该方法执行后，查看效果可访问：
    // http://127.0.0.1:8199/user/name
    s := ghttp.GetServer()
    s.BindController("/user", &ControllerUser{})
    s.Run()
}

路由控制

package main

import "gitee.com/johng/gf/g/net/ghttp"

func main() {
    s := ghttp.GetServer()
    s.BindHandler("/:name/:action", func(r *ghttp.Request){
        r.Response.Write(r.Get("name"))
        r.Response.Write(r.Get("action"))
    })
    s.SetPort(8199)
    s.Run()
}

模板引擎

package main

import (
    "gitee.com/johng/gf/g/net/ghttp"
    "gitee.com/johng/gf/g/frame/gmvc"
)

type ControllerTemplate struct {
    gmvc.Controller
}

func (c *ControllerTemplate) Info() {
    c.View.Assign("name", "john")
    c.View.Assigns(map[string]interface{}{
        "age"   : 18,
        "score" : 100,
    })
    c.View.DisplayContent(`
        <html>
            <head>
                <title>gf template engine</title>
            </head>
            <body>
                <p>Name: {{.name}}</p>
                <p>Age:  {{.age}}</p>
                <p>Score:{{.score}}</p>
            </body>
        </html>
    `)
}

func main() {
    s := ghttp.GetServer()
    s.BindController("/template", &ControllerTemplate{})
    s.SetPort(8199)
    s.Run()
}

数据校验

rule := "url|min-length:11"
msgs := map[string]string{
    "url"       : "请输入正确的URL地址",
    "minlength" : "地址长度至少为:min位"
}
fmt.Println(gvalid.Check("http://gfjohngcn", rule, msgs))

数据库ORM

链式操作

ORM单例对象

// 获取默认配置的数据库对象(配置名称为"default")
db, err := gdb.New()
// 获取配置分组名称为"user-center"的数据库对象
db, err := gdb.New("user-center")

单表/联表查询

// 查询多条记录并使用Limit分页
r, err := db.Table("user").Where("u.uid > ?", 1).Limit(0, 10).Select()
// 查询符合条件的单条记录(第一条)
r, err := db.Table("user u").LeftJoin("user_detail ud", "u.uid=ud.uid").Fields("u.*,ud.site").Where("u.uid=?", 1).One()
// 查询指定字段值
r, err := db.Table("user u").RightJoin("user_detail ud", "u.uid=ud.uid").Fields("ud.site").Where("u.uid=?", 1).Value()
// 分组及排序
r, err := db.Table("user u").InnerJoin("user_detail ud", "u.uid=ud.uid").Fields("u.*,ud.city").GroupBy("city").OrderBy("register_time asc").Select()
// 不使用john的联表查询
r, err := db.Table("user u,user_detail ud").Where("u.uid=ud.uid").Fields("u.*,ud.city").All()
// 不使用Fields方法指定查询字段时，默认查询为"*"
r, err := db.Table("user").Where("u.uid=1",).One()

like查询

r, err := db.Table("user").Where("name like ?", "%john%").Select()

链式更新/删除

// 更新
r, err := db.Table("user").Data(gdb.Map{"name" : "john2"}).Where("name=?", "john").Update()
r, err := db.Table("user").Data("name='john3'").Where("name=?", "john2").Update()
// 删除
r, err := db.Table("user").Where("uid=?", 10).Delete()
// Data数值方法的参数形式比较灵活
r, err := db.Table("user").Data(`name="john"`).Update()
r, err := db.Table("user").Data("name", "john").Update()
r, err := db.Table("user").Data(g.Map{"name" : "john"}).Update()

链式写入/保存

r, err := db.Table("user").Data(gdb.Map{"name": "john"}).Insert()
r, err := db.Table("user").Data(gdb.Map{"uid": 10000, "name": "john"}).Replace()
r, err := db.Table("user").Data(gdb.Map{"uid": 10001, "name": "john"}).Save()

链式批量写入

r, err := db.Table("user").Data(gdb.List{
    {"name": "john_1"},
    {"name": "john_2"},
    {"name": "john_3"},
    {"name": "john_4"},
}).Insert()

链式批量保存

r, err := db.Table("user").Data(gdb.List{
    {"uid":10000, "name": "john_1"},
    {"uid":10001, "name": "john_2"},
    {"uid":10002, "name": "john_3"},
    {"uid":10003, "name": "john_4"},
}).Save()

事务操作

开启事务操作

if tx, err := db.Begin(); err == nil {
    fmt.Println("开启事务操作")
}

事务回滚操作

if tx, err := db.Begin(); err == nil {
    r, err := tx.Save("user", gdb.Map{
        "uid"  :  1,
        "name" : "john",
    })
    tx.Rollback()
    fmt.Println(r, err)
}

事务提交操作

if tx, err := db.Begin(); err == nil {
    r, err := tx.Save("user", gdb.Map{
        "uid"  :  1,
        "name" : "john",
    })
    tx.Commit()
    fmt.Println(r, err)
}

事务链式操作

if tx, err := db.Begin(); err == nil {
    r, err := tx.Table("user").Data(gdb.Map{"uid":1, "name": "john"}).Save()
    tx.Commit()
    fmt.Println(r, err)
}

数据编码解析

// JSON
data :=
    `{
        "users" : {
            "count" : 100,
            "list"  : [
                {"name" : "Ming", "score" : 60},
                {"name" : "John", "score" : 99.5}
            ]
        }
    }`

if p, e := gparser.LoadContent([]byte(data), "json"); e != nil {
    glog.Error(e)
} else {
    fmt.Println("John Score:", p.GetFloat32("users.list.1.score"))
}

// XML
data :=
    `<?xml version="1.0" encoding="UTF-8"?>
     <note>
         <to>Tove</to>
         <from>Jani</from>
         <heading>Reminder</heading>
         <body>Don't forget me this weekend!</body>
     </note>`

if p, e := gparser.LoadContent([]byte(data), "xml"); e != nil {
    glog.Error(e)
} else {
    fmt.Println("Heading:", p.GetString("note.heading"))
}

...

更多特性及示例请查看官方开发文档：gf.johng.cn

Documentation ¶

Index ¶

Constants

Constants ¶

View Source

const AUTHORS = "john<john@johng.cn>"

View Source

const VERSION = "0.98 beta"

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

This section is empty.

Source Files ¶

View all Source files

version.go

Directories ¶

Path	Synopsis
g
container
container/garray 并发安全的数组.	并发安全的数组.
container/gchan 优雅的Channel操作.	优雅的Channel操作.
container/glist 并发安全的双向链表.	并发安全的双向链表.
container/gmap 并发安全的哈希MAP.	并发安全的哈希MAP.
container/gqueue 并发安全的动态队列.	并发安全的动态队列.
container/gset 并发安全的集合SET.	并发安全的集合SET.
container/gtype 并发安全的基本类型.	并发安全的基本类型.
database
database/gdb 数据库ORM.	数据库ORM.
database/gkafka Kafka Client.	Kafka Client.
database/gredis Redis客户端.	Redis客户端.
encoding 数据编码/解码.	数据编码/解码.
encoding/gbase64 BASE64	BASE64
encoding/gbinary 二进制及byte操作	二进制及byte操作
encoding/gcharset 字符集转换方法.	字符集转换方法.
encoding/gcompress 数据压缩/解压	数据压缩/解压
encoding/gcrc32 CRC32	CRC32
encoding/gdes
encoding/ghash 常用的hash函数	常用的hash函数
encoding/ghtml HTML编码	HTML编码
encoding/gjson JSON解析/封装.	JSON解析/封装.
encoding/gmd5 MD5	MD5
encoding/gparser 数据文件编码/解析.	数据文件编码/解析.
encoding/gsha1 SHA1	SHA1
encoding/gtoml TOML	TOML
encoding/gurl URL编码	URL编码
encoding/gxml XML	XML
encoding/gyaml YAML	YAML
frame 常用框架管理.	常用框架管理.
frame/gins 单例对象管理.	单例对象管理.
frame/gmvc MVC	MVC
net
net/ghttp HTTP Client & Server.	HTTP Client & Server.
net/gipv4 IPv4	IPv4
net/gipv6 IPv6	IPv6
net/gscanner IP扫描器.	IP扫描器.
net/gsmtp SMTP	SMTP
net/gtcp TCP服务端	TCP服务端
net/gudp UDP服务端	UDP服务端
os
os/gcache 单进程高速缓存.	单进程高速缓存.
os/gcfg 配置管理.	配置管理.
os/gcmd 命令行管理.	命令行管理.
os/genv 环境变量管理	环境变量管理
os/gfile 文件管理.	文件管理.
os/gfilepool 文件指针池	文件指针池
os/gflock 文件锁.	文件锁.
os/gfsnotify 文件监控.	文件监控.
os/glog 日志模块.	日志模块.
os/gmmap MMAP	MMAP
os/gproc 进程管理/通信.	进程管理/通信.
os/grpool Goroutine池.	Goroutine池.
os/gspath 搜索目录管理.	搜索目录管理.
os/gtime 时间管理	时间管理
os/gview 视图管理	视图管理
util
util/gconv 类型转换.	类型转换.
util/gpage 分页管理.	分页管理.
util/grand 随机数管理	随机数管理
util/gregx 正则表达式.	正则表达式.
util/gstr 字符串操作.	字符串操作.
util/gutil 其他工具包	其他工具包
util/gvalid 数据校验.	数据校验.
geg
container
database/elasticsearch
database/kafka
database/mysql
database/redis
encoding
encoding/gbinary
frame/mvc
frame/mvc/controller/demo
net
net/ghttp/client
net/ghttp/client/cookie
net/ghttp/client/upload
net/ghttp/server
net/ghttp/server/https
net/ghttp/server/performance
net/ghttp/server/performance/beego
net/ghttp/server/performance/gf
net/ghttp/server/performance/gin
net/ghttp/server/reload
net/ghttp/server/websocket/echo
os
os/gcfg
os/gflock
os/gfsnotify
os/gproc
os/grpool
os/gtime
os/gview
other
other/docker/test
other/sleep
util/gconv
util/gpage

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL