Echo 系列教程—基础篇:Echo 核心亮点介绍

Echo 系列教程—基础篇:Echo 核心亮点介绍

在 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/ (中文)。

二、Scalable

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 的标准。

三、自动 TLS

Echo 能够通过 “Let’s Encrypt” 自动安装 TLS 证书。Echo#StartAutoTLS 接受一个接听 443 端口的网络地址。类似 :443 这样。

e.StartAutoTLS(":443")

可以通过 e.AutoTLSManager 做一些控制,比如缓存等。

四、HTTP/2

Echo 自动支持 HTTP/2。HTTP/2 (原本的名字是 HTTP/2.0) 是万维网使用的 HTTP 网络协议的第二个主要版本。HTTP/2 提供了更快的速度和更好的用户体验。

特性

  • 使用二进制格式传输数据,而不是文本。使得在解析和优化扩展上更为方便。
  • 多路复用,所有的请求都是通过一个 TCP 连接并发完成。
  • 对消息头采用 HPACK 进行压缩传输,能够节省消息头占用的网络的流量。
  • Server Push:服务端能够更快的把资源推送给客户端。

五、中间件

这是让 Echo 可扩展、功能强大、好用的关键组件。

中间件是一个函数,嵌入在 HTTP 的请求和响应之间。它可以获得 Echo#Context 对象用来进行一些特殊的操作, 比如记录每个请求或者统计请求数。

不同级别的中间件

1、根级别中间件(router 之前)

Echo#Pre() 用于注册一个在路由执行之前运行的中间件,可以用来修改请求的一些属性。比如在请求路径结尾添加或者删除一个 / 来使之能与路由匹配。

下面的这几个内建中间件应该被注册在这一级别:

  • AddTrailingSlash
  • RemoveTrailingSlash
  • MethodOverride

注意: 由于在这个级别路由还没有执行,所以这个级别的中间件不能调用任何 echo.Context 的 API。

2、根级别中间件(router 之后)

大部分时间你将用到 Echo#Use() 在这个级别注册中间件。 这个级别的中间件运行在路由处理完请求之后,可以调用所有的 echo.Context API。

下面的这几个内建中间件应该被注册在这一级别:

  • BodyLimit
  • Logger
  • Gzip
  • Recover
  • BasicAuth
  • JWTAuth
  • Secure
  • CORS
  • Static

3、组级别中间件

当在路由中创建一个组的时候,可以为这个组注册一个中间件。例如,给 admin 这个组注册一个 BasicAuth 中间件。

e := echo.New()
admin := e.Group("/admin", middleware.BasicAuth())

也可以在创建组之后用 admin.Use()注册该中间件。

4、路由级别中间件

当你创建了一个新的路由,可以选择性的给这个路由注册一个中间件。

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 的设置我们可以使用任何模板引擎。

九、可扩展(Extensible)

拥有可定制的集中 HTTP 错误处理和易于扩展的 API 等。

总结

以上是 Echo 首页给出的 9 大核心亮点,后续教程会给出详细的讲解或实际例子。

欢迎关注我的公众号:

发表评论

电子邮件地址不会被公开。

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据