middleware

Documentation

Overview

Package middleware 提供可复用的 gin 中间件。

Index

• func CORS(cfg config.CorsConfig) gin.HandlerFunc
• func GetJWTClaims(c *gin.Context) jwt.MapClaims
• func GetJWTUserID(c *gin.Context) uint32
• func JWTGuard(secret string) gin.HandlerFunc
• func RequestLog() gin.HandlerFunc
• func Trace(log logger.Logger) gin.HandlerFunc

Functions

func CORS

func CORS(cfg config.CorsConfig) gin.HandlerFunc

CORS 跨域中间件。

func GetJWTClaims

func GetJWTClaims(c *gin.Context) jwt.MapClaims

GetJWTClaims 从 gin.Context 中读取 JWTGuard 解析出的完整 claims。

func GetJWTUserID

func GetJWTUserID(c *gin.Context) uint32

GetJWTUserID 从 claims 中便捷提取 user_id。

func JWTGuard

func JWTGuard(secret string) gin.HandlerFunc

JWTGuard JWT 验证中间件，解析 Bearer Token 并将 claims 注入 gin.Context。 验证成功后可通过 GetJWTClaims 获取完整 claims，或通过 GetJWTUserID 直接获取用户 ID。

func RequestLog

func RequestLog() gin.HandlerFunc

RequestLog 请求日志中间件，记录请求详情。

func Trace

func Trace(log logger.Logger) gin.HandlerFunc

Trace 请求链路追踪中间件，注入 traceID、beginTime、logger 到上下文。