Go 语言 Web 框架 Echo 系列:基础篇—通过一个例子串联各特性
liuian 2025-05-08 02:46 91 浏览
通过前面的介绍,相信对 echo 有了一个初步的认识。本文我们通过一个简单的登录页面来串联 echo 的相关特性。因为该文主要关注各个特性,所以在目录结构和代码组织方面很随意。
本节最终效果
1)登录页面
2)登录失败
3)登录成功
main 函数骨架
使用 echo 框架,在程序入口处一般包含如下内容:
func main() {
// 创建 echo 实例
e := echo.New()
// 配置日志
configLogger(e)
// 注册静态文件路由
e.Static("img", "img")
e.File("/favicon.ico", "img/favicon.ico")
// 设置中间件
setMiddleware(e)
// 注册路由
RegisterRoutes(e)
// 启动服务
e.Logger.Fatal(e.Start(":2019"))
}日志
echo 中定义了一个接口:Logger,而 Echo 结构体有一个该接口的字段,这也就是 main 函数最后一句:e.Logger.Fatal 可以这么用的原因。框架中该接口的具体实现使用的是
github.com/labstack/gommon/log,如果需要,我们可以采用自己的实现,替换框架默认的。
默认情况下,日志输出到终端,而且 Level 级别是 ERROR,我们可以方便的通过 Logger 接口提供的方法进行修改:
func configLogger(e *echo.Echo) {
// 定义日志级别
e.Logger.SetLevel(log.INFO)
// 记录业务日志
echoLog, err := os.OpenFile("log/echo.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
panic(err)
}
// 同时输出到文件和终端
e.Logger.SetOutput(io.MultiWriter(os.Stdout, echoLog))
}为了方便,开发中我将日志同时输出到了终端和文件中。
中间件
几乎所有的 Web 框架都支持中间件。其实这里的中间件跟传统的中间件不是一回事,这里的中间件其实是一种装饰模式。闲言少叙,我们看看 Echo 的中间件。
以 Recover 中间件为例讲解。
中间件标准签名
通过 Echo.Use 方法知晓,中间件是 MiddlewareFunc 类型,它的定义如下:
type MiddlewareFunc func(echo.HandlerFunc) echo.HandlerFunc也就是说,一个中间件应该是 MiddlewareFunc 类型。所以,一个函数,只要返回 MiddlewareFunc 类型就是一个 Echo 中间件。
func Recover() echo.MiddlewareFunc {
...
}支持配置的中间件
Echo 的中间件通常都支持以下功能:
- 通过配置修改中间件的行为
- 可以选择是否跳过该中间件
一般做法就是:
- 定义一个类型,如:RecoverConfig,用于配置 Recover 中间件的行为;
- 给上述类型的一个默认实例:DefaultRecoverConfig;
- 定义一个支持传递配置的函数,返回中间件类型,如:RecoverWithConfig;
- 定义一个不带参数的函数,返回中间件类型,内部调用带参数的中间件函数,参数用默认实例,如:Recover,它的实现是直接调用 RecoverWithConfig(DefaultRecoverConfig);
我们的例子代码中就通过配置修改了中间件行为:
// access log 输出到文件中
accessLog, err := os.OpenFile("log/access.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0644)
if err != nil {
panic(err)
}
// 同时输出到终端和文件
middleware.DefaultLoggerConfig.Output = accessLog
e.Use(middleware.Logger())自己定义一个简单中间件
很多时候,我们业务的中间件,不需要那么灵活,没必要通过配置来控制行为,这时候可以像例子中的 AutoLogin 一样:
// AutoLogin 如果上次记住了,则自动登录
func AutoLogin(next echo.HandlerFunc) echo.HandlerFunc {
return func(ctx echo.Context) error {
cookie, err := ctx.Cookie("username")
if err == nil && cookie.Value != "" {
// 实际项目这里可以通过 username 读库获取用户信息
user := &User{Username: cookie.Value}
// 放入 context 中
ctx.Set("user", user)
}
return next(ctx)
}
}接收一个 echo.HandlerFunc 类型,同时返回一个 echo.HandlerFunc 类型,这就是 MiddlewareFunc 的定义,因此 AutoLogin 可以直接当中间件使用。注意:在使用是这里和上面 Recover 的区别,Recover 是返回一个中间件,而 AutoLogin 本身是一个中间件,因此使用时分别是:Use(Recover()) 和 Use(AutoLogin)。
在具体实现中间件时,可以在调用 next() 函数前后增加该中间件需要的功能。
Cookie 和 Session
关于 Cookie、Session 和 Token 的介绍,可以通过 《一文带您彻底理解Cookie、Session、Token》 :(
https://cloud.tencent.com/developer/article/1542456)了解下。
在 Go 中,Session 相关功能最常用的包是
github.com/gorilla/sessions。Echo 提供了 Session 中间件,使用的就是该包。这里我们主要讲解一下登录需要用到的功能。
登录成功种 Cookie
// 用标准库种 cookie
cookie := &http.Cookie{
Name: "username",
Value: username,
HttpOnly: true,
}
if rememberMe == "1" {
cookie.MaxAge = 7*24*3600 // 7 天
}
ctx.SetCookie(cookie)我们这里直接使用了标准库的方式实现,而不是使用 ``
github.com/gorilla/sessions` 包。默认情况下,浏览器关闭,cookie 删除,当“记住我”,保存 7 天。这里留一个问题:cookie.Expires 和 cookie.MaxAge 的区别?
重定向保留用户名
在登录失败后,为了避免用户再次输入用户名,这里借用
github.com/gorilla/sessions 包的 Flash Message 功能。
github.com/gorilla/sessions 实现了 Cookie 和文件系统 Session,默认情况下,使用 Cookie。
sess := getCookieSession(ctx)
sess.AddFlash(username, "username")
err := sess.Save(ctx.Request(), ctx.Response())在读 Flash Message 的地方,一定要注意,需要再次执行 session.Save:
sess := getCookieSession(ctx)
if flashes := sess.Flashes("username"); len(flashes) > 0 {
data["username"] = flashes[0]
}
sess.Save(ctx.Request(), ctx.Response())总结
一个简单的登录,涉及到的知识点还是不少的,但依然有不少 Echo 框架的功能没包括。后面我们会介绍更多 Echo 的特性和功能,这个简单的例子,希望能够让你对 Echo 更有感觉。
完整示例代码:
https://github.com/polaris1119/echo-login-example
相关推荐
- c5game开箱网(c5game开箱网是正规的吗)
-
苹果c5game开箱操作很简单,首先进入c5game网站,选择打开自己的背包,然后找到自己想要开箱的物品,点击开箱按钮即可。在开箱过程中,会弹出一个开箱界面,按照界面提示进行操作,等待开箱过程结束即可...
- ps5官网(playstation 官网)
-
在官网买ps5需要玩家收到预购邀请才可以。索尼决定遴选出一批忠实玩家,率先向其提供PS5实机预定服务,数量有限,先到先得。玩家只需在PlayStation.com网站完成注册手续。若有幸等到预购邀请电...
- 电脑上dat文件用什么打开(电脑上dat文件怎么打开)
-
、打开电脑,找到“我的电脑”然后再打开硬盘C就可以看到相应的dat文件。2、硬盘C里面可以找到很多的dat文件,只是他们的文件拓展名不一样。3、然后在我的电脑当中输入“dat”就会弹出许多与dat相关...
- win10 2004和1909哪个好用(win10版本1909好用还是2004好用)
-
可以下载升级包进行升级。
- 主题商店oppo免费下载(oppo主题商店7.0.0下载)
-
如果在oppo手机上面下载主题上练的话,我建议还是不要下载,因为手机上自带有主题商店,然后可以在自带的主题商店里面就能下载使用自己的主题,再一个就是我们下载的主题商店,也会占手机内存,也可以导致手机内...
- win10系统 pe(win10系统 PID 1716)
-
E10都是表示系统缺水,给壁挂炉充上水压补足1.2bar即可解决。用户在使用前,首先应检查锅炉的水压表指针是否在规定范围内,说明书中规定的标准水压为1-1.2bar。但在实际使用过程中,由于暖气系统和...
- 电信官网登录入口(中国电信官网登录入口)
-
中国电信天翼网关一般情况下,登陆地址是http://192.168.0.1,用提供的用户名和密码就可以登陆。电信智能网关登录的方法就是要看电信光纤猫上背面的标签上的登录管理页面的网址以及登录的用户名和...
- 比迅雷好用的下载工具(比迅雷好用的下载app)
-
迅雷是一款中国大陆的著名下载工具,但由于其限速和广告等问题,许多用户可能会寻求更良心、更干净的替代品。以下是一些建议的下载工具:1.IDM(InternetDownloadManager):这是...
- 惠普笔记本换屏幕一般多少钱
-
看你在哪换,官方500以上,淘宝买个屏幕自己换300-600质量不同换新的吧没必要了原配屏看型号有的还不好配电子产品放了2年多一潮气性能下降运行速度明显不行二现在新的I57代...
- 笔记本电脑硬盘多少钱一个(4t机械硬盘多少钱)
-
这要看多大的容量的,是不是好拆。如果换120gsata接口的固态,选便宜的影驰这样的品牌的。换好装好系统。360左右的价格吧。我自己换的,我把原先的硬盘位换成固态硬盘,把光驱位通过硬盘托把笔记本的硬盘...
- 惠普电脑专卖店地址(惠普电脑型号查询官网)
-
京东的惠普的授权旗舰店和京东自营旗舰店比较靠谱不论是惠普的授权旗舰店,还是京东自营旗舰店,他们卖的产品都是靠谱的,不会存在故意坑你的情况,但是相比之下,京东自营的服务更有优势:京东自营,走的是京东物流...
-
- 电脑黑屏如何解决方法(电脑黑屏如何解决方法图片)
-
查看是否是由于显示器自身的原因而不能正常工作造成的黑屏,将显示屏的插头先拆下来,进行一次清理,然后再重新连接。如果还是不行,可以试一下其他的接口或者显示屏,看看是不是显示屏或者是接口的问题。如果显卡没有信号送出或有信号送不出去时,这时显示器...
-
2025-12-24 15:55 liuian
- 一周热门
- 最近发表
- 标签列表
-
- python判断字典是否为空 (50)
- crontab每周一执行 (48)
- aes和des区别 (43)
- bash脚本和shell脚本的区别 (35)
- canvas库 (33)
- dataframe筛选满足条件的行 (35)
- gitlab日志 (33)
- lua xpcall (36)
- blob转json (33)
- python判断是否在列表中 (34)
- python html转pdf (36)
- 安装指定版本npm (37)
- idea搜索jar包内容 (33)
- css鼠标悬停出现隐藏的文字 (34)
- linux nacos启动命令 (33)
- gitlab 日志 (36)
- adb pull (37)
- python判断元素在不在列表里 (34)
- python 字典删除元素 (34)
- vscode切换git分支 (35)
- python bytes转16进制 (35)
- grep前后几行 (34)
- hashmap转list (35)
- c++ 字符串查找 (35)
- mysql刷新权限 (34)
