package lazydispatch ¶
import "golazy.dev/lazydispatch"Functions ¶
func ApplyETag ¶
ApplyETag adds or validates an ETag for an eligible buffered response.
func ApplyETag(w *BufferedResponseWriter, r *http.Request)func MethodNotAllowed ¶
func MethodNotAllowed(allowed ...string) http.Handlerfunc ReleaseBufferedResponseWriter ¶
ReleaseBufferedResponseWriter resets and releases a writer acquired from AcquireBufferedResponseWriter.
func ReleaseBufferedResponseWriter(w *BufferedResponseWriter)Types ¶
type BufferedResponseWriter ¶
BufferedResponseWriter is a response writer whose headers and body can be reset.
type BufferedResponseWriter struct {
// contains filtered or unexported fields
}func AcquireBufferedResponseWriter ¶
AcquireBufferedResponseWriter returns a pooled buffered response writer.
Callers must pass the returned writer to ReleaseBufferedResponseWriter after the request path no longer needs it.
func AcquireBufferedResponseWriter(w http.ResponseWriter) *BufferedResponseWriterfunc NewBufferedResponseWriter ¶
func NewBufferedResponseWriter(w http.ResponseWriter) *BufferedResponseWriterfunc (w *BufferedResponseWriter) Flush ¶
func (w *BufferedResponseWriter) Flush() errorfunc (w *BufferedResponseWriter) Header ¶
func (w *BufferedResponseWriter) Header() http.Headerfunc (w *BufferedResponseWriter) Reset ¶
func (w *BufferedResponseWriter) Reset()func (w *BufferedResponseWriter) StartStream ¶
StartStream commits the buffered headers and lets callers write directly to the wrapped response writer.
func (w *BufferedResponseWriter) StartStream(status int) (http.ResponseWriter, error)func (w *BufferedResponseWriter) Unwrap ¶
func (w *BufferedResponseWriter) Unwrap() http.ResponseWriterfunc (w *BufferedResponseWriter) WasResponseSent ¶
func (w *BufferedResponseWriter) WasResponseSent() boolfunc (w *BufferedResponseWriter) Write ¶
func (w *BufferedResponseWriter) Write(data []byte) (int, error)func (w *BufferedResponseWriter) WriteHeader ¶
func (w *BufferedResponseWriter) WriteHeader(status int)type Dispatcher ¶
type Dispatcher struct {
// contains filtered or unexported fields
}func NewDispatcher ¶
func NewDispatcher() *Dispatcherfunc (d *Dispatcher) Handler ¶
func (d *Dispatcher) Handler(next http.Handler) http.Handlerfunc (d *Dispatcher) ServeHTTP ¶
func (d *Dispatcher) ServeHTTP(w http.ResponseWriter, r *http.Request)func (d *Dispatcher) Use ¶
func (d *Dispatcher) Use(middleware Middleware)type Middleware ¶
type Middleware interface {
Handler(next http.Handler) http.Handler
}func ETag ¶
ETag adds conditional response handling for buffered dynamic responses.
func ETag() Middlewarefunc Public ¶
func Public(files fs.FS) Middlewarefunc ResponseBuffer ¶
ResponseBuffer delays sending a response until the downstream handler returns.
func ResponseBuffer() Middlewarefunc RouteOnly ¶
RouteOnly applies middlewares only to requests handled by router.
func RouteOnly(router RouteHandler, middlewares ...Middleware) Middlewarefunc Router ¶
func Router(router RouteHandler) Middlewarefunc Static ¶
func Static(files fs.FS) Middlewaretype MiddlewareFunc ¶
type MiddlewareFunc func(http.Handler) http.Handlerfunc (fn MiddlewareFunc) Handler ¶
func (fn MiddlewareFunc) Handler(next http.Handler) http.Handlerfunc (MiddlewareFunc) MiddlewareName ¶
func (MiddlewareFunc) MiddlewareName() stringtype RouteHandler ¶
type RouteHandler interface {
http.Handler
HandlesPath(path string) bool
}Directories ¶
| Path | Synopsis |
|---|---|
| lazydispatch/middlewares | Package middlewares contains request middleware used by GoLazy dispatch. |
Package lazydispatch composes HTTP middleware, routes, and static fallback handlers for GoLazy.
A Dispatcher stores middleware in the order they should run. Handler wraps a final http.Handler with that chain, and ServeHTTP uses http.NotFoundHandler as the final handler. Middleware can stop a request by not calling next, or pass control to later middleware and the final handler by calling next.ServeHTTP. When a request already has a lazytracing span, each middleware call is recorded as a child tracing region.
Router adapts a RouteHandler into middleware. The RouteHandler reports whether it owns a path with HandlesPath; known paths are served by the router, and unknown paths fall through to the next handler. RouteOnly uses the same HandlesPath check to apply middleware only to routed requests. lazyapp uses RouteOnly with its lazyroutes router so route lifecycle middleware such as lazydispatch/middlewares.DynamicRoute runs for controller responses without wrapping generated metadata files or public assets.
Static and Public serve files from an fs.FS only when the requested logical path already exists in that filesystem. Missing files fall through to the next handler, and existing files accept only GET and HEAD. This package does not build an asset manifest, calculate permanent hashed URLs, rewrite CSS, or make original files unavailable. Those generated-asset behaviors belong to lazyassets.Registry; lazyapp normally uses that registry for public assets instead of Static.
ResponseBuffer delays headers and body until the downstream handler returns. BufferedResponseWriter also lets route lifecycle code reset an in-progress response or start a stream by committing headers and returning to the wrapped writer. ETag adds conditional response handling for buffered dynamic responses: eligible GET and HEAD 200 responses get a strong ETag based on the final body unless one is already set, and matching If-None-Match requests are converted to 304 Not Modified. Streaming, compressed, no-store, Set-Cookie, non-GET/HEAD, and non-OK responses are skipped.
lazyapp builds the normal application chain for most projects: optional telemetry middleware, route-only DynamicRoute handling, sessions, configured application middleware, generated metadata files, the lazyroutes router, and finally lazyassets-backed public assets. Use this package directly when composing a custom net/http stack that wants the same middleware interface, route-only middleware, buffered dynamic responses, ETags, or simple fs.FS static fallback behavior outside a full lazyapp.App.