beego开发轻博客——第三讲 项目整合(三)

【小鸡创作】beego开发轻博客

本章目标：添加页面路由，能正常访问轻博客页面
github: 打开后，点击右上角star按钮
视频教程: B站地址

---

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的接口实现，没有强制性约定。只要实现了接口定义的所有方法，就是实现了接口。

1. 咱们首先创建一个controllers-->base.go，新增结构体BaseController继承beego.Controller,为BaseController添加的Prepare() 方法。所有继承了BaseController的子controller 每次请求都会调用BaseController的Prepare()方法，因此咱们约定所有的子controller都会继承BaseController，可以将每次请求的通用逻辑写在BaseController的Prepare方法里面。
2. 如果子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()
    }
}

3. 咱们上面定义了基础控制器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"
}

4. 上面咱们定了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("模版中调用的方法名", 具体函数)

1. 咱们上讲已经将 header.html抽离出来了。上面已经将路由已经定义好，现在咱们来调整views->comm->header.html。
   修改header.html将路由路径改成咱们现在定义好的

    

        

            
                
                
            
        
        

            

                

                    
                    
                
            
        
      
        

            

                
首页
                
留言
                
关于
            
            
                
            
        
        

            
                
            
        
    
   
    

        
首页
        
留言
        
关于
    
  

2. 调整后咱们发现 “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里面的代码，加上路径比较的逻辑：

......

            

                
首页
                
留言
                
关于
            
            
                
            
        
.......

到此，页面可以正常浏览了

---

咱们有没有想过，如果乱问地址，页面会怎样？答案是beego会提供一个默认错误的页面返回。因此需要修改beego的默认错误界面。

beego 提供了错误页面处理的方案 地址

1. 添加个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"
}

2. 接着就将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方法。

终于结束，项目已经整合完毕，但是数据是静态的，咱们的轻博客的旅程才开始。下期咱们再见。