Nesting of Handlers

Requirements in RESTful APIs

  • Requests like GET /api/v1/users/1/addresses/5 show the usage of resources and subresources together with their individual identifiers
  • A typical pattern is {prefix}/{resource}/{id}/{subresource}/{subresource-id}/...
  • The type http.ServeMux does not handle a direct matching as IDs as the part of the path are changing
  • So own path helpers and a multiplexer are needed


  • NestedMux is a multiplexer of handlers based on resource names
  • A path is a number of resource names separated by slashes
  • E.g. customers, customers/addresses, and customers/contracts are all valid paths
// NestedMux allows to nest handler following the pattern
// {prefix}/{resource}/{id}/{subresource}/{subresource-id}/...
type NestedMux struct {
    mu       sync.RWMutex
    prefix   string
    handlers map[string]http.Handler

// NewNestedMux creates an empty nested multiplexer.
func NewNestedMux(prefix string) *NestedMux {
    return &NestedMux{
        prefix:   prefix,
        handlers: make(map[string]http.Handler),

// Handle registers the handler for the given resource name. Nested names
// are separated by a slash.
func (mux *NestedMux) Handle(path string, h http.Handler) {

    mux.handlers[path] = h

// ServeHTTP implements http.Handler.
func (mux *NestedMux) ServeHTTP(w http.ResponseWriter, r *http.Request) {

    ress := PathToResources(r, mux.prefix)
    path := ress.Path()
    h, exists := mux.handlers[path]

    if !exists {
        h = http.NotFoundHandler()

    h.ServeHTTP(w, r)