Iris 具有用于路由的表达语法，感觉就像在家一样。路由算法是强大的，通过 muxie 来处理请求和比其替代品(httprouter、gin、echo) 更快地匹配路由。

让我们没有任何麻烦地开始吧！

新建一个空文件，命名为 example.go，然后打开它复制粘贴下面的代码。

  1. package main
  3. import "github.com/kataras/iris/v12"
  5. func main() {
  6.     app := iris.Default()
  7.     app.Use(myMiddleware)
  9.     app.Handle("GET", "/ping", func(ctx iris.Context) {
  10.         ctx.JSON(iris.Map{"message": "pong"})
  11.     })
  13.     // Listens and serves incoming http requests
  14.     // on http://localhost:8080.
  15.     app.Run(iris.Addr(":8080"))
  16. }
  18. func myMiddleware(ctx iris.Context) {
  19.     ctx.Application().Logger().Infof("Runs before %s", ctx.Path())
  20.     ctx.Next()
  21. }

打开终端会话，执行下面的指令，然后再浏览器上访问 http://localhost:8000/ping：

  1. $ go run example.go

展示更多(Show me more)

我们简单地启动和运行程序来获取一个页面。

  1. package main
  3. import "github.com/kataras/iris/v12"
  5. func main() {
  6.     app := iris.New()
  7.     // Load all templates from the "./views" folder
  8.     // where extension is ".html" and parse them
  9.     // using the standard `html/template` package.
  10.     app.RegisterView(iris.HTML("./views", ".html"))
  12.     // Method:    GET
  13.     // Resource:  http://localhost:8080
  14.     app.Get("/", func(ctx iris.Context) {
  15.         // Bind: {{.message}} with "Hello world!"
  16.         ctx.ViewData("message", "Hello world!")
  17.         // Render template file: ./views/hello.html
  18.         ctx.View("hello.html")
  19.     })
  21.     // Method:    GET
  22.     // Resource:  http://localhost:8080/user/42
  23.     //
  24.     // Need to use a custom regexp instead?
  25.     // Easy;
  26.     // Just mark the parameter's type to 'string'
  27.     // which accepts anything and make use of
  28.     // its `regexp` macro function, i.e:
  29.     // app.Get("/user/{id:string regexp(^[0-9]+$)}")
  30.     app.Get("/user/{id:uint64}", func(ctx iris.Context) {
  31.         userID, _ := ctx.Params().GetUint64("id")
  32.         ctx.Writef("User ID: %d", userID)
  33.     })
  35.     // Start the server using a network address.
  36.     app.Run(iris.Addr(":8080"))
  37. }

html 文件：./views/hello.html

  1. <html>
  2. <head>
  3.     <title>Hello Page</title>
  4. </head>
  5. <body>
  6.     <h1>{{ .message }}</h1>
  7. </body>
  8. </html>

想要当你的代码发生改变时自动重启你的程序？安装 rizla 工具，执行 rizla main.go 来替代 go run main.go。