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 页面视图,需要的朋友可以查看《Beego 使用教程 5:页面视图》
这一讲,讲解 web 输入处理,这一讲的 web输入需要借助上一讲的页面
代码使用上一讲的代码
目录
路由传参,在前面第3讲中已经以参数路由的形式讲解过了,这里再简单讲解一下控制器风格的路由参数,更多内容不在赘述,需要的朋友可以看《Beego 使用教程 3:Web 模块之路由》中参数路由部分内容
在 controller 目录下新建 param.go,内容是下面代码
- package controller
-
- import (
- "github.com/beego/beego/v2/server/web"
- )
-
- type ParamController struct {
- web.Controller
- }
-
- func (p *ParamController) PathParam() {
- name := p.Ctx.Input.Param(":name")
- p.Ctx.WriteString(name)
- }
修改 main.go 为下面代码,添加PathParam 的路由
- package main
-
- import (
- "beego-demo/controller"
- "beego-demo/filter"
- "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.CtrlGet("/name", (*controller.UserController).Name)
- web.CtrlGet("/get/:id", (*controller.UserController).GetUserById)
- web.CtrlGet("/get/:id/:num", (*controller.UserController).GetUserByIdAndNum)
- //返回页面
- web.CtrlGet("/page/index", (*controller.PageController).Index)
- web.CtrlGet("/page/f", (*controller.PageController).F)
- web.CtrlGet("/page/main", (*controller.PageController).Main)
- //web输入参数
- web.CtrlGet("/pathparam/:name", (*controller.ParamController).PathParam)
-
- //注册函数式路由
- controller.RegisterFunctionalRoutes()
- //web命名空间
- controller.RegisterNamespaceRoutes()
-
- //过滤器
- filter.RegisterFilters()
-
- //开启 Admin 管理后台
- web.BConfig.Listen.EnableAdmin = true
- web.BConfig.Listen.AdminAddr = "localhost"
- web.BConfig.Listen.AdminPort = 8088
-
- //web.BConfig.WebConfig.ViewsPath = "pages"
-
- //查看已注册路由
- tree := web.PrintTree()
- methods := tree["Data"].(web.M)
- for k, v := range methods {
- fmt.Printf("%s => %v\n", k, v)
- }
-
- //自定义模板函数
- web.AddFuncMap("bookName", bookName)
-
- web.Run()
- }
-
- // 自定义模板函数添加书名号
- func bookName(in string) (out string) {
- out = "《" + in + "》"
- return
- }
运行效果
浏览器请求:http://localhost:9090/pathparam/xiaohong

修改 controller 目录下 param.go 为下面代码
- package controller
-
- import (
- "github.com/beego/beego/v2/server/web"
- "strconv"
- )
-
- type ParamController struct {
- web.Controller
- }
-
- func (p *ParamController) PathParam() {
- name := p.Ctx.Input.Param(":name")
- p.Ctx.WriteString(name)
- }
-
- func (p *ParamController) GetParam() {
- name := p.GetString("name")
- age, _ := p.GetInt("age")
- p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
- }
修改 login.html 为下面代码
- <div>
- <h2>登录h2>
- <form action="/getparam" method="get">
- <input type="text" name="name" />
- <input type="text" name="age" />
- <input type="submit" value="提交">
- form>
- div>
浏览器请求:http://localhost:9090/page/main
运行效果

这种方式除了可以使用表单提交外,还可以直接在浏览器上拼接请求地址访问
直接请求:http://localhost:9090/getparam?name=bobbb&age=18
运行效果

通过 GetString 或 GetInt 等方法获取参数,更多API 可以看官网文档

在发送请求时没有携带参数,给一个默认的值,看下面方法
- func (p *ParamController) GetParam() {
- name := p.GetString("name", "默认名称 Jack")
- age, _ := p.GetInt("age", 18)
- p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
- }
运行效果

修改 controller 目录下 param.go 为下面代码
- package controller
-
- import (
- "github.com/beego/beego/v2/server/web"
- "strconv"
- )
-
- type ParamController struct {
- web.Controller
- }
-
- func (p *ParamController) PathParam() {
- name := p.Ctx.Input.Param(":name")
- p.Ctx.WriteString(name)
- }
-
- func (p *ParamController) GetParam() {
- name := p.GetString("name")
- age, _ := p.GetInt("age")
- p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
- }
-
- // PostParam post 请求
- func (p *ParamController) PostParam() {
- name := p.GetString("name")
- age, _ := p.GetInt("age")
- p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
- }
修改 main.go 为下面代码,添加PostParam 的路由
- package main
-
- import (
- "beego-demo/controller"
- "beego-demo/filter"
- "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.CtrlGet("/name", (*controller.UserController).Name)
- web.CtrlGet("/get/:id", (*controller.UserController).GetUserById)
- web.CtrlGet("/get/:id/:num", (*controller.UserController).GetUserByIdAndNum)
- //返回页面
- web.CtrlGet("/page/index", (*controller.PageController).Index)
- web.CtrlGet("/page/f", (*controller.PageController).F)
- web.CtrlGet("/page/main", (*controller.PageController).Main)
- //web输入参数
- web.CtrlGet("/pathparam/:name", (*controller.ParamController).PathParam)
- web.CtrlGet("/getparam", (*controller.ParamController).GetParam)
- web.CtrlPost("/postparam", (*controller.ParamController).PostParam)
-
- //注册函数式路由
- controller.RegisterFunctionalRoutes()
- //web命名空间
- controller.RegisterNamespaceRoutes()
-
- //过滤器
- filter.RegisterFilters()
-
- //开启 Admin 管理后台
- web.BConfig.Listen.EnableAdmin = true
- web.BConfig.Listen.AdminAddr = "localhost"
- web.BConfig.Listen.AdminPort = 8088
-
- //web.BConfig.WebConfig.ViewsPath = "pages"
-
- //查看已注册路由
- tree := web.PrintTree()
- methods := tree["Data"].(web.M)
- for k, v := range methods {
- fmt.Printf("%s => %v\n", k, v)
- }
-
- //自定义模板函数
- web.AddFuncMap("bookName", bookName)
-
- web.Run()
- }
-
- // 自定义模板函数添加书名号
- func bookName(in string) (out string) {
- out = "《" + in + "》"
- return
- }
修改 login.html 为下面代码
- <div>
- <h2>登录h2>
- <form action="/getparam" method="get">
- <input type="text" name="name" />
- <input type="text" name="age" />
- <input type="submit" value="提交">
- form>
-
- <h2>post 请求h2>
- <form action="/postparam" method="post">
- <input type="text" name="name" />
- <input type="text" name="age" />
- <input type="submit" value="提交">
- form>
- div>
运行效果

