?chi介绍

chi是一个轻量级、通用和可组合的路由器，用于构建Go HTTP服务。它特别擅长帮助您编写大型REST API服务，这些服务随着项目的增长和变化而保持可维护。chi建立在Go 1.7中引入的新上下文包之上，用于处理处理请求链上的信号、取消和请求范围值等。

该项目的重点是寻找一种优雅舒适的设计来编写REST API服务器，这些设计是在Pressly API服务开发期间编写的，该服务为我们的公共API服务提供动力，而Pressly API服务反过来又为我们所有的客户端应用程序提供动力。

Chi设计的主要考虑因素是：项目结构、可维护性、标准http处理程序（仅限stdlib）、开发人员生产力以及将大型系统解构成许多小部件。核心路由器github.com/go-chi/chi相当小（小于1000 LOC），但我们也包括了一些有用/可选的子包：中间件、渲染和docgen。我们希望您也喜欢它！

?特性

• 轻量级-chi路由器的cloc'd在~1000 LOC

• 快速，请参阅基准测试

• 100%与net/http兼容-使用生态系统中与net/http兼容的任何http或中间件pkg

• 专为模块化/可组合API设计-中间件、内联中间件、路由组和子路由器安装

• 上下文控制-基于新的上下文包，提供数据链、取消和超时

• 健壮-在Pressly、Cloudflare、Heroku、99Designs和其他许多公司生产环境中

• Doc生成-docgen自动生成从源代码到JSON或Markdown的路由文档

• Go.mod支持-从v5开始，go.mod支持
• 没有外部依赖项 - 全部Go stdlib + net/http

?压测结果

BenchmarkChi_Param 3075895 384 ns/op 400 B/op 2 allocs/op

BenchmarkChi_Param5 2116603 566 ns/op 400 B/op 2 allocs/op

BenchmarkChi_Param20 964117 1227 ns/op 400 B/op 2 allocs/op

BenchmarkChi_ParamWrite 2863413 420 ns/op 400 B/op 2 allocs/op

BenchmarkChi_GithubStatic 3045488 395 ns/op 400 B/op 2 allocs/op

BenchmarkChi_GithubParam 2204115 540 ns/op 400 B/op 2 allocs/op

BenchmarkChi_GithubAll 10000 113811 ns/op 81203 B/op 406 allocs/op

BenchmarkChi_GPlusStatic 3337485 359 ns/op 400 B/op 2 allocs/op

BenchmarkChi_GPlusParam 2825853 423 ns/op 400 B/op 2 allocs/op

BenchmarkChi_GPlus2Params 2471697 483 ns/op 400 B/op 2 allocs/op

BenchmarkChi_GPlusAll 194220 5950 ns/op 5200 B/op 26 allocs/op

BenchmarkChi_ParseStatic 3365324 356 ns/op 400 B/op 2 allocs/op

BenchmarkChi_ParseParam 2976614 404 ns/op 400 B/op 2 allocs/op

BenchmarkChi_Parse2Params 2638084 439 ns/op 400 B/op 2 allocs/op

BenchmarkChi_ParseAll 109567 11295 ns/op 10400 B/op 52 allocs/op

BenchmarkChi_StaticAll 16846 71308 ns/op 62802 B/op 314 allocs/op

?示例

package main

import (

"net/http"

"github.com/go-chi/chi/v5"

"github.com/go-chi/chi/v5/middleware"

)

func main() {

r := chi.NewRouter()

r.Use(middleware.Logger)

r.Get("/", func(w http.ResponseWriter, r *http.Request) {

w.Write([]byte("welcome"))

})

http.ListenAndServe(":3000", r)

}