About

Acacia is lightweight package that will help you to route http server. Acacia route the path based on tree data structure. This package also support parameters in the path, so it will help you to build http routing with some parameters. in the path

---

Install

$ go get github.com/MeiSastraJayadi/acacia

---

Router

Create New Router

router := multiplexer.NewRouter("/")

Add Prefix to the Router

SetPrefix will add a prefix into the router path. the parameter that will be accept in function SetPrefix is just a string

router := multiplexer.NewRouter("/")
router = router.SetPrefix("product")

Add Some Methods

With Router.Methods(), some methods will be added into the router. The methods can be added more than just one method if the router can handle more than one methods

router := multiplexer.NewRouter("/")
routerPost := router.Methods(http.MethodsPost)

Or

router := multiplexer.NewRouter("/")
routerPost := router.Methods(http.MethodsPost, http.MethodGet)

Add Subrouter

A router can be added some subrouter from another router. To do that, what you can do is

router := multiplexer.NewRouter("/")
routerPost := router.Methods(http.MethodsPost, http.MethodGet)

subrouter := multiplexer.NewRouter("/") 
subrouter.SetPrefix("product")
subrouterPost := subrouter.Methods(http.MethodGet)
router.SubRouter(subrouter)

Path with Parameter

You can specify a parameter in path, and you can use the parameter to get the value from URL path. To do that what you can do is

router := multiplexer.NewRouter("/").SetPrefix("category")

router.Methods(http.MethodGet).HandleFunc("/{path_slug:slug}", thePathHandlerFunction)

In code abobe we create parameter in the path and named it as path_slug, to set parameter you should writer it as {name_of_parameter:type_of_paremeter}

Theres some type you can use in the parameter, you can check it below :

-- float : parameter with float type

-- int : parameter with integer type

-- slug : parameter with slug

-- string : default parameter

Get Value from Parameters

To get value from the parameters you can use Vars function. Here is the example

func someHandlerFunc(w http.ResponseWriter, r *http.Request) {
  vr := multiplexer.Vars(r) 
  path_slug := vr["path_slug"] // Get path_slug parameter from the URL path
}