通过以下文章,掌握了 Go 模板引擎 的基本用法:
但在开始学习 Beego 框架的 模板嵌套 模块源码时,有点似懂非懂的感觉。认真研究了一段时间,总算搞懂了 其本质的原理:
1、Beego 底层用的是 Go 自带的模板引擎,因此,只需要继续研究 Go 自带的 模板嵌套 的使用方法即可;
2、主要涉及到 4 个模板方法:New()、Parse()、Lookup()、Execute(),先看几个例子:
示例1:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`我是mod2`) tpl, _ = tpl.New("mod3").Parse(`我是mod3`) tpl.Execute(os.Stdout, nil) fmt.Println(" ++++++++++++++++") fmt.Println(tpl.Name())
输出:
我是mod3 ++++++++++++++++ mod3
示例2:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`我是mod2`) tpl, _ = tpl.New("mod3").Parse(`我是mod3`) tpl2 := tpl.Lookup("mod2") if tpl2 != nil { tpl2.Execute(os.Stdout, nil) }
输出:
我是mod2
示例3:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`{{define "Title"}}我是mod2_标题{{end}}我是mod2_内容`) tpl, _ = tpl.New("mod3").Parse(`我是mod3`) tpl2 := tpl.Lookup("mod2") if tpl2 != nil { tpl2.Execute(os.Stdout, nil) }
输出:
我是mod2_内容
示例4:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`{{define "Title"}}我是mod2_标题{{end}}我是mod2_内容`) tpl, _ = tpl.New("mod3").Parse(`我是mod3`) tpl2 := tpl.Lookup("Title") if tpl2 != nil { tpl2.Execute(os.Stdout, nil) }
输出:
我是mod2_标题
示例5:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`{{define "Title"}}我是mod2_标题{{end}}我是mod2_内容`) tpl, _ = tpl.New("mod3").Parse(`我是mod3`) tpl = tpl.New("mod4") tpl, _ = tpl.New("mod5").Parse("我是mod5") fmt.Println(tpl.Name()) fmt.Println("+++++++++++++++") tpl2 := tpl.Lookup("mod4") if tpl2 != nil { tpl2.Execute(os.Stdout, nil) } tpl3 := tpl.Lookup("mod5") if tpl3 != nil { tpl3.Execute(os.Stdout, nil) }
输出:
mod5 +++++++++++++++ 我是mod5
示例6:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`{{define "Title"}}我是mod2_标题{{end}}我是mod2_内容`) tpl, _ = tpl.New("mod1").Parse(`我是mod1_内容{{define "Title"}}我是mod1_标题{{end}}`) fmt.Println(tpl.Name()) fmt.Println("+++++++++++++++") tpl2 := tpl.Lookup("mod1") if tpl2 != nil { tpl2.Execute(os.Stdout, nil) } fmt.Println(" +++++++++++++++") tpl3 := tpl.Lookup("Title") if tpl3 != nil { tpl3.Execute(os.Stdout, nil) }
输出:
mod1 +++++++++++++++ 我是mod1_内容 +++++++++++++++ 我是mod1_标题
示例7:
tpl, _ := template.New("mod1").Parse(`我是mod1`) tpl, _ = tpl.New("mod2").Parse(`{{define "Title"}}我是mod2_标题{{end}}我是mod2_内容`) tpl, _ = tpl.New("mod3").Parse(`我是mod3_{{template "mod1"}}_{{template "Title"}}`) tpl2 := tpl.Lookup("mod3") if tpl2 != nil { tpl2.Execute(os.Stdout, nil) }
输出:
我是mod3_我是mod1_我是mod2_标题
总结:
1、一个模板对象,可以有多个“名称”,但是通过 .Name() 方法,只返回最后一次通过 .New() 方法新建的“名称”。特别注意:此时的 模板对象 的 数据段也是指向该“名称”所绑定的“字符串”数据;
2、一个模板对象,可以有多个“名称”,但是他们是相互独立的,每个“名称”,通过 .Parse() 方法,可以与一段“字符串”数据对象建立关联。也就是说,后期通过 .Lookup("某个名称") 方法获取到的(模板)对象,其当前数据段,指向该“字符串”,再通过 .Execute() 方法输出的内容,也是跟该“字符串”相关的内容;
3、在某个“名称”的数据“字符串”对象中,可以用 define 定义子模块名,如 {{define "子模块名"}}子模块内容{{end}},该 “子模块”又独立于 当前“名称”,即 当前“名称”的输出内容,不包含 “子模板”的内容,参考 示例3
只输出“我是mod2_内容”,并没有输出“我是mod2_标题”
4、特别注意,通过 {{define "子模块名"}}子模块内容{{end}} 定义的名称,并不是 模板对象 的一个“名称”,但是我们同样可以用 .Lookup("某个名称") 方法获取到对象,其当前数据段,指向该 “子模块”,再通过 .Execute() 方法输出的内容,也是跟该“子模块”相关的内容,查看 示例4
只输出“我是mod2_标题”
5、可用重复定义“名称”和 “子模块”,但后面定义的会覆盖前面定义的,即 只有最后一次定义的有效。参考 示例6
6、模板内容(“名称”的“字符串”对象)中,可通过 template 关键字来 引用/包含 “名称”和 “子模块”,如 {{template "名称/子模块"}},参考 示例7
搞明白了这些基础知识,再回过头看 Beego 的模板模块,已是非常简单了!