middleware

README

a collection of net/http middleware

Documentation

Index

• func GetRequestID(r *http.Request) (string, bool)
• type Middleware
  • func (m *Middleware) HTTPError(rw http.ResponseWriter, r *http.Request, msg string, code int, err error)
  • func (m *Middleware) LogRequest(r *http.Request, status int, latency time.Duration)
  • func (m *Middleware) Logger(handler http.Handler) http.Handler
  • func (m *Middleware) Recovery(handler http.Handler) http.Handler
  • func (m *Middleware) RequestID(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)

Functions

func GetRequestID

func GetRequestID(r *http.Request) (string, bool)

GetRequestID fetches the unique request ID from a request.

Types

type Middleware

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

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) LogRequest

func (m *Middleware) LogRequest(r *http.Request, status int, latency time.Duration)

LogRequest will log a request with known response status and handler latency.

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) RequestID

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

RequestID provides setting unique IDs per request and adding a hook to the logger to append these to log entries using the request's context. This should be placed at the TOP of handler stack.

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
}

TimeoutResponseWriter wraps an http.ResponseWriter to add request timeout capabilities.

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().