组件分享之后端组件——用于构建 Go HTTP 服务的轻量级、惯用且可组合的路由器chi
背景
近期正在探索前端、后端、系统端各类常用组件与工具，对其一些常见的组件进行再次整理一下，形成标准化组件专题，后续该专题将包含各类语言中的一些常用组件。欢迎大家进行持续关注。
组件基本信息
- 组件：chi
- 开源协议：MIT License
内容
本节我们分享一个在Golang中用于构建 Go HTTP 服务的轻量级、惯用且可组合的路由器chi
它特别擅长帮助您编写大型 REST API 服务，这些服务可以随着项目的增长和变化而保持可维护性。
chi基于 Go 1.7 中引入的新context包构建，用于处理处理程序链中的信号、取消和请求范围的值。该项目的重点是寻找一种优雅而舒适的设计来编写 REST API 服务器，该设计是在为我们的公共 API 服务提供支持的 Pressly API 服务开发期间编写的，该服务反过来为我们所有的客户端应用程序提供支持。
chi 设计的主要考虑因素是：项目结构、可维护性、标准 http 处理程序（仅限 stdlib）、开发人员生产力以及将大型系统解构为许多小部分。核心路由器
github.com/go-chi/chi非常小（小于 1000 LOC），但我们还包含了一些有用/可选的子包：middleware、render 和docgen。我们希望你也喜欢它！特征
- 轻量级- 在 ~1000 LOC 中用于 chi 路由器
- 快速- 是的，请参阅基准
- 100% 兼容 net/http - 使用生态系统中任何兼容的 http 或中间件 pkg
net/http- 专为模块化/可组合 API 设计- 中间件、内联中间件、路由组和子路由器安装
- 上下文控制- 建立在新
context包之上，提供价值链、取消和超时- 强大的 - Pressly、CloudFlare、Heroku、99Designs 和许多其他公司的生产（见讨论）
- 文档生成-
docgen自动生成从您的源到 JSON 或 Markdown 的路由文档- Go.mod 支持- 从 v5 开始，支持 go.mod（请参阅CHANGELOG）
- 没有外部依赖- 普通 ol' Go stdlib + net/http
简单使用案例：
1、安装
go get -u github.com/go-chi/chi/v5
2、使用
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)
}
本文声明：
88x31.png
知识共享许可协议
本作品由 cn華少 采用 知识共享署名-非商业性使用 4.0 国际许可协议 进行许可。
