Context Package (pkg/context)

主要功能

基礎使用

package user
import (
	"net/http"
	hypcontext "github.com/maoxiaoyue/hypgo/pkg/context"
)
func GetUser(c *hypcontext.Context) {
	// 從網址列取得變數 (例如 /user/:id)
	id := c.Param("id")
	// 從查詢參數取得資訊 (例如 ?lang=zh)
	lang := c.DefaultQuery("lang", "en")
	// 在上下文中傳遞值 (可用於 Middleware)
	c.Set("user_id", id)
	// 回傳 JSON
	c.JSON(http.StatusOK, map[string]interface{}{
		"id": id,
		"lang": lang,
		"status": "active",
	})
}

中間件控制

func AuthMiddleware(c *hypcontext.Context) {
	token := c.GetHeader("Authorization")
	if token == "" {
		c.AbortWithStatusJSON(http.StatusUnauthorized, map[string]string{
			"error": "Missing token",
		})
		return // 必須 return,停止當前 func 執行
	}
	// 繼續執行下一個 handler
	c.Next()
}

在 Goroutine 內使用

func AsyncProcess(c *hypcontext.Context) {
	// 產生唯讀副本
	cCopy := c.Copy()
	go func() {
		// 在這個 Goroutine 只能使用 cCopy,不可使用原本的 c
		DoSomething(cCopy.Request.URL.Path)
	}()
	c.String(200, "Background task started")
}

GC 優化策略

Map 重建替代逐一 Delete

// 優化前:每請求 N 次 delete
for k := range c.Keys { delete(c.Keys, k) }
// 優化後:1 次 make,舊 map 整體 GC
c.Keys = make(map[string]interface{}, 8)

Params Pool

// 從 pool 取得(零分配)
params := hypcontext.AcquireParams(3)
defer hypcontext.ReleaseParams(params)

物件池清單