go语言web框架：Echo超详细一文搞透

最新推荐文章于 2025-03-05 00:35:12 发布
最新推荐文章于 2025-03-05 00:35:12 发布
阅读量1k 收藏 5
点赞数 6
分类专栏： golang大家庭 文章标签： golang 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/A_art_xiang/article/details/140516778
版权

文章目录

一、概述

1、官网

官方网站:https://echo.labstack.com
GitHub资源库:https://github.com/labstack/echo
文档:https://echo.labstack.com/docs
社区论坛:https://github.com/labstack/echo/discussions

2、安装echo

# 指定国内包源地址
go env -w GOPROXY=https://goproxy.cn
# 下载echo包
go get github.com/labstack/echo/v4

二、基本使用

1、基本语法

创建server.go

package main

import (
	"net/http"
	"github.com/labstack/echo/v4"
	"os"
	"io"
)

func main() {
	e := echo.New()
	// 路由
	e.GET("/", func(c echo.Context) error {
		return c.String(http.StatusOK, "Hello, World!")
	})
	e.GET("/show", show)
	e.GET("/users/:id", getUser)
	e.POST("/users", saveUser)
	e.PUT("/users/:id", updateUser)
	e.DELETE("/users/:id", deleteUser)
	// 端口
	e.Logger.Fatal(e.Start(":8080"))
}

//e.GET("/show", show)
func show(c echo.Context) error {
	// http://localhost:8080/show?team=x-men&member=wolverine 获取team和member参数
	team := c.QueryParam("team")
	member := c.QueryParam("member")
	return c.String(http.StatusOK, "team:" + team + ", member:" + member)
}

// e.GET("/users/:id", getUser)
func getUser(c echo.Context) error {
	//  http://localhost:8080/users/zhangsan 获取path参数
	id := c.Param("id")
  return c.String(http.StatusOK, id)
}

// e.POST("/users", saveUser)
func saveUser(c echo.Context) error {
	// 获取Form表单参数
	name := c.FormValue("name")
	email := c.FormValue("email")
	// 获取文件
	avatar, err := c.FormFile("avatar")
  	if err != nil {
 		return err
 	}
 
 	// Source
 	src, err := avatar.Open()
 	if err != nil {
 		return err
 	}
 	defer src.Close()
 
 	// Destination
 	dst, err := os.Create(avatar.Filename)
 	if err != nil {
 		return err
 	}
 	defer dst.Close()
 
 	// Copy 文件下载到项目根路径
 	if _, err = io.Copy(dst, src); err != nil {
  		return err
  	}
	return c.String(http.StatusOK, "name:" + name + ", email:" + email)
}


type User struct {
	Name  string `json:"name" xml:"name" form:"name" query:"name"`
	Email string `json:"email" xml:"email" form:"email" query:"email"`
}
// e.PUT("/users/:id", updateUser)
func updateUser(c echo.Context) error {
	u := new(User)
	// 根据内容类型请求头将json、xml、表单或查询参数，自动绑定到Go结构体中。
	if err := c.Bind(u); err != nil {
		return err
	}
	return c.JSON(http.StatusCreated, u)
	// or
	// return c.XML(http.StatusCreated, u)
}

// e.DELETE("/users/:id", deleteUser)
func deleteUser(c echo.Context) error {
	//  http://localhost:8080/users/zhangsan 获取path参数
	id := c.Param("id")
  return c.String(http.StatusOK, id)
}

执行：go run server.go，端口8080

2、使用Bind对参数进行绑定

package main

import (
	"github.com/labstack/echo/v4"
	"net/http"
)

/*
可以绑定的类型：
query-查询参数
param-路径参数(也称为路由)
header-标题参数
json-请求body
xml-请求body
form-表单数据。值取自查询和请求正文。使用Go标准库格式解析。
*/
type User struct {
	Name  string `json:"name" form:"name" query:"name"`
	Email string `json:"email" form:"email" query:"email"`
}

type UserDTO struct {
	Name    string
	Email   string
	IsAdmin bool
}

