server

Documentation

Index

• func HandleSwaggerOrigin(h http.Handler) http.Handler
• func Mount(mux goahttp.Muxer, h *Server)
• func MountCORSHandler(mux goahttp.Muxer, h http.Handler)
• func MountInternalAPIGenHTTPOpenapiJSON(mux goahttp.Muxer, h http.Handler)
• func NewCORSHandler() http.Handler
• type MountPoint
• type Server
  • func New(e *swagger.Endpoints, mux goahttp.Muxer, ...) *Server
  • func (s *Server) MethodNames() []string
  • func (s *Server) Mount(mux goahttp.Muxer)
  • func (s *Server) Service() string
  • func (s *Server) Use(m func(http.Handler) http.Handler)

Functions

func HandleSwaggerOrigin

func HandleSwaggerOrigin(h http.Handler) http.Handler

HandleSwaggerOrigin applies the CORS response headers corresponding to the origin for the service swagger.

func Mount

func Mount(mux goahttp.Muxer, h *Server)

Mount configures the mux to serve the swagger endpoints.

func MountCORSHandler

func MountCORSHandler(mux goahttp.Muxer, h http.Handler)

MountCORSHandler configures the mux to serve the CORS endpoints for the service swagger.

func MountInternalAPIGenHTTPOpenapiJSON

func MountInternalAPIGenHTTPOpenapiJSON(mux goahttp.Muxer, h http.Handler)

MountInternalAPIGenHTTPOpenapiJSON configures the mux to serve GET request made to "/swagger/swagger.json".

func NewCORSHandler

func NewCORSHandler() http.Handler

NewCORSHandler creates a HTTP handler which returns a simple 200 response.

Types

type MountPoint

type MountPoint struct {
	// Method is the name of the service method served by the mounted HTTP handler.
	Method string
	// Verb is the HTTP method used to match requests to the mounted handler.
	Verb string
	// Pattern is the HTTP request path pattern used to match requests to the
	// mounted handler.
	Pattern string
}

MountPoint holds information about the mounted endpoints.

type Server

type Server struct {
	Mounts                        []*MountPoint
	CORS                          http.Handler
	InternalAPIGenHTTPOpenapiJSON http.Handler
}

Server lists the swagger service endpoint HTTP handlers.

func New

func New(
	e *swagger.Endpoints,
	mux goahttp.Muxer,
	decoder func(*http.Request) goahttp.Decoder,
	encoder func(context.Context, http.ResponseWriter) goahttp.Encoder,
	errhandler func(context.Context, http.ResponseWriter, error),
	formatter func(ctx context.Context, err error) goahttp.Statuser,
	fileSystemInternalAPIGenHTTPOpenapiJSON http.FileSystem,
) *Server

New instantiates HTTP handlers for all the swagger service endpoints using the provided encoder and decoder. The handlers are mounted on the given mux using the HTTP verb and path defined in the design. errhandler is called whenever a response fails to be encoded. formatter is used to format errors returned by the service methods prior to encoding. Both errhandler and formatter are optional and can be nil.

func (*Server) MethodNames

func (s *Server) MethodNames() []string

MethodNames returns the methods served.

func (*Server) Mount

func (s *Server) Mount(mux goahttp.Muxer)

Mount configures the mux to serve the swagger endpoints.

func (*Server) Service

func (s *Server) Service() string

Service returns the name of the service served.

func (*Server) Use

func (s *Server) Use(m func(http.Handler) http.Handler)

Use wraps the server handlers with the given middleware.