geekip/mux

A simple and lightweight Go HTTP router implemented using a trie tree.

Features

• Static routes
• Custom handler
• Custom error handler
• Methods
• Parameters
• Regexp
• Wildcard
• Group
• Middleware
• FileServe

Principle

Based on Trie, using Radix Tree for path compression. The time complexity for insertion and search operations remains O(m), but the constant factor is relatively small in practice.

Install

$ go get -u github.com/geekip/mux

Usage

Static routes

func handler(w http.ResponseWriter, req *http.Request) {
  w.Write([]byte("hello world!"))
}

func main() {
  router := mux.New()
  router.Handle("/hello", http.HandlerFunc(handler))
  router.HandlerFunc("/world", handler)

  log.Fatal(http.ListenAndServe(":8080", router))
}

Custom handler

type Handler struct{
  content string
}

func (h *Handler) ServeHTTP(w http.ResponseWriter, req *http.Request) {
  w.Write([]byte(h.content))
}

func main() {
  router := mux.New()
  router.Handle("/hello", &Handler{content: "Custom handler"})

  log.Fatal(http.ListenAndServe(":8080", router))
}

Custom error handler

func handler(w http.ResponseWriter, req *http.Request) {
  w.Write([]byte("hello world!"))
}

func main() {
  router := mux.New()
  router.NotFoundHandler(func(w http.ResponseWriter, r *http.Request) {
    http.Error(w, "404 page not found", http.StatusNotFound)
  })
  router.InternalErrorHandler(func(w http.ResponseWriter, r *http.Request, err interface{}) {
    http.Error(w, "500 internal server error", http.StatusInternalServerError)
  })
  router.MethodNotAllowedHandler(func(w http.ResponseWriter, r *http.Request) {
    http.Error(w, "405 method not allowed", http.StatusMethodNotAllowed)
  })
  router.PanicHandler(func(err error) {
    panic(err)
  })


  router.HandlerFunc("/user", handler)
  log.Fatal(http.ListenAndServe(":8080", router))
}

Methods

func handler(w http.ResponseWriter, req *http.Request) {
  w.Write([]byte("hello world!"))
}

func main() {
  router := mux.New()
  // all Methods
  router.Handle("/hello", http.HandlerFunc(handler))
  router.Method("*").Handle("/hello", http.HandlerFunc(handler))
  // GET
  router.Method("GET").Handle("/hello", http.HandlerFunc(handler))
  // More...
  router.Method("POST","PUT").Handle("/hello", http.HandlerFunc(handler))

  log.Fatal(http.ListenAndServe(":8080", router))
}

Parameters

func handler(w http.ResponseWriter, req *http.Request) {
  params,_ := mux.Params(req)
  w.Write([]byte("id:" + params["id"]))
}

func main() {
  router := mux.New()
  // http://localhost:8080/user/123
  router.Handle("/user/{id}", http.HandlerFunc(handler))
  
  log.Fatal(http.ListenAndServe(":8080", router))
}

Regexp

func handler(w http.ResponseWriter, req *http.Request) {
  params := mux.Params(req)
  w.Write([]byte("id:" + params["id"] + " name:" + params["name"]))
}

func main() {
  router := mux.New()
  // http://localhost:8080/user/123/nick
  router.Handle("/user/{id:[0-9]+}/{name:[a-zA-Z]+}", http.HandlerFunc(handler))

  log.Fatal(http.ListenAndServe(":8080", router))
}

Wildcard

func handler(w http.ResponseWriter, req *http.Request) {
  params := mux.Params(req)
  // foo/bar
  w.Write([]byte(params["*"] + params["*named"]))
}

func main() {
  router := mux.New()
  // http://localhost:8080/user/foo/bar
  router.Handle("/user/{*}", http.HandlerFunc(handler))
  router.Handle("/user/{*named}", http.HandlerFunc(handler))
  
  log.Fatal(http.ListenAndServe(":8080", router))
}

Group

func handler(w http.ResponseWriter, req *http.Request) {
  w.Write([]byte("hello world!"))
}

func main() {
  router := mux.New()
  user := router.Group("/admin")
  {
    // get /admin/user/list
    user.Method("GET").HandlerFunc("/user",handler)
    // put /admin/user/edit
    user.Method("PUT").HandlerFunc("/user",handler)
  }
  
  log.Fatal(http.ListenAndServe(":8080", router))
}

Middleware

func handler(w http.ResponseWriter, req *http.Request) {
  w.Write([]byte("hello world!"))
}

func middleware1(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    ctx := context.WithValue(r.Context(), "user", "admin")
    w.Write([]byte("middleware 1"))
    next.ServeHTTP(w, r.WithContext(ctx))
  })
}

func middleware2(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    if user, ok := r.Context().Value("user").(string); ok {
      w.Write([]byte("middleware 2, user:"+user))
    }
    next.ServeHTTP(w, r)
  })
}

func main() {
  router := mux.New()
  router.Use(middleware1, middleware2)
  router.HandlerFunc("/user", handler)
  
  log.Fatal(http.ListenAndServe(":8080", router))
}

FileServe

func fileHandler(dir string) http.Handler {
  return func(w http.ResponseWriter, req *http.Request) {
    params := mux.Params(req)
    basePath := strings.TrimSuffix(req.URL.Path, params["*"])
    fs := http.StripPrefix(basePath, http.FileServer(http.Dir(dir)))
    fs.ServeHTTP(w, req)
  }
}

func main() {
  router := mux.New()
  router.HandleFunc("/files/{*}",fileHandler("./folder"))
  
  log.Fatal(http.ListenAndServe(":8080", router))
}