httpserver

Documentation

Index

• func DisableResponseCompression(w http.ResponseWriter)
• func EnableCORS(w http.ResponseWriter, _ *http.Request)
• func Errorf(w http.ResponseWriter, r *http.Request, format string, args ...interface{})
• func GetPathPrefix() string
• func GetQuotedRemoteAddr(r *http.Request) string
• func GetRequestURI(r *http.Request) string
• func IsTLS() bool
• func RedirectPermanent(w http.ResponseWriter, url string)
• func Serve(addr string, rh RequestHandler)
• func Stop(addr string) error
• func WriteAPIHelp(w io.Writer, pathList [][2]string)
• func WritePrometheusMetrics(w io.Writer)
• type ErrorWithStatusCode
  • func (e *ErrorWithStatusCode) Error() string
  • func (e *ErrorWithStatusCode) Unwrap() error
• type Path
  • func ParsePath(path string) (*Path, error)
• type RequestHandler

Functions

func DisableResponseCompression

func DisableResponseCompression(w http.ResponseWriter)

DisableResponseCompression disables response compression on w.

The function must be called before the first w.Write* call.

func EnableCORS

func EnableCORS(w http.ResponseWriter, _ *http.Request)

EnableCORS enables https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS on the response.

func Errorf

func Errorf(w http.ResponseWriter, r *http.Request, format string, args ...interface{})

Errorf writes formatted error message to w and to logger.

func GetPathPrefix

func GetPathPrefix() string

GetPathPrefix - returns http server path prefix.

func GetQuotedRemoteAddr

func GetQuotedRemoteAddr(r *http.Request) string

GetQuotedRemoteAddr returns quoted remote address.

func GetRequestURI

func GetRequestURI(r *http.Request) string

GetRequestURI returns requestURI for r.

func IsTLS

func IsTLS() bool

IsTLS indicates is tls enabled or not

func RedirectPermanent

func RedirectPermanent(w http.ResponseWriter, url string)

RedirectPermanent redirects to the given url using 301 status code.

func Serve

func Serve(addr string, rh RequestHandler)

Serve starts an http server on the given addr with the given optional rh.

By default all the responses are transparently compressed, since Google charges a lot for the egress traffic. The compression may be disabled by calling DisableResponseCompression before writing the first byte to w.

The compression is also disabled if -http.disableResponseCompression flag is set.

func Stop

func Stop(addr string) error

Stop stops the http server on the given addr, which has been started via Serve func.

func WriteAPIHelp

func WriteAPIHelp(w io.Writer, pathList [][2]string)

WriteAPIHelp writes pathList to w in HTML format.

func WritePrometheusMetrics

func WritePrometheusMetrics(w io.Writer)

WritePrometheusMetrics writes all the registered metrics to w in Prometheus exposition format.

Types

type ErrorWithStatusCode

type ErrorWithStatusCode struct {
	Err        error
	StatusCode int
}

ErrorWithStatusCode is error with HTTP status code.

The given StatusCode is sent to client when the error is passed to Errorf.

func (*ErrorWithStatusCode) Error

func (e *ErrorWithStatusCode) Error() string

Error implements error interface.

func (*ErrorWithStatusCode) Unwrap

func (e *ErrorWithStatusCode) Unwrap() error

Unwrap returns e.Err.

This is used by standard errors package. See https://golang.org/pkg/errors

type Path

type Path struct {
	Prefix    string
	AuthToken string
	Suffix    string
}

Path contains the following path structure: /{prefix}/{authToken}/{suffix}

It is compatible with SaaS version.

func ParsePath

func ParsePath(path string) (*Path, error)

ParsePath parses the given path.

type RequestHandler

type RequestHandler func(w http.ResponseWriter, r *http.Request) bool

RequestHandler must serve the given request r and write response to w.

RequestHandler must return true if the request has been served (successfully or not).

RequestHandler must return false if it cannot serve the given request. In such cases the caller must serve the request.