middleware

README

go-middleware

Golang middleware collection

Middleware is value that have following type

func(http.HandlerFunc) http.HandlerFunc

In following example, testMiddleware is a middleware that adding some header to the response

var handler http.HandlerFunc = ...
var someMiddleware func(next http.HandlerFunc) http.HanlderFunc = ...

testMiddleware := func(next http.HandlerFunc) http.HanlderFunc {
  return func(w http.ResponseWriter, r *http.Request) {
    w.Header().Add("TestHeader", "test value")
    next(w, r)
  }
}

combinedHandler := someMiddleware(testMiddleware(handler))

Use httpchain package to chaining multiple middleware, so you can write

combinedHandler := httpchain.Chain(
  someMiddleware,
  testMiddleware,
  handler,
)

Documentation

Overview

Package middleware

this package re-export Chain from github.com/payfazz/httpchain

see subpackage for collections of middleware

Example

if err := http.ListenAndServe(":8080", middleware.C(
	panicreporter.New(nil),
	reqlogger.New(nil),
	func(w http.ResponseWriter, r *http.Request) {
		switch r.URL.EscapedPath() {
		case "/hello":
			fmt.Fprintln(w, "hello world")
			return
		case "/random-panic":
			num := 10 / (rand.Int() % 2)
			fmt.Fprintf(w, "num = %d\n", num)
			return
		default:
			http.Error(w, "not found", 404)
			return
		}
	},
)); err != nil {
	panic(err)
}

Index

• func C(all ...interface{}) http.HandlerFunc
• func Chain(all ...interface{}) http.HandlerFunc

Examples

• Package

Functions

func C

func C(all ...interface{}) http.HandlerFunc

shortcut for Chain function

func Chain

func Chain(all ...interface{}) http.HandlerFunc

see https://pkg.go.dev/github.com/payfazz/httpchain#Chain