middleware

Documentation

Overview

Package middleware defines multiple gin middlewares

Index

• Constants
• Variables
• func Context() v1.HandlerFunc
• func Cors() gin.HandlerFunc
• func GetDefaultLogFormatterWithRequestID() gin.LogFormatter
• func GetLoggerConfig(formatter gin.LogFormatter, output io.Writer, skipPaths []string) gin.LoggerConfig
• func GetRequestIDFromContext(c *gin.Context) string
• func GetRequestIDFromHeaders(c *gin.Context) string
• func Limit(maxEventsPerSec float64, maxBurstSize int) gin.HandlerFunc
• func Logger() v1.HandlerFunc
• func LoggerWithConfig() v1.HandlerFunc
• func NoCache(c *gin.Context)
• func Options(c *gin.Context)
• func Recovery() v1.HandlerFunc
• func RequestID() v1.HandlerFunc
• func Secure(c *gin.Context)
• type Middleware

Constants

const UsernameKey = "username"

UsernameKey defines the key in gin context which represents the owner of the secret.

const (
	// XRequestIDKey defines X-Request-ID key string.
	XRequestIDKey = "X-Request-ID"
)

Variables

var ErrLimitExceeded = errors.New("Limit exceeded")

ErrLimitExceeded defines Limit exceeded error.

var Middlewares = defaultMiddlewares()

Middlewares transport registered middlewares.

Functions

func Context

func Context() v1.HandlerFunc

Context is a middleware that injects common prefix fields to gin.Context.

func Cors

func Cors() gin.HandlerFunc

Cors add cors headers.

func GetDefaultLogFormatterWithRequestID

func GetDefaultLogFormatterWithRequestID() gin.LogFormatter

GetDefaultLogFormatterWithRequestID returns gin.LogFormatter with 'RequestID'.

func GetLoggerConfig

func GetLoggerConfig(formatter gin.LogFormatter, output io.Writer, skipPaths []string) gin.LoggerConfig

GetLoggerConfig return gin.LoggerConfig which will write the logs to specified io.Writer with given gin.LogFormatter. By default gin.DefaultWriter = os.Stdout reference: https://github.com/gin-gonic/gin#custom-log-format

func GetRequestIDFromContext

func GetRequestIDFromContext(c *gin.Context) string

GetRequestIDFromContext returns 'RequestID' from the given context if present.

func GetRequestIDFromHeaders

func GetRequestIDFromHeaders(c *gin.Context) string

GetRequestIDFromHeaders returns 'RequestID' from the headers if present.

func Limit

func Limit(maxEventsPerSec float64, maxBurstSize int) gin.HandlerFunc

Limit drops (HTTP status 429) the request if the limit is reached.

func Logger

func Logger() v1.HandlerFunc

Logger instances a Logger middleware that will write the logs to gin.DefaultWriter. By default gin.DefaultWriter = os.Stdout.

func LoggerWithConfig

func LoggerWithConfig() v1.HandlerFunc

LoggerWithConfig instance a Logger middleware with config.

func NoCache

func NoCache(c *gin.Context)

NoCache is a middleware function that appends headers to prevent the client from caching the HTTP response.

func Options

func Options(c *gin.Context)

Options is a middleware function that appends headers for options requests and aborts then exits the middleware chain and ends the request.

func Recovery

func Recovery() v1.HandlerFunc

Recovery when the server is processing panic occurred will avoid process abort.

func RequestID

func RequestID() v1.HandlerFunc

RequestID is a middleware that injects a 'X-Request-ID' into the context and request/response header of each request.

func Secure

func Secure(c *gin.Context)

Secure is a middleware function that appends security and resource access headers.

Types

type Middleware

type Middleware func(http.Handler) http.Handler

Middleware middleware significant.