resolver

Documentation

Overview

Package resolver resolves a http request to an endpoint

Index

• Variables
• func StaticNamespace(ns string) func(*http.Request) string
• type Endpoint
• type Option
  • func WithHandler(h string) Option
  • func WithNamespace(n func(*http.Request) string) Option
  • func WithServicePrefix(p string) Option
• type Options
  • func NewOptions(opts ...Option) Options
• type ResolveOption
  • func Domain(n string) ResolveOption
• type ResolveOptions
  • func NewResolveOptions(opts ...ResolveOption) ResolveOptions
• type Resolver

Variables

var (
	ErrNotFound    = errors.New("not found")
	ErrInvalidPath = errors.New("invalid path")
)

Functions

func StaticNamespace

func StaticNamespace(ns string) func(*http.Request) string

StaticNamespace returns the same namespace for each request

Types

type Endpoint

type Endpoint struct {
	// e.g greeter
	Name string
	// HTTP Host e.g example.com
	Host string
	// HTTP Methods e.g GET, POST
	Method string
	// HTTP Path e.g /greeter.
	Path string
	// Domain endpoint exists within
	Domain string
}

Endpoint is the endpoint for a http request

type Option

type Option func(o *Options)

func WithHandler

func WithHandler(h string) Option

WithHandler sets the handler being used

func WithNamespace

func WithNamespace(n func(*http.Request) string) Option

WithNamespace sets the function which determines the namespace for a request

func WithServicePrefix

func WithServicePrefix(p string) Option

WithServicePrefix sets the ServicePrefix option

type Options

type Options struct {
	Handler       string
	Namespace     func(*http.Request) string
	ServicePrefix string
}

func NewOptions

func NewOptions(opts ...Option) Options

NewOptions returns new initialised options

type ResolveOption

type ResolveOption func(*ResolveOptions)

ResolveOption sets an option

func Domain

func Domain(n string) ResolveOption

Domain sets the resolve Domain option

type ResolveOptions

type ResolveOptions struct {
	Domain string
}

ResolveOptions are used when resolving a request

func NewResolveOptions

func NewResolveOptions(opts ...ResolveOption) ResolveOptions

NewResolveOptions returns new initialised resolve options

type Resolver

type Resolver interface {
	Resolve(r *http.Request, opts ...ResolveOption) (*Endpoint, error)
	String() string
}

Resolver resolves requests to endpoints