You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
87 lines
3.1 KiB
87 lines
3.1 KiB
package web
|
|
|
|
import (
|
|
"net/http"
|
|
)
|
|
|
|
/*
|
|
Mux is an HTTP multiplexer, much like net/http's ServeMux.
|
|
|
|
Routes may be added using any of the various HTTP-method-specific functions.
|
|
When processing a request, when iterating in insertion order the first route
|
|
that matches both the request's path and method is used.
|
|
|
|
There are two other differences worth mentioning between web.Mux and
|
|
http.ServeMux. First, string patterns (i.e., Sinatra-like patterns) must match
|
|
exactly: the "rooted subtree" behavior of ServeMux is not implemented. Secondly,
|
|
unlike ServeMux, Mux does not support Host-specific patterns.
|
|
|
|
If you require any of these features, remember that you are free to mix and
|
|
match muxes at any part of the stack.
|
|
|
|
In order to provide a sane API, many functions on Mux take interface{}'s. This
|
|
is obviously not a very satisfying solution, but it's probably the best we can
|
|
do for now. Instead of duplicating documentation on each method, the types
|
|
accepted by those functions are documented here.
|
|
|
|
A middleware (the untyped parameter in Use() and Insert()) must be one of the
|
|
following types:
|
|
- func(http.Handler) http.Handler
|
|
- func(c *web.C, http.Handler) http.Handler
|
|
All of the route-adding functions on Mux take two untyped parameters: pattern
|
|
and handler. Pattern must be one of the following types:
|
|
- string. It will be interpreted as a Sinatra-like pattern. In
|
|
particular, the following syntax is recognized:
|
|
- a path segment starting with with a colon will match any
|
|
string placed at that position. e.g., "/:name" will match
|
|
"/carl", binding "name" to "carl".
|
|
- a pattern ending with an asterisk will match any prefix of
|
|
that route. For instance, "/admin/*" will match "/admin/" and
|
|
"/admin/secret/lair". This is similar to Sinatra's wildcard,
|
|
but may only appear at the very end of the string and is
|
|
therefore significantly less powerful.
|
|
- regexp.Regexp. The library assumes that it is a Perl-style regexp that
|
|
is anchored on the left (i.e., the beginning of the string). If your
|
|
regexp is not anchored on the left, a hopefully-identical
|
|
left-anchored regexp will be created and used instead.
|
|
- web.Pattern
|
|
Handler must be one of the following types:
|
|
- http.Handler
|
|
- web.Handler
|
|
- func(w http.ResponseWriter, r *http.Request)
|
|
- func(c web.C, w http.ResponseWriter, r *http.Request)
|
|
*/
|
|
type Mux struct {
|
|
mStack
|
|
router
|
|
}
|
|
|
|
// New creates a new Mux without any routes or middleware.
|
|
func New() *Mux {
|
|
mux := Mux{
|
|
mStack: mStack{
|
|
stack: make([]mLayer, 0),
|
|
pool: make(chan *cStack, mPoolSize),
|
|
},
|
|
router: router{
|
|
routes: make([]route, 0),
|
|
notFound: parseHandler(http.NotFound),
|
|
},
|
|
}
|
|
mux.mStack.router = HandlerFunc(mux.router.route)
|
|
return &mux
|
|
}
|
|
|
|
func (m *Mux) ServeHTTP(w http.ResponseWriter, r *http.Request) {
|
|
stack := m.mStack.alloc()
|
|
stack.ServeHTTP(w, r)
|
|
m.mStack.release(stack)
|
|
}
|
|
|
|
// ServeHTTPC creates a context dependent request with the given Mux. Satisfies
|
|
// the web.Handler interface.
|
|
func (m *Mux) ServeHTTPC(c C, w http.ResponseWriter, r *http.Request) {
|
|
stack := m.mStack.alloc()
|
|
stack.ServeHTTPC(c, w, r)
|
|
m.mStack.release(stack)
|
|
}
|