【小鸡软件】使用框架:beego + grom +xianyan
本章目标:添加页面路由,能正常访问轻博客页面
github地址: 打开后,点击右上角star按钮
beego添加路由功能
beego 添加路由 通过修改 routers--> router.go 文件,来实现,beego实现路由的方式有多种点我查看beego路由文档,咱们采用注解路由
//注解路由
// path路由路径,method路由方法:get、put、post...
// @router path [method]
func (this *Controller) Doit() {
...
}
//在 router.go 中通过如下方式注册路由:
beego.Include(&CMSController{})
beego的controller控制器拥有很多方法,其中包括 Init、Prepare 等方法。其中Prepare方法是每次请求都会调用的方法,所以我们需要创建个“基类”来重写结构体的Prepare方法。
控制器和路由的关系就好比:用户到银行,路由告诉到哪个窗口,控制器则是具体如何为用户提供具体服务。
golang的继承是用组合来模拟继承的,而golang的多态是通过接口(interface)来实现。
golang的接口实现,没有强制性约定。只要实现了接口定义的所有方法,就是实现了接口。
- 咱们首先创建一个controllers-->base.go,新增结构体BaseController继承beego.Controller,为BaseController添加的Prepare() 方法。所有继承了BaseController的子controller 每次请求都会调用BaseController的Prepare()方法,因此咱们约定所有的子controller都会继承BaseController,可以将每次请求的通用逻辑写在BaseController的Prepare方法里面。
- 如果子controller里面的所有方法,除了要调用BaseController里面的Prepare方法的通用逻辑外,还有一些当前子controller的通用逻辑,咋办?难道当前子controller的每个方法都写重复一样的代码吗?有办法,咱们自己在BaseController定义个接口,在BaseController的Prepare方法里面判断子controller是否实现了接口。如果实现了,咱们就调用接口方法。
下面是 文件base.go的代码
import (
"github.com/astaxie/beego"
"log"
)
// 约定:如果子controller 存在NestPrepare()方法,就实现了该接口,
type NestPreparer interface {
NestPrepare()
}
type BaseController struct {
beego.Controller
}
func (ctx *BaseController) Prepare() {
log.Println("BaseControll")
// 判断子类是否实现了NestPreparer接口,如果实现了就调用接口方法。
if app, ok := ctx.AppController.(NestPreparer); ok {
app.NestPrepare()
}
}
- 咱们上面定义了基础控制器BaseController。下面咱们新增个controllers-->index.go文件,定义IndexController代码如下:
package controllers
type IndexController struct {
BaseController
}
//首页
// @router / [get]
func (c *IndexController) Get() {
c.TplName = "index.html"
}
//留言
// @router /message [get]
func (c *IndexController) GetMessage() {
c.TplName = "message.html"
}
//关于
// @router /about [get]
func (c *IndexController) GetAbout() {
c.TplName = "about.html"
}
- 上面咱们定了3个路由已经对于的处理方法,但是,还需要调整routers->router.go才能生效。
import (
"github.com/jicg/liteblog/controllers"
"github.com/astaxie/beego"
)
func init() {
//注解路由 需要调用Include。
beego.Include(&controllers.IndexController{})
}
上面咱们定义好了golang部分代码(后端代码),还需要稍微调整下前端代码,就可正常所有页面了。
beego 模版渲染可以自定义方法(是对golang的html/template包进一步的封装)
模版自定义方法,定义的方式为:
beego.AddFuncMap("模版中调用的方法名", 具体函数)
- 咱们上讲已经将 header.html抽离出来了。上面已经将路由已经定义好,现在咱们来调整views->comm->header.html。
修改header.html将路由路径改成咱们现在定义好的
<div class="header">
<div class="header-wrap">
<h1 class="logo pull-left">
<a href="index.html">
<img src="/static/images/logo.png" alt="" class="logo-img">
<img src="/static/images/logo-text.png" alt="" class="logo-text">
</a>
</h1>
<form class="layui-form blog-seach pull-left" action="">
<div class="layui-form-item blog-sewrap">
<div class="layui-input-block blog-sebox">
<i class="layui-icon layui-icon-search"></i>
<input type="text" name="title" lay-verify="title" autocomplete="off" class="layui-input">
</div>
</div>
</form>
<!-- *************这段是调整的部分 开始 *************-->
<div class="blog-nav pull-right">
<ul class="layui-nav pull-left">
<li class="layui-nav-item "><a href="/" >首页</a></li>
<li class="layui-nav-item "><a href="/message">留言</a></li>
<li class="layui-nav-item layui-this "><a href="/about">关于</a></li>
</ul>
<a href="#" class="personal pull-left">
<i class="layui-icon layui-icon-username"></i>
</a>
</div>
<div class="mobile-nav pull-right" id="mobile-nav">
<a href="javascript:;">
<i class="layui-icon layui-icon-more"></i>
</a>
</div>
</div>
<!-- 这段是手机打开的路由-->
<ul class="pop-nav" id="pop-nav">
<li><a href="/">首页</a></li>
<li><a href="/message">留言</a></li>
<li><a href="/about">关于</a></li>
</ul>
<!-- *************调整的部分 结束 *************-->
</div>
- 调整后咱们发现 “layui-this”这个css样式咱们目前写死调了,应该根据当前的页面,选择对应的li的,这就需要拿到当前页面的路径,还要能够有方法去判断路径是否相同
2.1 获取当前页面的路径,属于通用功能,就该在BaseControllers的Prepare方法,添加变量的输出
func (ctx *BaseController) Prepare() {
// 将页面路径 保存到 Path变量里面
ctx.Data["Path"] = ctx.Ctx.Request.RequestURI
if app, ok := ctx.AppController.(NestPreparer); ok {
app.NestPrepare()
}
}
2.2 咱们再定义 equrl 模版方法,用来路径是否相同。咱们就写在main.go文件中吧。
package main
import (
_ "github.com/jicg/liteblog/routers"
"github.com/astaxie/beego"
"strings"
)
func main() {
initTemplate()
beego.Run()
}
func initTemplate() {
beego.AddFuncMap("equrl", func(x, y string) bool {
s1 := strings.Trim(x, "/")
s2 := strings.Trim(y, "/")
return strings.Compare(s1, s2) == 0
})
}
2.3 再修改views->comm->header.html里面的代码,加上路径比较的逻辑:
......
<div class="blog-nav pull-right">
<ul class="layui-nav pull-left">
<li class="layui-nav-item {{if equrl "/" .Path }}layui-this{{end}}"><a href="/" >首页</a></li>
<li class="layui-nav-item {{if equrl "/message" .Path }}layui-this{{end}}"><a href="/message">留言</a></li>
<li class="layui-nav-item {{if equrl "/about" .Path }}layui-this{{end}} "><a href="/about">关于</a></li>
</ul>
<a href="#" class="personal pull-left">
<i class="layui-icon layui-icon-username"></i>
</a>
</div>
.......
到此,页面可以正常浏览了
咱们有没有想过,如果可以乱问地址,页面会这样?答案是beego会提供一个默认错误的页面返回。因此需要修改beego的默认错误界面。
beego 提供了页面错误的文件说明 地址
- 添加个controllers->error.go 文件,定义ErrorController的控制器,里面定义好Error404、Error501 方法。代码如下
package controllers
type ErrorController struct {
BaseController
}
func (c *ErrorController) Error404() {
c.Data["content"] = "page not found"
c.TplName = "error/404.html"
}
- 接着就将ErrorController 注入到beego里面,修改默认的错误处理页面,修改方法是beego.ErrorController(错误的控制器),咱们来修改router.go 文件,再init函数开始加入要修改代码,代码如下:
func init() {
beego.ErrorController(&controllers.ErrorController{})
beego.Include(&controllers.IndexController{})
}
golang语法: golang 引入包的地方 出现这个 _ "xxx", 表示调用 xxx包下的init方法。
mian.go为入口函数,没有调用router.go的任意方法,但是注意引入包的地方 有 _ "github.com/jicg/liteblog/routers",就默认调用routers包下的init方法。
终于结束,项目已经整合完毕,但是数据是静态的,咱们的轻博客的旅程才开始。下期咱们再见。