Named Route

Named route is used for reverse route generation.

  1. router.Get("/login", login, clevergo.RouteName("login"))
  2. router.Get("/posts/:year/:month/:day/:slug", queryPost, clevergo.RouteName("post"))

And then, use it in middleware, handler or views.

  1. func handler(ctx *clevergo.Context) error {
  2.     loginURL, err := ctx.RouteURL("login")
  3.     fmt.Println(loginURL.String()) // /login
  5.     postURL, err := ctx.RouteURL("post")
  6.     fmt.Println(err) // route "post" parameter "year" is required
  8.     postURL, err = ctx.RouteURL("post", "year", "2020", "month", "04", "day", "09", "slug", "hello world")
  9.     fmt.Println(postURL.String()) // /posts/2020/04/09/hello%20world
  11.     // arguments are unordered, the following code has the same effect.
  12.     postURL, err = ctx.RouteURL("post", "month", "04", "slug", "hello world", "day", "09", "year", "2020")
  13.     fmt.Println(postURL.String()) // /posts/2020/04/09/hello%20world
  15.     return err
  16. }

ctx.RouteURL equals to router.URL.

Matched Route

Matched route is another way to generate URLs of the current route without naming it.

  2. func listPost(ctx *clevergo.Context) error {
  3.     nextURL, nil := ctx.Route.URL()
  5.     page := ctx.DefaultQuery("page", "1")f
  6.     pageNum, nil := strconv.Atoi(page)
  7.     page = strconv.Itoa(pageNum + 1)
  8.     q := nextURL.Query()
  9.     q.Set("page", page)
  10.     nextURL.RawQuery = q.Encode()
  12.     fmt.Println(nextURL.String()) // /posts?page=2, /posts?page=3 ...
  13.     return nil
  14. }
  16. router.Get("/posts", listPost)

Matched route cannot be used in global middleware, since route resolve is trigger after invoking global middleware, see Request Lifecycle.