router/router.go

203 lines
5.1 KiB
Go
Raw Normal View History

2018-08-03 21:29:15 +02:00
package router
import (
"net/http"
"reflect"
"github.com/julienschmidt/httprouter"
)
type route struct {
2018-10-09 18:07:43 +02:00
Method string
Path string
Handle interface{}
Middleware []Middleware
2018-08-03 21:29:15 +02:00
}
2018-10-09 18:07:43 +02:00
// Handle handles a request
2018-10-16 18:26:06 +02:00
type Handle = func(*Context) error
2018-10-09 18:07:43 +02:00
// ErrorHandle handles a request
type ErrorHandle func(*Context, interface{})
2018-11-18 16:20:13 +01:00
// Middleware is a function that runs before your route, it gets the next handler as a parameter
2018-10-09 18:07:43 +02:00
type Middleware func(Handle) Handle
2018-08-03 21:29:15 +02:00
2018-10-09 19:18:09 +02:00
// Binder reads input to dst, returns true is successful
2018-11-18 16:29:06 +01:00
type Reader func(c *Context, dst interface{}) (bool, error)
2018-10-09 19:18:09 +02:00
2018-08-03 21:29:15 +02:00
// Router is the router itself
type Router struct {
2018-10-09 18:07:43 +02:00
routes []route
2018-10-09 19:18:09 +02:00
Reader Reader
2018-10-09 18:07:43 +02:00
Renderer Renderer
middleware []Middleware
NotFoundHandler Handle
MethodNotAllowedHandler Handle
ErrorHandler ErrorHandle
2018-08-03 21:29:15 +02:00
}
// New returns a new Router
func New() *Router {
2018-10-09 19:18:09 +02:00
return &Router{Reader: defaultReader, NotFoundHandler: defaultNotFoundHandler, MethodNotAllowedHandler: defaultMethodNotAllowedHandler, ErrorHandler: defaultErrorHandler}
2018-08-03 21:29:15 +02:00
}
2018-10-09 18:07:43 +02:00
// Use adds a global middleware
func (r *Router) Use(m ...Middleware) {
r.middleware = append(r.middleware, m...)
}
// Group creates a new router group with a shared prefix and set of middlewares
func (r *Router) Group(prefix string, middleware ...Middleware) *Group {
return &Group{prefix: prefix, router: r, middleware: middleware}
2018-08-19 17:03:53 +02:00
}
2018-08-03 21:29:15 +02:00
// GET adds a GET route
2018-10-09 18:07:43 +02:00
func (r *Router) GET(path string, handle Handle, middleware ...Middleware) {
r.routes = append(r.routes, route{`GET`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// POST adds a POST route
2018-10-09 18:07:43 +02:00
func (r *Router) POST(path string, handle interface{}, middleware ...Middleware) {
2018-08-03 21:29:15 +02:00
checkInterfaceHandle(handle)
2018-10-09 18:07:43 +02:00
r.routes = append(r.routes, route{`POST`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// DELETE adds a DELETE route
2018-10-09 18:07:43 +02:00
func (r *Router) DELETE(path string, handle Handle, middleware ...Middleware) {
r.routes = append(r.routes, route{`DELETE`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// PUT adds a PUT route
2018-10-09 18:07:43 +02:00
func (r *Router) PUT(path string, handle interface{}, middleware ...Middleware) {
2018-08-03 21:29:15 +02:00
checkInterfaceHandle(handle)
2018-10-09 18:07:43 +02:00
r.routes = append(r.routes, route{`PUT`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// PATCH adds a PATCH route
2018-10-09 18:07:43 +02:00
func (r *Router) PATCH(path string, handle interface{}, middleware ...Middleware) {
2018-08-03 21:29:15 +02:00
checkInterfaceHandle(handle)
2018-10-09 18:07:43 +02:00
r.routes = append(r.routes, route{`PATCH`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// HEAD adds a HEAD route
2018-10-09 18:07:43 +02:00
func (r *Router) HEAD(path string, handle Handle, middleware ...Middleware) {
r.routes = append(r.routes, route{`HEAD`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// OPTIONS adds a OPTIONS route
2018-10-09 18:07:43 +02:00
func (r *Router) OPTIONS(path string, handle Handle, middleware ...Middleware) {
r.routes = append(r.routes, route{`OPTIONS`, path, handle, middleware})
2018-08-03 21:29:15 +02:00
}
// Start starts the web server and binds to the given address
func (r *Router) Start(addr string) error {
httpr := r.getHttpr()
return http.ListenAndServe(addr, httpr)
}
func (r *Router) getHttpr() *httprouter.Router {
httpr := httprouter.New()
for _, v := range r.routes {
2018-10-09 18:07:43 +02:00
handle, ok := v.Handle.(Handle)
if !ok {
handle = handlePOST(r, v.Handle)
2018-08-03 21:29:15 +02:00
}
2018-10-09 18:07:43 +02:00
httpr.Handle(v.Method, v.Path, handleReq(r, handle, append(r.middleware, v.Middleware...)))
}
httpr.NotFound = http.HandlerFunc(func(res http.ResponseWriter, req *http.Request) {
handleReq(r, r.NotFoundHandler, r.middleware)(res, req, nil)
})
httpr.MethodNotAllowed = http.HandlerFunc(func(res http.ResponseWriter, req *http.Request) {
handleReq(r, r.MethodNotAllowedHandler, r.middleware)(res, req, nil)
})
httpr.PanicHandler = func(res http.ResponseWriter, req *http.Request, err interface{}) {
c := newContext(r, res, req, nil)
r.ErrorHandler(c, err)
2018-08-03 21:29:15 +02:00
}
return httpr
}
2018-10-09 18:07:43 +02:00
func handleErr(errHandler ErrorHandle, err interface{}) Handle {
return func(c *Context) error {
errHandler(c, err)
return nil
}
}
2018-08-03 21:29:15 +02:00
func checkInterfaceHandle(f interface{}) {
2018-10-09 18:07:43 +02:00
if _, ok := f.(Handle); ok {
2018-08-03 21:29:15 +02:00
return
}
rt := reflect.TypeOf(f)
if rt.Kind() != reflect.Func {
panic(`non-func handle`)
}
if rt.NumIn() != 2 {
panic(`handle should take 2 arguments`)
}
if rt.NumOut() != 1 || rt.Out(0).Name() != `error` {
panic(`handle should return only error`)
}
if rt.In(0) != reflect.TypeOf(&Context{}) {
panic(`handle should accept Context as first argument`)
}
return
}
2018-10-09 18:07:43 +02:00
func handlePOST(r *Router, f interface{}) Handle {
2018-08-03 21:29:15 +02:00
funcRv, inputRt := reflect.ValueOf(f), reflect.TypeOf(f).In(1)
2018-10-09 18:07:43 +02:00
return func(c *Context) error {
2018-08-03 21:29:15 +02:00
data := reflect.New(inputRt)
2018-10-09 18:07:43 +02:00
2018-11-18 16:29:06 +01:00
if r.Reader != nil {
ok, err := r.Reader(c, data.Interface())
2018-10-09 19:18:09 +02:00
c.Request.Body.Close()
2018-11-18 16:29:06 +01:00
if err != nil {
return err
}
if !ok {
return nil
}
2018-08-03 21:29:15 +02:00
}
out := funcRv.Call([]reflect.Value{reflect.ValueOf(c), data.Elem()})
2018-10-09 18:07:43 +02:00
if out[0].IsNil() {
return nil
}
return out[0].Interface().(error)
2018-08-03 21:29:15 +02:00
}
}
2018-10-09 18:07:43 +02:00
func handleReq(r *Router, handle Handle, m []Middleware) httprouter.Handle {
2018-08-03 21:29:15 +02:00
return func(res http.ResponseWriter, req *http.Request, param httprouter.Params) {
2018-08-19 17:04:29 +02:00
c := newContext(r, res, req, param)
2018-08-03 21:29:15 +02:00
2018-10-09 18:07:43 +02:00
f := handle
for i := len(m) - 1; i >= 0; i-- { // TODO: 1,2,3 of 3,2,1
f = m[i](f)
}
2018-08-03 21:29:15 +02:00
err := f(c)
2018-10-09 18:07:43 +02:00
if err != nil {
r.ErrorHandler(c, err)
}
2018-08-03 21:29:15 +02:00
}
}