Beego 使用教程 3：Web 模块之路由

最新推荐文章于 2025-04-28 12:52:38 发布

悟世君子

最新推荐文章于 2025-04-28 12:52:38 发布

阅读量1k

点赞数 19

CC 4.0 BY-SA版权

分类专栏： golang 文章标签： beego go golang

本文链接：https://blog.youkuaiyun.com/wsjzzcbq/article/details/137678570

本文详细介绍了Go语言Beego框架的Web模块路由，包括控制器风格路由的自动和手动路由，函数式风格路由的基本和参数路由，查看已注册路由的方法，以及命名空间的使用，包括基本使用、多种形式多路由、命名空间嵌套和Filter应用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

beego 是一个用于Go编程语言的开源、高性能的 web 框架

beego 被用于在Go语言中企业应用程序的快速开发，包括RESTful API、web应用程序和后端服务。它的灵感来源于Tornado， Sinatra 和 Flask

beego 官网：http://beego.gocn.vip/

上面的 beego 官网如果访问不到，看这篇文章《beego 官网文档本地环境搭建》

注意：本文的 beego 文档使用的就是本地环境搭建的文档，因为官网文档已经不可用了

beego 官方 github 仓库：https://github.com/beego/beego

上一讲，讲了 beego 的配置模块、Admin管理后台和定时任务，需要的朋友可以查看《Beego 使用教程 2：配置模块、Admin管理后台和定时任务》

这一讲，主要讲解 beego 的 Web 模块中的路由部分

笔者使用上一讲的代码

1、控制器风格路由

1.1、自动路由

在项目根目录下新建 controller 目录，在 controller 目录下新建 user.go

在 controller 目录下 user.go 中添加下面代码

自动路由，即不需要指定请求路径，beego 会默认把请求地址 /user/name 映射到对应的方法

/user 是 UserController /name 是Name 方法

package controller

import "github.com/beego/beego/v2/server/web"

type UserController struct {
	web.Controller
}

func (u *UserController) Name() {
	u.Ctx.WriteString("春已半，触目此情无限。十二阑干闲倚遍，愁来天不管")
}

main.go 中代码如下

package main

import (
	"beego-demo/controller"
	"fmt"
	"github.com/beego/beego/v2/core/config"
	"github.com/beego/beego/v2/server/web"
)

func main() {
	//通过config获取自定义配置
	workername, _ := config.String("workername")
	fmt.Println(workername)

	//执行定时任务
	//go job.DemoTask()

	//注册自动路由
	web.AutoRouter(&controller.UserController{})

	//开启 Admin 管理后台
	web.BConfig.Listen.EnableAdmin = true
	web.BConfig.Listen.AdminAddr = "localhost"
	web.BConfig.Listen.AdminPort = 8088

	web.Run()
}

启动项目后，请求 http://localhost:9090/user/name

运行效果

添加请求前缀

在 main.go 中修改 web.AutoRouter(&controller.UserController{}) 为 web.AutoPrefix("api", &controller.UserController{})

web.AutoRouter(&controller.UserController{})

main.go

package main

import (
	"beego-demo/controller"
	"fmt"
	"github.com/beego/beego/v2/core/config"
	"github.com/beego/beego/v2/server/web"
)

func main() {
	//通过config获取自定义配置
	workername, _ := config.String("workername")
	fmt.Println(workername)

	//执行定时任务
	//go job.DemoTask()

	//注册自动路由
	web.AutoPrefix("api", &controller.UserController{})

	//开启 Admin 管理后台
	web.BConfig.Listen.EnableAdmin = true
	web.BConfig.Listen.AdminAddr = "localhost"
	web.BConfig.Listen.AdminPort = 8088

	web.Run()
}

重新启动项目，浏览器访问：http://localhost:9090/api/user/name

1.2、手动路由

上面的路由注册方式是自动注册路由，下面介绍手动注册路由的方式

1.2.1、基本路由

在 main.go 中注释掉自动注册路由的代码，修改为下面手动注册的代码

web.CtrlGet("/name", (*controller.UserController).Name)

main.go

package main

import (
	"beego-demo/controller"
	"fmt"
	"github.com/beego/beego/v2/core/config"
	"github.com/beego/beego/v2/server/web"
)

func main() {
	//通过config获取自定义配置
	workername, _ := config.String("workername")
	fmt.Println(workername)

	//执行定时任务
	//go job.DemoTask()

	//注册自动路由
	//web.AutoPrefix("api", &controller.UserController{})
	web.C