在 Echo 的官网的首页,列出了 9 个核心功能或亮点。我这里将它说成是亮点(也许并不一定都比其他框架更好)。
高度优化的 HTTP 路由,动态内存分配为零,可对路由进行优先级排序。
这一点从上一篇:[搭建 Echo 开发环境](基础篇:搭建 Echo 开发环境.md) 可以看到。
Echo 路由基于 radix tree ,查询速度非常快。路由使用 sync pool 来重用内存,实现无 GC 开销下的零动态内存分配。
各大框架路由的注册和使用方式都类似,通过 HTTP 方法(GET、POST、PUT、DELETE 等),将 url 路径和一个处理程序绑定在一起,唯一不太一样的一般是处理程序的函数签名不一样(主要参数类型不一样)。例如,下面的代码则展示了一个注册路由的例子:它包括 GET 的访问方式, /hello 的访问路径,以及发送 Hello World HTTP 响应的处理程序。
// 业务处理
func hello(c echo.Context) error {
return c.String(http.StatusOK, "Hello, World!")
}
// 路由
e.GET("/hello", hello)
更多路由的特性,参考文档:https://echo.labstack.com/guide/routing/(英文)、 http://go-echo.org/guide/routing/ (中文)。
Echo 方便构建健壮的 RESTful API,轻松将其组织起来。
根据上一节路由,我们可以轻松构建出 RESTful API,比如:
e.POST("/user", createUser)
e.GET("/user/1", findUser)
e.PUT("/user/1", updateUser)
e.DELETE("/user/1", deleteUser)
可以轻松对应上 RESTful API 的标准。
Echo 能够通过 “Let’s Encrypt” 自动安装 TLS 证书。Echo#StartAutoTLS 接受一个接听 443 端口的网络地址。类似 :443 这样。
e.StartAutoTLS(":443")
可以通过 e.AutoTLSManager 做一些控制,比如缓存等。
Echo 自动支持 HTTP/2。HTTP/2 (原本的名字是 HTTP/2.0) 是万维网使用的 HTTP 网络协议的第二个主要版本。HTTP/2 提供了更快的速度和更好的用户体验。
这是让 Echo 可扩展、功能强大、好用的关键组件。
中间件是一个函数,嵌入在 HTTP 的请求和响应之间。它可以获得 Echo#Context 对象用来进行一些特殊的操作, 比如记录每个请求或者统计请求数。
Echo#Pre() 用于注册一个在路由执行之前运行的中间件,可以用来修改请求的一些属性。比如在请求路径结尾添加或者删除一个 / 来使之能与路由匹配。
下面的这几个内建中间件应该被注册在这一级别:
注意: 由于在这个级别路由还没有执行,所以这个级别的中间件不能调用任何 echo.Context 的 API。
大部分时间你将用到 Echo#Use() 在这个级别注册中间件。 这个级别的中间件运行在路由处理完请求之后,可以调用所有的 echo.Context API。
下面的这几个内建中间件应该被注册在这一级别:
当在路由中创建一个组的时候,可以为这个组注册一个中间件。例如,给 admin 这个组注册一个 BasicAuth 中间件。
e := echo.New()
admin := e.Group("/admin", middleware.BasicAuth())
也可以在创建组之后用 admin.Use()注册该中间件。
当你创建了一个新的路由,可以选择性的给这个路由注册一个中间件。
e := echo.New()
e.GET("/", <Handler>, <Middleware...>)
HTTP 请求有效负载的数据绑定,包括 JSON,XML 或表单数据。
可以使用 Context#Bind(i interface{}) 将请求内容体绑定至 go 的结构体。默认绑定器支持基于 Content-Type 请求头包含 application/json,application/xml 和 application/x-www-form-urlencoded 的数据。
下面是绑定请求数据到 User 结构体的例子。
// User
User struct {
Name string `json:"name" form:"name" query:"name"`
Email string `json:"email" form:"email" query:"email"`
}
// Handler
func(c echo.Context) (err error) {
u := new(User)
if err = c.Bind(u); err != nil {
return
}
return c.JSON(http.StatusOK, u)
}
以上代码支持如下请求数据的绑定:
1、JSON 数据
curl \
-X POST \
http://localhost:1323/users \
-H 'Content-Type: application/json' \
-d '{"name":"Joe","email":"joe@labstack"}'
2、Form 表单数据
curl \
-X POST \
http://localhost:1323/users \
-d 'name=Joe' \
-d 'email=joe@labstack.com'
3、查询参数 (Query Parameters)
curl \
-X GET \
http://localhost:1323/users\?name\=Joe\&email\=joe@labstack.com
有发送各种 HTTP 响应的 API,包括 JSON,XML,HTML,文件,附件,内联,流或 Blob。
支持使用任何模板引擎进行模板渲染。
使用 Context#Render(code int, name string, data interface{}) error 命令渲染带有数据的模板,并发送带有状态代码的 text/html 响应。通过 Echo.Renderer 的设置我们可以使用任何模板引擎。
拥有可定制的集中 HTTP 错误处理和易于扩展的 API 等。
以上是 Echo 首页给出的 9 大核心亮点,后续教程会给出详细的讲解或实际例子。