server

Documentation

Overview

Package server provides a pluggable SDK-compatible HTTP server.

The core Server is protocol-agnostic: it dispatches incoming requests to registered Handlers via a Matches predicate. Each Handler is a self-contained package (e.g. server/aws/s3, server/aws/dynamodb) that speaks its own wire format. Adding a new service — AWS EC2, Azure Blob, GCP GCS — is one new package and one Register call; the core server never changes.

Index

• type Handler
• type Server
  • func New(handlers ...Handler) *Server
  • func (s *Server) Register(h Handler)
  • func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

Types

type Handler

type Handler interface {
	Matches(r *http.Request) bool
	ServeHTTP(w http.ResponseWriter, r *http.Request)
}

Handler is a self-contained protocol handler registered with a Server. Matches inspects the request and returns true if this handler should serve it; ServeHTTP writes the response. Handlers are evaluated in registration order, first match wins.

type Server

type Server struct {
	// contains filtered or unexported fields
}

Server routes incoming HTTP requests to registered Handlers. Server itself implements http.Handler, so httptest.NewServer(srv) works.

func New

func New(handlers ...Handler) *Server

New creates a Server preloaded with the given handlers. Additional handlers can be added later via Register.

func (*Server) Register

func (s *Server) Register(h Handler)

Register appends a handler. Handlers registered earlier take precedence, so register more specific handlers before catch-all ones.

func (*Server) ServeHTTP

func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP dispatches to the first handler whose Matches returns true, or responds 501 Not Implemented if no handler matches.