前言
在Go语言中,模板引擎库text/template包主要用于处理任意格式的文本内容,同时还提供了html/template包,用于生成可对抗代码注入的安全HTML文档。
模板可以被理解为实现定义好的HTML文档。模板渲染可以被简单理解为文本替换操作。使用相应的数据去替换HTML文档中事先准备好的标记内容。
根据MVC模型,模板的诞生是为了将显示与数据分离,即前后端分离。
模板引擎
模板引擎库text/template包的使用方式,可以归纳为4点:
模板文件的后缀名通常是.tmpl和.tpl,必须使用UTF-8编码。
模板文件中使用{{和}}来包裹和标识需要传入的数据。
传给模板的数据可以通过点好(.)来访问。如果是复合类型的数据,则可以通过{{.FieldName}}来访问它的字段。
除了{{与}}包裹的内容外,其他内容均不做修改,原样输出。
定义模板文件
定义模板文件是指,按照相应的语法规则去定义模板文件。
解析模板文件
html/template包提供了以下方法来解析模板文件,获得模板对象。
1.可以通过New()函数模板来创建模板对象,并为其添加一个模板名称。
2.可以使用Parse()方法来创建模板对象,并完成解析模板内容。
3.如果要解析模板文件,则使用ParseFiles()函数,该函数返回模板对象。
4.如果需要批量解析文件,则使用ParseGlob()函数。该函数可以进行正则匹配。
func New(name string) *Template func (t *Template) Parse(src string)(*Template,error) func ParseFiles(filename ...string)(*Template,error) func ParseGlob(pattern string)(*Template,error)
渲染模板
html/template包提供了Execute()和ExecuteTemplate()方法来渲染模板。其具体定义如下:
func (t *Template) Execute(wr io.Writer,data interface()) error{} func (t *Template) ExecuteTemplate(wr io.Writer,name string,data interface{})error{}
需要注意的是,使用ParseFiles()函数可以一次加载多个模板,此时不可以使用Execute()来执行数据融合,可以通过ExecuteTemplate()函数指定模板名称来执行数据融合。
实战使用模板
接下来,我们来通过代码实战,学习模板的应用。
创建.tmpl文件
首先,我们需要创建一个template_example.tmpl的模板文件,如果你学习过其他的Web开发,可以将其理解为html代码,示例如下:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width,initial-scale=1.0"> <title>模板的第一次实战</title> </head> <body> <p>欢迎小伙伴跟随博主学习{{ . }}开发</p> </body> </html>
创建文件用于解析与渲染模板
接着,我们需要创建文件用于解析与渲染模板,示例如下(.go文件):
package main import ( "fmt" "html/template" "net/http" ) func helloHandleFunc(w http.ResponseWriter, r *http.Request) { t, err := template.ParseFiles("./template_example.tmpl") if err != nil { fmt.Println("template parsefile failed,error:", err) return } yyds := "Go Web" t.Execute(w, yyds) } func main() { http.HandleFunc("/", helloHandleFunc) http.ListenAndServe(":80", nil) }
运行之后,你会发现浏览器输出了如下字符串代码: