middleware

README

a collection of net/http middleware

Documentation

Index

• type Middleware
  • func (m *Middleware) AddTimeout(rw http.ResponseWriter, r *http.Request, fallback time.Duration) (*TimeoutResponseWriter, *http.Request)
  • func (m *Middleware) HTTPError(rw http.ResponseWriter, r *http.Request, msg string, code int, err error)
  • func (m *Middleware) Logger(handler http.Handler) http.Handler
  • func (m *Middleware) Recovery(handler http.Handler) http.Handler
  • func (m *Middleware) Timeout(handler http.Handler, fallback time.Duration) http.Handler
• type TimeoutResponseWriter
  • func (rw *TimeoutResponseWriter) Cancel() bool
  • func (rw *TimeoutResponseWriter) Header() http.Header
  • func (rw *TimeoutResponseWriter) ResponseWriter() http.ResponseWriter
  • func (rw *TimeoutResponseWriter) Status() int
  • func (rw *TimeoutResponseWriter) TimedOut() bool
  • func (rw *TimeoutResponseWriter) Write(b []byte) (int, error)
  • func (rw *TimeoutResponseWriter) WriteHeader(status int)

Types

type Middleware

type Middleware struct {
	// Log is the log output for this Middleware.
	Log *logger.Logger
}

func (*Middleware) AddTimeout

func (m *Middleware) AddTimeout(rw http.ResponseWriter, r *http.Request, fallback time.Duration) (*TimeoutResponseWriter, *http.Request)

AddTimeout wraps an http ResponseWriter and Request to add our own timeout tracking based on either "Request-Timeout", or fallback. Please note that due to the way the ResponseWriter is wrapped, it may mask underlying interface types. Cast to *TimeoutResponseWriter for original access.

func (*Middleware) HTTPError

func (m *Middleware) HTTPError(rw http.ResponseWriter, r *http.Request, msg string, code int, err error)

HTTPError handles responding to a client with an HTTP error code and logs the provided error.

func (*Middleware) Logger

func (m *Middleware) Logger(handler http.Handler) http.Handler

Logger adds request logging to the provided HTTP handler.

func (*Middleware) Recovery

func (m *Middleware) Recovery(handler http.Handler) http.Handler

Recovery adds panic recovery (and panic logging) to the provided HTTP handler.

func (*Middleware) Timeout

func (m *Middleware) Timeout(handler http.Handler, fallback time.Duration) http.Handler

Timeout adds user defined request timeouts to provided handler, either by "Request-Timeout" header or the given fallback value. Please note that this handler also provides logging so do not wrap within Middleware.Logger().

type TimeoutResponseWriter

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

func (*TimeoutResponseWriter) Cancel

func (rw *TimeoutResponseWriter) Cancel() bool

Cancel will attempt to cancel the timeout counter.

func (*TimeoutResponseWriter) Header

func (rw *TimeoutResponseWriter) Header() http.Header

Header implements http.ResponseWriter's .Header().

func (*TimeoutResponseWriter) ResponseWriter

func (rw *TimeoutResponseWriter) ResponseWriter() http.ResponseWriter

ResponseWriter returns access to the underlying http.ResponseWriter.

func (*TimeoutResponseWriter) Status

func (rw *TimeoutResponseWriter) Status() int

Status returns the set response status code.

func (*TimeoutResponseWriter) TimedOut

func (rw *TimeoutResponseWriter) TimedOut() bool

TimedOut returns whether this TimeoutResponseWriter has timed out.

func (*TimeoutResponseWriter) Write

func (rw *TimeoutResponseWriter) Write(b []byte) (int, error)

Write implements http.ResponseWriter's .Write().

func (*TimeoutResponseWriter) WriteHeader

func (rw *TimeoutResponseWriter) WriteHeader(status int)

WriteHeader implements http.ResponseWriter's .WriteHeader().