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 controllerimport ("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 mainimport ("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 = trueweb.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 controllerimport ("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 controllerimport ("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 mainimport ("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 = trueweb.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 controllerimport ("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 mainimport ("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 = trueweb.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 文件上传下载和错误处理》
至此完