router

func (*Chain) Handler ¶

func (r *Chain) Handler() http.Handler

Handler returns the final handler with all middlewares and observers applied

func (*Chain) WithMiddleware ¶

func (r *Chain) WithMiddleware(middlewares ...func(http.Handler) http.Handler) *Chain

WithMiddleware adds one or more middlewares to the chain. Middlewares execute in the order they are defined, from left to right. For example:

.WithMiddleware(mw1, mw2, mw3)

Will execute as: 1. mw1 (first middleware runs first) 2. mw2 3. mw3 4. Handler

This follows the same semantics as popular middleware chaining packages like Alice (github.com/justinas/alice) where the first middleware in the chain is the outermost handler that runs first. This matches the natural reading order of the code and makes it easier to reason about middleware execution.

func (*Chain) WithMiddlewareChain ¶

func (r *Chain) WithMiddlewareChain(middlewares []func(http.Handler) http.Handler) *Chain

WithMiddlewareChain prepends a chain of middlewares (added in given order)

func (*Chain) WithObservers ¶

func (r *Chain) WithObservers(observers ...http.Handler) *Chain

WithObservers adds handlers that run after the handler and middleware chain. Observers are typically used for logging, metrics collection, and other side effects. Note that observers will execute even if middleware returns early or stops processing. Observers should not write to the response as the main handler may have already sent headers. Use carefully as this could lead to unintended side effects when middleware fails.