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输入需要借助上一讲的页面
代码使用上一讲的代码
目录
1、Get 类方法
1.1、路由传参
1.2、表单请求
1.3、传入默认值
1.4、post 请求
2、Bind 类方法
1、Get 类方法
1.1、路由传参
路由传参,在前面第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
1.2、表单请求
修改 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 可以看官网文档
1.3、传入默认值
在发送请求时没有携带参数,给一个默认的值,看下面方法
func (p *ParamController) GetParam() {
name := p.GetString("name", "默认名称 Jack")
age, _ := p.GetInt("age", 18)
p.Ctx.WriteString("名称: " + name + "年龄: " + strconv.Itoa(age))
}
运行效果
1.4、post 请求
修改 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>
运行效果
2、Bind 类方法
大多数时候,我们还需要把输入转换为结构体,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 文件上传下载和错误处理》
至此完