README_zh-CN.md

Baa

一个简单高效的Go web开发框架。主要有路由、中间件，依赖注入和HTTP上下文构成。

Baa 不使用 反射和正则，没有魔法的实现。

文档

• 简体中文
• English
• godoc

快速上手

安装：

go get -u github.com/go-baa/baa

示例：

// baa.go
package main

import (
    "github.com/go-baa/baa"
)

func main() {
    app := baa.New()
    app.Get("/", func(c *baa.Context) {
        c.String(200, "Hello, 世界")
    })
    app.Run(":1323")
}

运行:

go run baa.go

浏览:

http://127.0.0.1:1323/

特性

• 支持静态路由、参数路由、组路由（前缀路由/命名空间）和路由命名
• 路由支持链式操作
• 路由支持文件/目录服务
• 中间件支持链式操作
• 支持依赖注入*
• 支持JSON/JSONP/XML/HTML格式输出
• 统一的HTTP错误处理
• 统一的日志处理
• 支持任意更换模板引擎（实现baa.Renderer接口即可）

示例

https://github.com/go-baa/example

• blog
• api
• websocket

中间件

• gzip
• accesslog
• recovery
• session
• static
• requestcache
• nocache
• jwt
• cors
• authz

组件

• cache
• render
• pongo2
• router
• pool
• bat
• log
• setting

性能测试

路由测试

使用 [go-http-routing-benchmark] (https://github.com/safeie/go-http-routing-benchmark) 测试, 2016-02-27 更新.

GitHub API

Baa的路由性能非常接近 Echo.

BenchmarkBaa_GithubAll          	   30000	     50984 ns/op	       0 B/op	       0 allocs/op
BenchmarkBeego_GithubAll        	    3000	    478556 ns/op	    6496 B/op	     203 allocs/op
BenchmarkEcho_GithubAll         	   30000	     47121 ns/op	       0 B/op	       0 allocs/op
BenchmarkGin_GithubAll          	   30000	     41004 ns/op	       0 B/op	       0 allocs/op
BenchmarkGocraftWeb_GithubAll   	    3000	    450709 ns/op	  131656 B/op	    1686 allocs/op
BenchmarkGorillaMux_GithubAll   	     200	   6591485 ns/op	  154880 B/op	    2469 allocs/op
BenchmarkMacaron_GithubAll      	    2000	    679559 ns/op	  201140 B/op	    1803 allocs/op
BenchmarkMartini_GithubAll      	     300	   5680389 ns/op	  228216 B/op	    2483 allocs/op
BenchmarkRevel_GithubAll        	    1000	   1413894 ns/op	  337424 B/op	    5512 allocs/op

HTTP测试

代码

Baa:

package main

import (
	"github.com/go-baa/baa"
)

func main() {
	app := baa.New()
    app.Get("/", func(c *baa.Context) {
        c.String(200, "Hello, 世界")
    })
    app.Run(":1323")
}

测试结果:

$ wrk -t 10 -c 100 -d 30 http://127.0.0.1:1323/
Running 30s test @ http://127.0.0.1:1323/
  10 threads and 100 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency     1.64ms  299.23us   8.25ms   66.84%
    Req/Sec     6.11k   579.08     8.72k    68.74%
  1827365 requests in 30.10s, 228.30MB read
Requests/sec:  60704.90
Transfer/sec:      7.58MB

案例

目前使用在 健康一线 的私有项目中。

贡献

Baa的灵感来自 beego echo macaron

• safeie、micate - Author
• betty - Language Consultant
• Contributors

License

This project is under the MIT License (MIT) See the LICENSE file for the full license text.