Route Rules

Overview

In go-zero, we declared HTTP service via api language, and then generated HTTP service code via goctl, after our systematic introduction to API norm.

In api description, there are specific routing rules that are not fully referenced to HTTP routing rules. Next, let’s take a look at the routing rules in api description.

Route Rules

In api description, routing needs to meet the following rules

  1. Route must start with /
  2. Route node must be separated by /
  3. A router node can contain :but : must be the first character of a router node,: The next node value must have path in the checkout body tag statement, used to receive routing parameters, refer to detailed rules routing parameters.
  4. Route nodes can contain letters, numbers (goctl 1.5.1 , referencenew API solver use), underscore, dash

Route Example：

  1. syntax = "v1"
  3. type DemoPath3Req {
  4.     Id int64 `path:"id"`
  5. }
  7. type DemoPath4Req {
  8.     Id   int64  `path:"id"`
  9.     Name string `path:"name"`
  10. }
  12. type DemoPath5Req {
  13.     Id   int64  `path:"id"`
  14.     Name string `path:"name"`
  15.     Age  int    `path:"age"`
  16. }
  18. type DemoReq {}
  20. type DemoResp {}
  22. service Demo {
  23.     // route example /foo
  24.     @handler demoPath1
  25.     get /foo (DemoReq) returns (DemoResp)
  27.     // route example /foo/bar
  28.     @handler demoPath2
  29.     get /foo/bar (DemoReq) returns (DemoResp)
  31.     // route example /foo/bar/:id，where id is a field in the request body
  32.     @handler demoPath3
  33.     get /foo/bar/:id (DemoPath3Req) returns (DemoResp)
  35.     // route example /foo/bar/:id/:name，where id and name are fields in the request body
  36.     @handler demoPath4
  37.     get /foo/bar/:id/:name (DemoPath4Req) returns (DemoResp)
  39.     // route example /foo/bar/:id/:name/:age，where id, name, age are the fields in the request body
  40.     @handler demoPath5
  41.     get /foo/bar/:id/:name/:age (DemoPath5Req) returns (DemoResp)
  43.     // route example /foo/bar/baz-qux
  44.     @handler demoPath6
  45.     get /foo/bar/baz-qux (DemoReq) returns (DemoResp)
  47.     // route example/foo/bar_baz/123(support version after goctl 1.5.1)
  48.     @handler demoPath7
  49.     get /foo/bar_baz/123 (DemoReq) returns (DemoResp)
  50. }