快速开始

安装

  1. $ go get -u github.com/labstack/echo/...

编写 Hello, World!

创建 server.go 文件

  1. package main
  2. import (
  3. "net/http"
  4. "github.com/labstack/echo"
  5. )
  6. func main() {
  7. e := echo.New()
  8. e.GET("/", func(c echo.Context) error {
  9. return c.String(http.StatusOK, "Hello, World!")
  10. })
  11. e.Logger.Fatal(e.Start(":1323"))
  12. }

启动服务

  1. $ go run server.go

用浏览器访问 http://localhost:1323 然后就能在页面上看到 Hello, World!

路由

  1. e.POST("/users", saveUser)
  2. e.GET("/users/:id", getUser)
  3. e.PUT("/users/:id", updateUser)
  4. e.DELETE("/users/:id", deleteUser)

URL路径参数

  1. // e.GET("/users/:id", getUser)
  2. func getUser(c echo.Context) error {
  3. // User ID 来自于url `users/:id`
  4. id := c.Param("id")
  5. return c.String(http.StatusOK, id)
  6. }

用浏览器访问 http://localhost:1323/users/Joe 然后就能在页面上看到 Joe

请求参数

/show?team=x-men&member=wolverine

  1. // e.GET("/show", show)
  2. func show(c echo.Context) error {
  3. // 从请求参数里获取 team 和 member 的值
  4. team := c.QueryParam("team")
  5. member := c.QueryParam("member")
  6. return c.String(http.StatusOK, "team:" + team + ", member:" + member)
  7. }

从浏览器访问 http://localhost:1323/show?team=x-men&member=wolverine 可以看到页面上显示”team:x-men, member:wolverine”

表单 application/x-www-form-urlencoded

POST /save

name value
name Joe Smith
email joe@labstack.com
  1. // e.POST("/save", save)
  2. func save(c echo.Context) error {
  3. // 获取 name 和 email 的值
  4. name := c.FormValue("name")
  5. email := c.FormValue("email")
  6. return c.String(http.StatusOK, "name:" + name + ", email:" + email)
  7. }

在命令行里执行下面的语句

  1. $ curl -F "name=Joe Smith" -F "email=joe@labstack.com" http://localhost:1323/save

控制台会输出name:Joe Smith, email:joe@labstack.com

表单 multipart/form-data

POST /save

name value
name Joe Smith
avatar avatar
  1. func save(c echo.Context) error {
  2. // Get name
  3. name := c.FormValue("name")
  4. // Get avatar
  5. avatar, err := c.FormFile("avatar")
  6. if err != nil {
  7. return err
  8. }
  9. // Source
  10. src, err := avatar.Open()
  11. if err != nil {
  12. return err
  13. }
  14. defer src.Close()
  15. // Destination
  16. dst, err := os.Create(avatar.Filename)
  17. if err != nil {
  18. return err
  19. }
  20. defer dst.Close()
  21. // Copy
  22. if _, err = io.Copy(dst, src); err != nil {
  23. return err
  24. }
  25. return c.HTML(http.StatusOK, "<b>Thank you! " + name + "</b>")
  26. }

命令行执行下面语句

  1. $ curl -F "name=Joe Smith" -F "avatar=@/path/to/your/avatar.png" http://localhost:1323/save
  2. //output => <b>Thank you! Joe Smith</b>

使用以下命令查看刚刚上传的图片

  1. cd <project directory>
  2. ls avatar.png
  3. // => avatar.png

处理请求

  • 根据 Content-Type 请求标头将 jsonxmlformquery 负载绑定到 Go 结构中。
  • 通过状态码将响应渲染为 json 或者 xml 格式。
  1. type User struct {
  2. Name string `json:"name" xml:"name" form:"name" query:"name"`
  3. Email string `json:"email" xml:"email" form:"email" query:"email"`
  4. }
  5. e.POST("/users", func(c echo.Context) error {
  6. u := new(User)
  7. if err := c.Bind(u); err != nil {
  8. return err
  9. }
  10. return c.JSON(http.StatusCreated, u)
  11. // 或者
  12. // return c.XML(http.StatusCreated, u)
  13. })

静态资源

下面的代码定义/static/*目录为静态资源文件目录

  1. e.Static("/static", "static")
了解更多

模板渲染

中间件

  1. // Root level middleware
  2. e.Use(middleware.Logger())
  3. e.Use(middleware.Recover())
  4. // Group level middleware
  5. g := e.Group("/admin")
  6. g.Use(middleware.BasicAuth(func(username, password string, c echo.Context) (error, bool) {
  7. if username == "joe" && password == "secret" {
  8. return nil, true
  9. }
  10. return nil, false
  11. }))
  12. // Route level middleware
  13. track := func(next echo.HandlerFunc) echo.HandlerFunc {
  14. return func(c echo.Context) error {
  15. println("request to /users")
  16. return next(c)
  17. }
  18. }
  19. e.GET("/users", func(c echo.Context) error {
  20. return c.String(http.StatusOK, "/users")
  21. }, track)
了解更多