server

Documentation

Overview

Package server provides tools to create http servers and handlers wrapping the lura router

Index

• Constants
• Variables
• func DefaultToHTTPError(_ error) int
• func InitHTTPDefaultTransport(cfg config.ServiceConfig)
• func InitHTTPDefaultTransportWithLogger(cfg config.ServiceConfig, logger logging.Logger)
• func NewServer(cfg config.ServiceConfig, handler http.Handler) *http.Server
• func NewServerWithLogger(cfg config.ServiceConfig, handler http.Handler, logger logging.Logger) *http.Server
• func ParseClientTLSConfigWithLogger(cfg *config.ClientTLS, logger logging.Logger) *tls.Config
• func ParseTLSConfig(cfg *config.TLS) *tls.Config
• func ParseTLSConfigWithLogger(cfg *config.TLS, logger logging.Logger) *tls.Config
• func RunServer(ctx context.Context, cfg config.ServiceConfig, handler http.Handler) error
• func RunServerWithLoggerFactory(l logging.Logger) func(context.Context, config.ServiceConfig, http.Handler) error
• type ToHTTPError

Constants

const (
	// HeaderCompleteResponseValue is the value of the CompleteResponseHeader
	// if the response is complete
	HeaderCompleteResponseValue = "true"
	// HeaderIncompleteResponseValue is the value of the CompleteResponseHeader
	// if the response is not complete
	HeaderIncompleteResponseValue = "false"
)

Variables

var (
	// CompleteResponseHeaderName is the header to flag incomplete responses to the client
	CompleteResponseHeaderName = "X-Gateway-Completed"
	// HeadersToSend are the headers to pass from the router request to the proxy
	HeadersToSend = []string{"Content-Type"}
	// UserAgentHeaderValue is the value of the User-Agent header to add to the proxy request
	UserAgentHeaderValue = []string{core.KrakendUserAgent}

	// ErrInternalError is the error returned by the router when something went wrong
	ErrInternalError = errors.New("internal server error")
	// ErrPrivateKey is the error returned by the router when the private key is not defined
	ErrPrivateKey = errors.New("private key not defined")
	// ErrPublicKey is the error returned by the router when the public key is not defined
	ErrPublicKey = errors.New("public key not defined")
)

Functions

func DefaultToHTTPError

func DefaultToHTTPError(_ error) int

DefaultToHTTPError is a ToHTTPError transalator that always returns an internal server error

func InitHTTPDefaultTransport

func InitHTTPDefaultTransport(cfg config.ServiceConfig)

InitHTTPDefaultTransport ensures the default HTTP transport is configured just once per execution

func InitHTTPDefaultTransportWithLogger

func InitHTTPDefaultTransportWithLogger(cfg config.ServiceConfig, logger logging.Logger)

func NewServer

func NewServer(cfg config.ServiceConfig, handler http.Handler) *http.Server

NewServer returns a http.Server ready to serve the injected handler

func NewServerWithLogger

func NewServerWithLogger(cfg config.ServiceConfig, handler http.Handler, logger logging.Logger) *http.Server

func ParseClientTLSConfigWithLogger

func ParseClientTLSConfigWithLogger(cfg *config.ClientTLS, logger logging.Logger) *tls.Config

func ParseTLSConfig

func ParseTLSConfig(cfg *config.TLS) *tls.Config

ParseTLSConfig creates a tls.Config from the TLS section of the service configuration

func ParseTLSConfigWithLogger

func ParseTLSConfigWithLogger(cfg *config.TLS, logger logging.Logger) *tls.Config

func RunServer

func RunServer(ctx context.Context, cfg config.ServiceConfig, handler http.Handler) error

RunServer runs a http.Server with the given handler and configuration. It configures the TLS layer if required by the received configuration.

func RunServerWithLoggerFactory

func RunServerWithLoggerFactory(l logging.Logger) func(context.Context, config.ServiceConfig, http.Handler) error

Types

type ToHTTPError

type ToHTTPError func(error) int

ToHTTPError translates an error into a HTTP status code