chain · 中间件
独立组合、复用标准 HTTP 中间件。
中间件使用标准签名 func(http.Handler) http.Handler,可以包装任意 http.Handler。
组合中间件
package main
import (
"fmt"
"log"
"net/http"
"github.com/hainuoli/mino/rest/chain"
)
func main() {
handler := chain.New(serviceHeader).ThenFunc(hello)
log.Fatal(http.ListenAndServe(":8080", handler))
}
func serviceHeader(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("X-Service", "Mino")
next.ServeHTTP(w, r)
})
}
func hello(w http.ResponseWriter, r *http.Request) {
fmt.Fprintln(w, "Hello, Mino!")
}完整示例 · cd examples && go run ./packages/chain
curl -i http://localhost:8080/响应包含 X-Service: Mino,正文为 Hello, Mino!。
执行顺序
chain.New(first, second, third).Then(handler)first → second → third → handler请求按注册顺序进入;next.ServeHTTP 返回后,按相反顺序退出。
复用与扩展
base := chain.New(serviceHeader)
public := base.ThenFunc(hello)
private := base.Append(auth).ThenFunc(hello)Append、Prepend 和 Extend 都返回新链,base 保持不变。
| 方法 | 位置 |
|---|---|
Append(mw...) | 现有中间件之后 |
Prepend(mw...) | 现有中间件之前 |
Extend(other) | 在末尾合并另一条链 |
接入已有路由
mux := http.NewServeMux()
mux.HandleFunc("GET /", hello)
handler := chain.New(serviceHeader).Then(mux)也可以传入 Mino、Chi 或其他实现 http.Handler 的路由。
使用约定
- 零值是空链,可直接使用。
Then接收http.Handler;ThenFunc接收http.HandlerFunc。Then(nil)和ThenFunc(nil)使用http.DefaultServeMux。- 中间件在构建 handler 时组合;返回 nil handler 会 panic。