handler

Documentation

Index

• func Error(req *http.Request, code int, reason ...string) error
• func NewStaticHandler(root, folder string) http.Handler
• func Redirect(req *http.Request, code int, path string) error
• type Logger
  • func (this *Logger) Log(name string) error
• type LoggerHandler
  • func (this *LoggerHandler) ServeHTTP(w http.ResponseWriter, req *http.Request)
  • func (this *LoggerHandler) SetHandler(handler http.Handler)
• type RenderCache
  • func (this *RenderCache) Dispose() error
  • func (this *RenderCache) Get(docroot string, req *http.Request) gopi.HttpRenderer
  • func (this *RenderCache) New(gopi.Config) error
  • func (this *RenderCache) Register(renderer gopi.HttpRenderer) error
  • func (this *RenderCache) Render(docroot string, renderer gopi.HttpRenderer, req *http.Request) (gopi.HttpRenderContext, error)
  • func (this *RenderCache) String() string
• type Static
  • func (this *Static) Define(cfg gopi.Config) error
  • func (this *Static) New(gopi.Config) error
  • func (this *Static) Serve(path string) error
• type TemplateCache
  • func (this *TemplateCache) Define(cfg gopi.Config) error
  • func (this *TemplateCache) Get(name string) (*template.Template, time.Time, error)
  • func (this *TemplateCache) Modified(name string) time.Time
  • func (this *TemplateCache) New(gopi.Config) error
  • func (this *TemplateCache) String() string
• type TemplateHandler
  • func (this *TemplateHandler) Serve(req *http.Request) (gopi.HttpRenderContext, error)
  • func (this *TemplateHandler) ServeError(w http.ResponseWriter, err error)
  • func (this *TemplateHandler) ServeHTTP(w http.ResponseWriter, req *http.Request)
• type Templates
  • func (this *Templates) Env(req *http.Request) map[string]string
  • func (this *Templates) New(gopi.Config) error
  • func (this *Templates) NewTemplateHandler(path, docroot string) (http.Handler, error)
  • func (this *Templates) RegisterRenderer(r gopi.HttpRenderer) error
  • func (this *Templates) Render(req *http.Request) (gopi.HttpRenderContext, error)
  • func (this *Templates) Serve(path, docroot string) error
  • func (this *Templates) String() string

Functions

func Error

func Error(req *http.Request, code int, reason ...string) error

func NewStaticHandler

func NewStaticHandler(root, folder string) http.Handler

func Redirect

func Redirect(req *http.Request, code int, path string) error

Types

type Logger

type Logger struct {
	gopi.Unit
	gopi.Server
	gopi.Metrics
}

func (*Logger) Log

func (this *Logger) Log(name string) error

Register a service which logs metrics

type LoggerHandler

type LoggerHandler struct {
	*Logger

	http.Handler
	// contains filtered or unexported fields
}

func (*LoggerHandler) ServeHTTP

func (this *LoggerHandler) ServeHTTP(w http.ResponseWriter, req *http.Request)

Log metrics

func (*LoggerHandler) SetHandler

func (this *LoggerHandler) SetHandler(handler http.Handler)

Set handler

type RenderCache

type RenderCache struct {
	gopi.Unit
	gopi.Logger
	sync.RWMutex
	sync.WaitGroup
	// contains filtered or unexported fields
}

func (*RenderCache) Dispose

func (this *RenderCache) Dispose() error

Dispose resources related to the render cache

func (*RenderCache) Get

func (this *RenderCache) Get(docroot string, req *http.Request) gopi.HttpRenderer

Get returns a renderer for an incoming request, or nil if there is no renderer which matches the request

func (*RenderCache) New

func (this *RenderCache) New(gopi.Config) error

func (*RenderCache) Register

func (this *RenderCache) Register(renderer gopi.HttpRenderer) error

Register appends a renderer to the set of renderers

func (*RenderCache) Render

func (this *RenderCache) Render(docroot string, renderer gopi.HttpRenderer, req *http.Request) (gopi.HttpRenderContext, error)

Render will return the render context for a renderer and a request

func (*RenderCache) String

func (this *RenderCache) String() string

type Static

type Static struct {
	gopi.Unit
	gopi.Server
	gopi.Logger
	// contains filtered or unexported fields
}

func (*Static) Define

func (this *Static) Define(cfg gopi.Config) error

func (*Static) New

func (this *Static) New(gopi.Config) error

func (*Static) Serve

func (this *Static) Serve(path string) error

Serve registers a service to serve static files from all folders under the named path

type TemplateCache

type TemplateCache struct {
	sync.RWMutex
	gopi.Unit
	gopi.Logger
	// contains filtered or unexported fields
}

func (*TemplateCache) Define

func (this *TemplateCache) Define(cfg gopi.Config) error

func (*TemplateCache) Get

func (this *TemplateCache) Get(name string) (*template.Template, time.Time, error)

Get returns a template keyed by name. If the template has been updated on the filesystem, then it is reparsed.

func (*TemplateCache) Modified

func (this *TemplateCache) Modified(name string) time.Time

Modified returns the modification time of a template by name or returns zero-time if the template does not exist

func (*TemplateCache) New

func (this *TemplateCache) New(gopi.Config) error

func (*TemplateCache) String

func (this *TemplateCache) String() string

type TemplateHandler

type TemplateHandler struct {
	gopi.Logger
	*TemplateCache
	*RenderCache
	// contains filtered or unexported fields
}

func (*TemplateHandler) Serve

func (this *TemplateHandler) Serve(req *http.Request) (gopi.HttpRenderContext, error)

Serve is internal version of renderer

func (*TemplateHandler) ServeError

func (this *TemplateHandler) ServeError(w http.ResponseWriter, err error)

Serve error

func (*TemplateHandler) ServeHTTP

func (this *TemplateHandler) ServeHTTP(w http.ResponseWriter, req *http.Request)

ServeHTTP a template through a renderer

type Templates

type Templates struct {
	gopi.Unit
	gopi.Server
	gopi.Logger
	*TemplateCache
	*RenderCache
}

func (*Templates) Env

func (this *Templates) Env(req *http.Request) map[string]string

Env returns the process environment for a request

func (*Templates) New

func (this *Templates) New(gopi.Config) error

func (*Templates) NewTemplateHandler

func (this *Templates) NewTemplateHandler(path, docroot string) (http.Handler, error)

func (*Templates) RegisterRenderer

func (this *Templates) RegisterRenderer(r gopi.HttpRenderer) error

RegisterRenderer registers a document renderer

func (*Templates) Render

func (this *Templates) Render(req *http.Request) (gopi.HttpRenderContext, error)

Render returns content and modified time for a path

func (*Templates) Serve

func (this *Templates) Serve(path, docroot string) error

Serve registers a service to serve templates for a path

func (*Templates) String

func (this *Templates) String() string