Route

A very efficient and minimal HTTP Go router, using a Trie data structure for efficiency.

Based on https://github.com/ant0ine/go-json-rest with the kitchen-sink philosophy stuff removed (so much that I wouldn't particularly consider it a fork).

It aims to be the innermost handler in a composition of handlers. It doesn't require methods to have http.HandlerFunc signature, as route paths are interface{}.

Install

go get github.com/mantasmatelis/go-route

Basic Usage

import(
    "net/http"
    "github.com/mantasmatelis/go-trie-url-route")

var router route.Router

func main() {
    router.SetRoutes(
	route.Route{"POST", "/count/:Count",    SetCount},
        route.Route{"GET",  "/count"            GetCount},
        route.Route{"POST", "/count",           IncrementCount},
        route.Route{"POST", "/reset",           ResetCount},
    )
    
    http.ListenAndServe(":3000", http.HandlerFunc(handler))
}

func handler(w http.ResponseWriter, r *http.Request) {
    route, params, pathMatched := router.FindRouteFromURL(r.Method, r.URL)
    if route != nil {
        route.Func.(func(http.ResponseWriter, *http.Request, map[string]string))(w, r, params)
    }
}

...

Differences

How is this different from ant0ine/go-json-rest? This doesn't:

• Log
• Handle errors
• Route automatically
• Have any settings
• Override http.Request or http.ResponseWriter (which makes interfacing with other libraries easier)
• Force specific handler signatures on you (in the example you can see the route.Func is typecast before being called. Use this feature to pass a "Context" struct containing request information, like the authenticated user object, or pass the "params" in the url string.)

It exposes the basic router so that your own stack of handlers can be easily written, customized to specific needs.

Enjoy! Pull requests maintaining the basic above philosophy are welcomed.