func main() {
	e := echo.New()
	// 路由
	e.GET("/", func(c echo.Context) error {
		return c.String(http.StatusOK, "Hello, World!")
	})
	e.GET("/show", func(c echo.Context) error {
		// http://localhost:8080/show?id=123
		// 查询参数的id会绑定到user的ID
		var user User
		err := c.Bind(&user)
		if err != nil {
			return c.String(http.StatusBadRequest, "bad request")
		}
		return c.JSON(http.StatusCreated, user)
	})

	e.POST("/users", func(c echo.Context) (err error) {
		// 绑定user
		u := new(User)
		if err := c.Bind(u); err != nil {
			return c.String(http.StatusBadRequest, "bad request")
		}

		// 为了安全起见，加载到单独的结构体中：UserDTO
		user := UserDTO{
			Name:    u.Name,
			Email:   u.Email,
			IsAdmin: false, // 避免公开不绑定的字段
		}

		// 使用user执行其他逻辑

		return c.JSON(http.StatusOK, user)
	})
	e.Logger.Fatal(e.Start(":8080"))
}

3、响应处理

package main

import (
	"github.com/labstack/echo/v4"
	"net/http"
	"os"
)

// User
type User struct {
	Name  string `json:"name" xml:"name"`
	Email string `json:"email" xml:"email"`
}

func main() {
	e := echo.New()
	// 响应字符串
	e.GET("/string", func(c echo.Context) error {
		return c.String(http.StatusOK, "Hello, World!")
	})
	// 响应html
	e.GET("/html", func(c echo.Context) error {
		return c.HTML(http.StatusOK, "<strong>Hello, World!</strong>")
	})
	// 响应json
	e.GET("/json1", func(c echo.Context) error {
		u := &User{
			Name:  "张三",
			Email: "1111@qq.com",
		}
		return c.JSON(http.StatusOK, u)
	})
	// 响应 格式化之后的json，传一个缩进符
	e.GET("/json2", func(c echo.Context) error {
		u := &User{
			Name:  "张三",
			Email: "1111@qq.com",
		}
		return c.JSON(http.StatusOK, c.JSONPretty(http.StatusOK, u, "  "))
	})
	// 响应xml
	e.GET("/xml1", func(c echo.Context) error {
		u := &User{
			Name:  "张三",
			Email: "1111@qq.com",
		}
		return c.XML(http.StatusOK, u)
	})
	// 格式化 响应xml
	e.GET("/xml2", func(c echo.Context) error {
		u := &User{
			Name:  "张三",
			Email: "1111@qq.com",
		}
		return c.XMLPretty(http.StatusOK, u, "  ")
	})
	// 响应文件
	e.GET("/file1", func(c echo.Context) error {
		return c.File("C:\\Users\\Admin\\Pictures\\netty.png")
	})
	e.GET("/file2", func(c echo.Context) error {
		return c.File("D:\\goland-2024.1.4.exe")
	})
	// 响应文件，附带文件名
	e.GET("/file3", func(c echo.Context) error {
		return c.Attachment("D:\\goland-2024.1.4.exe", "goland.exe")
	})
	// 响应流
	e.GET("/stream", func(c echo.Context) error {
		f, err := os.Open("C:\\Users\\Admin\\Pictures\\netty.png")
		if err != nil {
			return err
		}
		return c.Stream(http.StatusOK, "image/png", f)
	})
	// 响应空
	e.GET("/none", func(c echo.Context) error {
		return c.NoContent(http.StatusOK)
	})
	// 重定向
	e.GET("/redirect", func(c echo.Context) error {
		return c.Redirect(http.StatusMovedPermanently, "/string")
	})

	e.Logger.Fatal(e.Start(":8080"))
}

指定响应内容

type Map map[string]interface{}

func Fail(c echo.Context, code int, message string) error {
	return c.JSON(200, Map{
		"code":    code,
		"message": message,
	})
}

func FailWithData(c echo.Context, code int, message string, data interface{}) error {
	return c.JSON(200, Map{
		"code":    code,
		"message": message,
		"data":    data,
	})
}

func Success(c echo.Context, data interface{}) error {
	return c.JSON(200, Map{
		"code":    1,
		"message": "success",
		"data":    data,
	})
}

4、路由分组

package main

import (
	"github.com/labstack/echo/v4"
	"github.com/labstack/echo/v4/middleware"
	"net/http"
)

