Context

Context API

The Context provides access to request and response data.

Getting Context

Fox handlers can optionally accept a *gin.Context parameter:

r.GET("/path", func(c *gin.Context) (any, error) {
    // Access context
    return response, nil
})

Request Data

Query Parameters

name := c.Query("name")              // Get query param
page := c.DefaultQuery("page", "1")  // With default value

Path Parameters

r.GET("/user/:id", func(c *gin.Context) {
    id := c.Param("id")
})

Headers

token := c.GetHeader("Authorization")
userAgent := c.Request.UserAgent()

Request Body

var data map[string]any
c.ShouldBindJSON(&data)

Client IP

ip := c.ClientIP()

Response

JSON Response

c.JSON(200, gin.H{
    "message": "success",
})

String Response

c.String(200, "Hello, World!")

HTML Response

c.HTML(200, "index.html", gin.H{
    "title": "Home",
})

Redirect

c.Redirect(302, "/new-path")

Status Code

c.Status(204) // No Content

Context Data

Set Value

c.Set("user_id", 123)

Get Value

userID := c.GetInt("user_id")
value, exists := c.Get("key")

Must Get

userID := c.MustGet("user_id").(int)

File Handling

Single File Upload

file, _ := c.FormFile("file")
c.SaveUploadedFile(file, "./uploads/"+file.Filename)

Multiple Files

form, _ := c.MultipartForm()
files := form.File["files"]

for _, file := range files {
    c.SaveUploadedFile(file, "./uploads/"+file.Filename)
}

Serve File

c.File("./assets/image.png")

Cookies

Set Cookie

c.SetCookie(
    "session_id",           // name
    "abc123",               // value
    3600,                   // maxAge (seconds)
    "/",                    // path
    "example.com",          // domain
    false,                  // secure
    true,                   // httpOnly
)

Get Cookie

value, err := c.Cookie("session_id")

Abort

Stop processing and return:

if !isAuthenticated(c) {
    c.JSON(401, gin.H{"error": "Unauthorized"})
    c.Abort()
    return
}

Fox-Specific Methods

Get Logger

logger := fox.GetLogger(c)
logger.Info("Processing request")

Get TraceID

traceID := fox.GetTraceID(c)

Next Steps

• Router API - Router configuration
• Middleware - Custom middleware