httpserver

Documentation

Index

• func DisableResponseCompression(w http.ResponseWriter)
• func EnableCORS(w http.ResponseWriter, _ *http.Request)
• func Errorf(w http.ResponseWriter, format string, args ...interface{})
• func RegisterSecretFlag(flagName string)
• func Serve(addr string, rh RequestHandler)
• func Stop(addr string) error
• type ErrorWithStatusCode
  • func (e *ErrorWithStatusCode) Error() string
• 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, format string, args ...interface{})

Errorf writes formatted error message to w and to logger.

func RegisterSecretFlag

func RegisterSecretFlag(flagName string)

RegisterSecretFlag registers flagName as secret.

This function must be called before starting httpserver. It cannot be called from concurrent goroutines.

Secret flags aren't exported at `/metrics` page.

func Serve

func Serve(addr string, rh RequestHandler)

Serve starts an http server on the given addr with the given 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.

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.

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.