func main() {
	e := echo.New()

	// 路由分组
	admin := e.Group("/admin")
	admin.GET("/test1", func(c echo.Context) error {
		return c.String(http.StatusOK, "admin test1")
	})
	admin.GET("/test2", func(c echo.Context) error {
		return c.String(http.StatusOK, "admin test2")
	})

	// 第二个路由组
	user := e.Group("/user")
	user.GET("/test1", func(c echo.Context) error {
		return c.String(http.StatusOK, "user test1")
	})

	e.Logger.Fatal(e.Start(":8080"))
}

5、静态文件服务

package main

import (
	"github.com/labstack/echo/v4"
)

func main() {
	e := echo.New()

	// 指定路径，该路径下的文件会提供文件服务（参数一：前缀，参数二：本地路径）
	// 访问localhost:8080/static/xxx.png 即可访问文件
	e.Static("/static", "D:\\")

	// 静态页面
	e.File("/", "public/index.html")
	
	// 指定文件
	e.File("/favicon.ico", "images/favicon.ico")

	e.Logger.Fatal(e.Start(":8080"))
}

6、Middleware：基本身份认证

package main

import (
	"github.com/labstack/echo/v4"
	"net/http"
)

type Map map[string]interface{}

func main() {
	e := echo.New()

	// 路由分组，并且该路由分组下都需要验证
	admin := e.Group("/admin") // 或者直接admin := e.Group("/admin", Auth)
	admin.Use(Auth)

	admin.GET("/test1", func(c echo.Context) error {
		return c.String(http.StatusOK, "admin test1")
	})
	admin.GET("/test2", func(c echo.Context) error {
		return c.String(http.StatusOK, "admin test2")
	})

	// 第二个路由组
	user := e.Group("/user")
	user.GET("/test1", func(c echo.Context) error {
		return c.String(http.StatusOK, "user test1")
	})

	e.Logger.Fatal(e.Start(":8080"))
}

func Auth(next echo.HandlerFunc) echo.HandlerFunc {
	return func(c echo.Context) error {

		// 校验token
		if !checkToken(c) {
			return c.JSON(200, Map{
				"code":    401,
				"message": "您的登录信息已失效，请重新登录后再试。",
			})
		}

		return next(c)
	}
}

func GetToken(c echo.Context) string {
	token := c.Request().Header.Get("H-Token")
	if len(token) > 0 {
		return token
	}
	return c.QueryParam("H-Token")
}

func checkToken(c echo.Context) bool {
	token := GetToken(c)
	// 从redis或者其他地方校验token的有效性

	if token == "user" {
		return true
	}
	return false
}

7、使用session

package main

import (
	"errors"
	"fmt"
	"github.com/gorilla/sessions"
	"github.com/labstack/echo-contrib/session"
	"github.com/labstack/echo/v4"
	"log"
	"net/http"
)

func main() {
	e := echo.New()
	e.Use(session.Middleware(sessions.NewCookieStore([]byte("secret"))))

	e.GET("/create-session", func(c echo.Context) error {
		sess, err := session.Get("session", c)
		if err != nil {
			return err
		}
		sess.Options = &sessions.Options{
			Path:     "/",
			MaxAge:   86400 * 7,
			HttpOnly: true,
		}
		sess.Values["foo"] = "bar"
		if err := sess.Save(c.Request(), c.Response()); err != nil {
			return err
		}
		return c.NoContent(http.StatusOK)
	})

	e.GET("/read-session", func(c echo.Context) error {
		sess, err := session.Get("session", c)
		if err != nil {
			return err
		}
		return c.String(http.StatusOK, fmt.Sprintf("foo=%v\n", sess.Values["foo"]))
	})

	if err := e.Start(":8080"); err != nil && !errors.Is(err, http.ErrServerClosed) {
		log.Fatal(err)
	}
}

