Bon is fast http router of Go designed by Patricia tree
Features
- Lightweight
- Middleware framework
- Not use third party package
- Standard http request handler
- Flexible routing
Match Patterns
Priority high order
staticis exact match/users/taro
paramis directorys range match/users/:name
anyis all range match/*
package main
import (
"net/http"
"github.com/nissy/bon"
)
func main() {
r := bon.NewRouter()
r.Get("/users/taro", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("static"))
})
r.Get("/users/:name", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("param name is " + bon.URLParam(r, "name")))
})
r.Get("/*", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("any"))
})
http.ListenAndServe(":8080", r)
}Example
Groupis inherits middleware and grants a prefixRouteis does not inherit middleware
package main
import (
"net/http"
"github.com/nissy/bon"
"github.com/nissy/bon/middleware"
)
func main() {
r := bon.NewRouter()
v := r.Group("/v1")
v.Use(
middleware.CORS(middleware.AccessControlConfig{
AllowOrigin: "*",
AllowCredentials: false,
AllowMethods: []string{
http.MethodGet, http.MethodPost, http.MethodPut, http.MethodDelete, http.MethodOptions,
},
AllowHeaders: []string{
"Authorization",
},
ExposeHeaders: []string{
"link",
},
MaxAge: 86400,
}),
)
v.Options("*", func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusNoContent)
})
v.Get("/users/:name", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hallo," + bon.URLParam(r, "name")))
})
admin := r.Group("/admin")
admin.Use(
middleware.BasicAuth([]middleware.BasicAuthUser{
{
Name: "name",
Password: "password",
},
}),
)
admin.Get("/users/:name", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("Hallo, " + bon.URLParam(r, "name")))
})
http.ListenAndServe(":8080", r)
}Benchmarks
GitHub
The GitHub API is rather large, consisting of 203 routes. The tasks are basically the same as in the benchmarks before.
Bon 10000 105265 ns/op 42753 B/op 167 allocs/op
Other http routers
Beego 3000 464848 ns/op 74707 B/op 812 allocs/op
Chi 10000 152969 ns/op 61714 B/op 406 allocs/op
Denco 20000 62366 ns/op 20224 B/op 167 allocs/op
GorillaMux 300 4686063 ns/op 215088 B/op 2272 allocs/op
Gin 100000 22283 ns/op 0 B/op 0 allocs/op
HttpRouter 30000 41143 ns/op 13792 B/op 167 allocs/op
LARS 50000 22996 ns/op 0 B/op 0 allocs/op
Possum 10000 212328 ns/op 84451 B/op 609 allocs/op
Rivet 20000 72324 ns/op 16272 B/op 167 allocs/op
Tango 5000 285607 ns/op 63834 B/op 1618 allocs/op
Vulcan 10000 177044 ns/op 19894 B/op 609 allocs/op