Middleware Package (pkg/middleware)

內建中間件列表

核心設計理念

簡單載入單個內建中間件

package main
import (
	"github.com/maoxiaoyue/hypgo/pkg/middleware"
	"github.com/maoxiaoyue/hypgo/pkg/router"
	"github.com/maoxiaoyue/hypgo/pkg/context"
)
func main() {
	r := router.New()
	
	// 使用預設設定加上 Logger 中介軟體
	r.Use(middleware.Logger(middleware.LoggerConfig{}))
	
	r.GET("/ping", func(c *context.Context) {
		c.String(200, "pong")
	})
}

多個中間件串聯 (Chain)

// 建立一個基礎的安全呼叫鏈
apiChain := middleware.NewChain(
 middleware.Recovery(middleware.RecoveryConfig{}), // 防止崩潰
 middleware.Logger(middleware.LoggerConfig{}), // 日誌記錄
 middleware.CORS(middleware.CORSConfig{
 AllowOrigins: []string{"https://example.com"},
 }),
)
// 結合自訂函數
r.GET("/api/data", apiChain.Then(func(c *context.Context) {
 c.JSON(200, map[string]string{"msg": "secure data"})
}))

建立前綴中間件群組 (Group)

// 宣告一個以 `/admin` 開頭的群組,並附加 RateLimiter
adminGroup := middleware.NewGroup("/admin", middleware.RateLimiter(middleware.RateLimiterConfig{
 Rate: 10, // 每秒 10 個請求
 Burst: 20, // 瞬間最大容量 20
}))
// 為特定的路由套用該群組的中介軟體
r.GET("/admin/dashboard", adminGroup.Handle(func(c *context.Context) {
 c.String(200, "Admin View")
}))

自製中間件

func MyCustomMiddleware() hypcontext.HandlerFunc {
	return func(c *hypcontext.Context) {
		// 1. 在處理請求前執行的邏輯
		c.Set("my_key", "my_value")
		// 2. 將控制權交給下一個中介軟體或是 Handler
		c.Next()
		// 3. 在處理結束準備回應前執行的邏輯
		status := c.Writer.Status()
		log.Printf("Response Status: %d", status)
	}
}

新增中間件

BodyLimit — 請求大小限制

r.Use(middleware.BodyLimit(middleware.BodyLimitConfig{
 MaxBytes: 5 << 20, // 5MB
 ErrorMsg: "Payload too large",
}))

MethodOverride — HTTP 方法覆蓋

r.Use(middleware.MethodOverride())
// POST /users?_method=DELETE → 變成 DELETE /users
// POST /users (X-HTTP-Method-Override: PUT) → 變成 PUT /users

安全修復紀錄

GC 優化:Security Header 預計算

// 初始化時一次性計算
sec := middleware.Security(middleware.SecurityConfig{
 HSTSMaxAge: 31536000,
 HSTSIncludeSubdomains: true,
})
// → 預計算 hstsValue = "max-age=31536000; includeSubDomains"
// → 每請求只執行 c.Header("Strict-Transport-Security", hstsValue)
// → 零分配、零 GC 壓力