大多数时候,我们还需要把输入转换为结构体,Beego 提供了一系列的方法来完成输入到结构体的绑定
使用 bind 绑定结构体需要先开启绑定,设置 web.BConfig.CopyRequestBody = true
web.BConfig.CopyRequestBody = true
修改 controller 目录下 param.go 为下面代码
- package controller
-
- import (
- "fmt"
- "github.com/beego/beego/v2/server/web"
- "strconv"
- )
-
- type ParamController struct {
- web.Controller
- }
-
- func (p *ParamController) PathParam() {
- name := p.Ctx.Input.Param(":name")
- p.Ctx.WriteString(name)
- }
-
- func (p *ParamController) GetParam() {
- name := p.GetString("name")
- age, _ := p.GetInt("age")
- p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
- }
-
- // PostParam post 请求
- func (p *ParamController) PostParam() {
- name := p.GetString("name")
- age, _ := p.GetInt("age")
- p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
- }
-
- type LoginParam struct {
- Username string `json:"username"`
- Password string `json:"password"`
- }
-
- // BindParam bind 类方法
- func (p *ParamController) BindParam() {
- loginParam := LoginParam{}
- p.BindJSON(&loginParam)
- fmt.Println(loginParam)
- p.Ctx.WriteString(fmt.Sprintf("%v", loginParam))
- }
修改 main.go 为下面代码,添加 BindParam的路由和开启 bind 绑定设置
- package main
-
- import (
- "beego-demo/controller"
- "beego-demo/filter"
- "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.CtrlGet("/name", (*controller.UserController).Name)
- web.CtrlGet("/get/:id", (*controller.UserController).GetUserById)
- web.CtrlGet("/get/:id/:num", (*controller.UserController).GetUserByIdAndNum)
- //返回页面
- web.CtrlGet("/page/index", (*controller.PageController).Index)
- web.CtrlGet("/page/f", (*controller.PageController).F)
- web.CtrlGet("/page/main", (*controller.PageController).Main)
- //web输入参数
- web.CtrlGet("/pathparam/:name", (*controller.ParamController).PathParam)
- web.CtrlGet("/getparam", (*controller.ParamController).GetParam)
- web.CtrlPost("/postparam", (*controller.ParamController).PostParam)
- web.CtrlPost("/bindparam", (*controller.ParamController).BindParam)
-
- //注册函数式路由
- controller.RegisterFunctionalRoutes()
- //web命名空间
- controller.RegisterNamespaceRoutes()
-
- //过滤器
- filter.RegisterFilters()
-
- //开启 Admin 管理后台
- web.BConfig.Listen.EnableAdmin = true
- web.BConfig.Listen.AdminAddr = "localhost"
- web.BConfig.Listen.AdminPort = 8088
-
- //web.BConfig.WebConfig.ViewsPath = "pages"
-
- //开启post 请求 bind绑定请求体
- web.BConfig.CopyRequestBody = true
-
- //查看已注册路由
- tree := web.PrintTree()
- methods := tree["Data"].(web.M)
- for k, v := range methods {
- fmt.Printf("%s => %v\n", k, v)
- }
-
- //自定义模板函数
- web.AddFuncMap("bookName", bookName)
-
- web.Run()
- }
-
- // 自定义模板函数添加书名号
- func bookName(in string) (out string) {
- out = "《" + in + "》"
- return
- }
修改 login.html 为下面代码
- <div>
- <h2>登录h2>
- <form action="/getparam" method="get">
- <input type="text" name="name" />
- <input type="text" name="age" />
- <input type="submit" value="提交">
- form>
-
- <h2>post 请求h2>
- <form action="/postparam" method="post">
- <input type="text" name="name" />
- <input type="text" name="age" />
- <input type="submit" value="提交">
- form>
- <br>
- <button onclick="send()">发送button>
- div>
- <script src="https://unpkg.com/jquery@3.7.1/dist/jquery.js">script>
- <script>
- function send() {
- $.ajax({
- url: '/bindparam',
- type: 'post',
- contentType: 'application/json',
- data: JSON.stringify({'username':'admin','password':'123456'}),
- success:function (res){
- alert(res)
- }
- })
- }
- script>
运行效果
浏览器请求:http://localhost:9090/page/main

下一讲:《Beego 使用教程 7:Web 文件上传下载和错误处理》
至此完