handlers

Documentation

Index

• Constants
• func DefaultSkipper(*rux.Context) bool
• func DumpRoutesHandler() rux.HandlerFunc
• func GenRequestID() rux.HandlerFunc
• func HTTPBasicAuth(accounts map[string]string) rux.HandlerFunc
• func HTTPMethodOverrideHandler(h http.Handler) http.Handler
• func IgnoreFavIcon() rux.HandlerFunc
• func PanicsHandler() rux.HandlerFunc
• func RequestLogger() rux.HandlerFunc
• func Timeout(timeout time.Duration) rux.HandlerFunc
• type Skipper

Examples

• HTTPMethodOverrideHandler

Constants

const (
	// HTTPMethodOverrideHeader is a commonly used http header to override a request method
	HTTPMethodOverrideHeader = "X-HTTP-Method-Override"
	// HTTPMethodOverrideFormKey is a commonly used HTML form key to override a request method
	HTTPMethodOverrideFormKey = "_method"
	// OriginalMethodContextKey is a commonly for record old original request method
	OriginalMethodContextKey contextKey = "originalMethod"
)

const FavIcon = "/favicon.ico"

FavIcon uri for favicon.ico

Functions

func DefaultSkipper

func DefaultSkipper(*rux.Context) bool

DefaultSkipper returns false which processes the middleware.

func DumpRoutesHandler

func DumpRoutesHandler() rux.HandlerFunc

DumpRoutesHandler dump all registered routes info

func GenRequestID

func GenRequestID() rux.HandlerFunc

GenRequestID for the request

func HTTPBasicAuth

func HTTPBasicAuth(accounts map[string]string) rux.HandlerFunc

HTTPBasicAuth for the request Usage:

r.GET("/auth", func(c *rux.Context) {
	c.WriteString("hello")
}, HTTPBasicAuth(map[string]string{"testuser": "123"}))

func HTTPMethodOverrideHandler

func HTTPMethodOverrideHandler(h http.Handler) http.Handler

HTTPMethodOverrideHandler wraps and returns a http.Handler which checks for the X-HTTP-Method-Override header or the _method form key, and overrides (if valid) request.Method with its value.

It is ref from the https://github.com/gorilla/handlers

Example

r := rux.New()

h := HTTPMethodOverrideHandler(r)
http.ListenAndServe(":8080", h)

// can also:
h1 := r.WrapHTTPHandlers(HTTPMethodOverrideHandler)
http.ListenAndServe(":8080", h1)

func IgnoreFavIcon

func IgnoreFavIcon() rux.HandlerFunc

IgnoreFavIcon middleware

func PanicsHandler

func PanicsHandler() rux.HandlerFunc

PanicsHandler middleware

func RequestLogger

func RequestLogger() rux.HandlerFunc

RequestLogger middleware.

func Timeout

func Timeout(timeout time.Duration) rux.HandlerFunc

Timeout is a middleware for handle logic. the method is refer from "github.com/go-chi/chi/middleware"

It's required that you select the ctx.Done() channel to check for the signal if the context has reached its deadline and return, otherwise the timeout signal will be just ignored.

ie. a route/handler may look like:

 r.GET("/long", func(c *rux.Context) {
	 ctx := c.Req.Context()
	 processTime := time.Duration(rand.Intn(4)+1) * time.Second

	 select {
	 case <-ctx.Done():
	 	return

	 case <-time.After(processTime):
	 	 // The above channel simulates some hard work.
	 }

	 c.WriteBytes([]byte("done"))
 })

Types

type Skipper

type Skipper func(*rux.Context) bool

Skipper defines a function to skip middleware. Returning true skips processing the middleware.