Go Web编程实战（10）----模板引擎库text/template包的使用

2023-11-20

前言

在Go语言中，模板引擎库text/template包主要用于处理任意格式的文本内容，同时还提供了html/template包，用于生成可对抗代码注入的安全HTML文档。

模板可以被理解为实现定义好的HTML文档。模板渲染可以被简单理解为文本替换操作。使用相应的数据去替换HTML文档中事先准备好的标记内容。

根据MVC模型，模板的诞生是为了将显示与数据分离，即前后端分离。

模板引擎

模板引擎库text/template包的使用方式，可以归纳为4点：

模板文件的后缀名通常是.tmpl和.tpl，必须使用UTF-8编码。
模板文件中使用{{和}}来包裹和标识需要传入的数据。
传给模板的数据可以通过点好（.）来访问。如果是复合类型的数据，则可以通过{{.FieldName}}来访问它的字段。
除了{{与}}包裹的内容外，其他内容均不做修改，原样输出。

定义模板文件

定义模板文件是指，按照相应的语法规则去定义模板文件。

解析模板文件

html/template包提供了以下方法来解析模板文件，获得模板对象。

可以通过New()函数模板来创建模板对象，并为其添加一个模板名称。
可以使用Parse()方法来创建模板对象，并完成解析模板内容。
如果要解析模板文件，则使用ParseFiles()函数，该函数返回模板对象。
如果需要批量解析文件，则使用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)
}

运行之后，你会发现浏览器输出了如下字符串代码：

Web打印内容

本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)