Golang(五)最佳Web框架对比
Suy1__的博客
10-14 1万+
Golang是一门快速增长的语言，专为构建简单、快速且可靠的软件而设计。它提供的net/http库对于HTTP协议实现非常好，基于此再构造框架会更容易，因此生态中出现了很多框架。本文将从流行度、社区支持及内建功能等角度对六款知名Go语言Web框架做对比 六款Web框架 Beego 面向Go编程语言的开源高性能web框架 https://github.com/astaxie/beego ...
Go Web 编程之 Hello World
darjun的博客
01-08 1228
概述 计划写一个讲 Go Web 编程的系列文章。从基于 net/http 包编写 Go Web 程序开始，讲述处理器，请求，响应等基础知识。然后到框架的使用。中间会穿插一些源码的分析。最后做一个实战项目。 目前 Go 社区已经有非常多关于 Web 开发的库或框架。大而全的有beego，revel。超高性能的有echo，fasthttp，gin（目前 GitHub 星标最多）。还有不少专注于具体某...
Gin 框架使用指南
m0_57836225的博客
11-08 1173
定义不同请求方法的路由GET 请求：收起go复制// 处理 GET 请求逻辑})POST 请求：收起go复制// 处理 POST 请求逻辑})PUT 请求：收起go复制// 处理 PUT 请求逻辑})DELETE 请求：收起go复制// 处理 DELETE 请求逻辑})路由参数定义带有参数的路由：收起go复制// 使用参数 id 进行处理})查询参数获取查询参数：收起go复制// 使用查询参数 keyword 进行处理})
Go Web框架全面对比：哪一款最适合你的项目？
最新发布
m0_74825135的博客
03-05 937
如果你需要构建高性能的RESTful API，并且希望框架简单易用，Gin和Echo是最佳选择。如果你的应用需要实时通信（如WebSocket），Fiber是一个极好的选择，它在性能和开发体验上都表现出色。对于企业级应用或需要MVC架构的项目Beego提供了一个完整的解决方案。如果你正在构建微服务架构，且需要高度灵活的路由和中间件支持，Chi是非常合适的选择。每种框架都有其适用的场景，了解框架的特点和使用场景，可以帮助你更高效地完成Web开发任务。
Go_Golang Echo 框架中文文档-BookStack.CN
05-05
Go_Golang Echo 框架中文文档-BookStack , echo 中文文档，欢迎下载
Go echo框架
weixin_40123451的博客
11-04 511
1.目录结构 2. ss
Go 语言 Web 开发利器：Echo 框架详解
m0_62153576的博客
10-13 1904
在 Go 语言的丰富生态系统中，有许多出色的 Web 框架，而 Echo 是其中备受瞩目的一员。它以高性能、简洁易用而著称。本博客将详细介绍如何使用 Echo 框架进行 Web 开发，包括安装、路由、中间件、模板引擎等方面。
golang语言系列：Web框架+路由 之 Echo
a1369760658的博客
04-02 1969
本文是golang语言系列文章，本篇主要对 Echo 框架 的基本使用方法 进行学习
Go web框架 Echo
weixin_48943299的博客
11-11 1456
优点路由性能高更轻量级的web开发框架缺点调试不方便，报错信息不友好路由性能虽高，但是路由实现的算法底层不支持路由排序，会引起路由冲突。
跨平台部署秘技：一文搞懂在不同系统上制作安装包
[跨平台部署秘技：一文搞懂在不同系统上制作安装包](https://jumpcloud.com//wp-content/uploads/2023/04/encrypt-1604.jpeg) # 1. 跨平台部署的基础概念 在当今技术驱动的世界，软件开发已经进入了一个新的时代。...
一文带你了解python
快乐江小鱼的博客
06-02 458
print。
一文详解Keepalived
jeremy3762的专栏
05-11 1211
一文详解Keepalived 1. 介绍 ​ **单点故障：**单点故障是指一旦某一点出现故障就会导致整个系统架构的不可用。 ​ Keepalived是Linux下一个轻量级别的高可用解决方案。高可用(High Avalilability,HA)，其实两种不同的含义：广义来讲，是指整个系统的高可用行，狭义的来讲就是之主机的冗余和接管， ​ 它与HeartBeat、RoseHA 实现相同类似的功能，都可以实现服务或者网络的高可用，但是又有差别，HeartBeat是一个专业的、功能完善的高可用软件，它提供
Echo框架：高性能的Golang Web框架
爱编程的鱼的博客
03-16 1119
Echo是一个轻量级的Golang Web框架，旨在提供简单、高性能和易于使用的Web应用开发解决方案。它遵循了"零配置"的原则，具有优雅的API设计和快速的路由匹配算法，使得开发者可以快速构建出高效、可靠的Web应用程序。Echo是一个高性能、简洁且易用的Golang Web框架，通过其快速的性能、简洁的API设计和丰富的功能，成为了Golang开发者的首选工具。无论是构建小型REST API还是大型Web应用，Echo框架都能够提供出色的开发体验和高效的性能。
Go语言Echo框架环境搭建
weixin_50196917的博客
01-18 285
一款 Go 语言基于Echo、Layui、MySQL等框架精心打造的一款模块化、插件化、高性能的前后端分离架构敏捷开发框架，可用于快速搭建前后端分离后台管理系统，本着简化开发、提升开发效率的初衷，框架自研了一套个性化的组件，实现了可插拔的组件式开发方式：单图上传、多图上传、下拉选择、开关按钮、单选按钮、多选按钮、图片裁剪等等一系列个性化、轻量级的组件，是一款真正意义上实现组件化开发的敏捷开发框架，框架已集成了完整的RBAC权限架构和常规基础模块，同时支持多主题切换，可以根据自己喜欢的风格选择想一个的主题，实
Go: 深入了解 Echo 框架并对比 Gin
十年运维开发经验的王义杰在此分享自己的知识和经验
07-27 1195
Echo 是一个高性能、极简主义的 Go 语言 Web 框架，致力于提供快速、灵活和易于扩展的开发体验。Echo 的设计目标是确保高效的请求处理，提供丰富的中间件支持，以及简洁的 API 设计。Gin 是另一个广泛使用的 Go 语言 Web 框架，以其高性能和强大的路由功能著称。Gin 基于 httprouter 构建，提供了轻量级的 API 设计和灵活的中间件支持。Echo 和 Gin 都是优秀的 Go 语言 Web 框架，各有其独特的优势。
GOLANG开发 - Echo 框架 入门
masterphp的博客
02-27 2528
fmt.Println("测试数据")//定义GET方法")})//定义POST方法// 启动服务器//定义方法在页面或者引入资源包的时候需要定义一个资源文件夹，里面存放JS，CSS，图片等一系列的静态资源，那么我们引用的时候需要使用相对路径或者绝对路径，那么我们就需要定义一个路径，来实现引用静态资源：比如 static 目录下的任何文件都会被访问。例如，一个访问 /static/js/main.js 的请求会匹配到 static/js/main.js 这个文件。
go echo mysql_Golang ECHO框架入门【1】
weixin_30794381的博客
02-03 718
一、介绍echo web框架是go语言开发的一种高性能，可扩展，轻量级的web框架。echo框架真的非常的简单，几行代码就可以启动一个高性能的http服务端。如果你只是测试返回hello world这种简单逻辑，普通的低配服务器，每秒扛个万八千QPS没什么问题，这个主要跟服务器配置有关，当然实际应用中的业务逻辑不会是hello world那么简单，业务不同，系统设计不同吞吐量肯定不一样。echo框...
Go 高效Web开发框架 Echo
专注于全栈开发领域
07-12 1189
Echo是一个快速、简洁的Go Web框架，专为RESTful API和微服务设计。它提供了路由、中间件、数据绑定、验证等核心功能，同时支持插件扩展，使得开发过程更加灵活和高效。中间件是Echo框架的一个强大特性，允许开发者在处理请求之前或之后执行一些操作。自定义中间件可以用于日志记录、鉴权、跨域处理等。// 日志记录请求信息Echo框架以其高性能和易用性，为Go语言的Web开发提供了强大的支持。通过本文介绍的一些使用技巧，开发者可以更深入地理解Echo框架的潜力，构建出更加健壮、高效的Web应用。
echo-高性能，可扩展，极简的Go Web框架
ccf19881030的专栏
08-21 602
高性能，可扩展，极简的Go Web框架 以前学习Nodejs的时候，使用过Express，这是一个基于 Node.js 平台，快速、开放、极简的 Web 开发框架。 echo是一个高性能，可扩展，极简的Go Web框架。其官网如下图所示： echo官方指南 具体使用见官方指南：https://echo.labstack.com/guide Quick Start Installation $ go get -u github.com/labstack/echo/... Hello, World!
Go语言Web应用实战：Echo与Gorm框架示例
标题 "go-webapp-sample：golang，echo，gorm" 表明了该示例是一个使用Go语言（golang）、Echo框架以及GORM库的Web应用程序示例。 - **Go语言（golang）**：Go语言是由Google开发的一种静态强类型、编译型语言，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

秃了也弱了。

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值