middleware

README

Package Middleware

This package contains http middleware. The middleware are actually a pure http.Handler. We keep the handler in this way since it's the form that compatible with golang standard.

JWT Middleware

JWT middleware is middleware for checking whether token is valid or not.

Log Middleware

Log middleware is middleware that will help logging the application. The logging prints out log from Kitabisa log specification.

How To Use The Middleware

func main() {
	meta := structs.Meta{
		Version: "v1.2.3",
		Status:  "stable",
		APIEnv:  "prod-test",
	}

	handlerCtx := phttp.NewContextHandler(meta)
	
	newHandler := phttp.NewHttpHandler(handlerCtx)
	helloHandler := newHandler(HelloHandler)

    // middleware initialization. Just initialized it and use.
	midd := middleware.NewJWTMiddleware(handlerCtx, []byte("abcde"))
	logMiddleware := middleware.NewHttpRequestLoggerMiddleware(logger)

	router := chi.NewRouter()
    
    // use the middleware
    router.Use(midd)
    router.Use(logMiddleware)
    router.Use(RequestLogger) // will print request log only for 4xx and 5xx HTTP status code
    
	router.Get("/", helloHandler.ServeHTTP)

	http.ListenAndServe(":5678", router)
}

Documentation

Index

• func NewHeaderCheck(hctx phttp.HttpHandlerContext, secretKey string) func(next http.Handler) http.Handler
• func NewHttpRequestLogger(logger *log.Logger) func(next http.Handler) http.Handler
• func NewJWT(hctx phttp.HttpHandlerContext, signKey []byte) func(next http.Handler) http.Handler
• func RequestIDToContextAndLogMiddleware(next http.Handler) http.Handler
• func RequestLogger(next http.Handler) http.Handler
• type Header
• type HttpRequestLoggerMiddleware

Functions

func NewHeaderCheck

func NewHeaderCheck(hctx phttp.HttpHandlerContext, secretKey string) func(next http.Handler) http.Handler

func NewHttpRequestLogger

func NewHttpRequestLogger(logger *log.Logger) func(next http.Handler) http.Handler

TODO: to be deprecated

func NewJWT

func NewJWT(hctx phttp.HttpHandlerContext, signKey []byte) func(next http.Handler) http.Handler

func RequestIDToContextAndLogMiddleware

func RequestIDToContextAndLogMiddleware(next http.Handler) http.Handler

RequestIDToContextAndLogMiddleware set X-Ktbs-Request-ID header value and logger to context

func RequestLogger

func RequestLogger(next http.Handler) http.Handler

RequestLogger middleware for request logging using zerolog

Types

type Header

type Header struct {
	XKtbsRequestID     string `valid:"uuidv4,required"`
	XKtbsAPIVersion    string `valid:"semver,required"`
	XKtbsClientVersion string `valid:"semver,required"`
	XKtbsPlatformName  string `valid:"required"`
	XKtbsClientName    string `valid:"required"`

	// Optional
	XKtbsSignature string `valid:"optional"`
	XKtbsTime      string `valid:"int,optional"`
	Authorization  string `valid:"optional"`
}

type HttpRequestLoggerMiddleware

type HttpRequestLoggerMiddleware struct {
	// contains filtered or unexported fields
}