Golang之template 常用方法详解

Go template包下面有两个函数可以创建模板实例

func New(name string) *Template 
func ParseFiles(filenames ...string) (*Template, error)

首先要说的是每一个template内部可以存储多个模板，而且每个模板必须对应一个独立的名字。
两个的不同点在于：

1、使用 New() 在创建时就为其添加一个模板名称，并且执行 t.Execute() 会默认去寻找该名称进行数据融合；

2、使用 ParseFiles() 创建模板可以一次指定多个文件加载多个模板进来，但是就不可以使用 t.Execute() 来执行数据融合；

func (*Template) Execute

func (t *Template) Execute(wr io.Writer, data interface{}) error

Execute方法将解析好的模板应用到data上，并将输出写入wr。如果执行时出现错误，会停止执行，但有可能已经写入wr部分数据。
模板可以安全的并发执行。

但是 ParseFiles() 可以通过

func (t *Template) ExecuteTemplate(wr io.Writer, name string, data interface{}) error

来进行数据融合，因为该函数可以指定模板名，因此，实例模板就可以知道要去加载自己内部的哪一个模板进行数据融合。

func (*Template) ExecuteTemplate

func (t *Template) ExecuteTemplate(wr io.Writer, name string, data interface{}) error

ExecuteTemplate方法类似Execute，但是使用名为name的t关联的模板产生输出。

因为使用 t.Execute() 无法找到要使用哪个加载过的模板进行数据融合，而只有New()创建时才会指定一个 t.Execute() 执行时默认
加载的模板。

当然无论使用 New() 还是 ParseFiles() 创建模板，都是可以使用 ExecuteTemplate() 来进行数据融合，

但是对于 Execute() 一般与 New() 创建的模板进行配合使用。

html/template 和 text/template

html下的template结构体 实际上是继承了 text 下面的 template结构体

template包下面还有一个 ParseGlob() 方法用于批量解析文件比如在当前目录下有以h开头的模板10个，

使用 template.ParseGlob(“h*”) 即可页将10个模板文件一起解析出来。
注意事项
下面这段代码的输出一定为空

t := template.New("haha")
t, err := t.ParseFiles("header.tmpl")
fmt.Println(err)
t.Execute(os.Stdout, nil)

原因是为什么呢…

首先先记住一个原则 template.New() 和 ParseFiles() 最好不要一起使用，

如果非要一起使用，那么要记住，

New(“TName”) 中的 TName 必须要和 header.tmpl 中定义的{{define name}}中的 name 同名。

但是正常的做法应该是这样的，同样的 ExecuteTemplate() 中输入的 name 也必须和模板中 {{define name}} 相同。

t, _ := template.ParseFiles("header.tmpl")
t.ExecuteTemplate(os.Stdout, "header", nil)

这里要注意下，在这种情况下如果使用 t.Execute() 也是不会输出任何结果的，因为他并不知道你要使用哪个模板。
另外一点要注意的就是

如果模板中没有与填充数据对应的模板语言，那么很有可能panic。

模板中 {{}} 花括号表达式，自动实现了对js代码的过滤，如何不过滤js代码呢，只需要使用 text/template 包下的template，因为html/template包下的模板实现一些针对html的安全操作包括过滤js代码。

Golang 当中支持 Pipeline，一样是使用 |，

Go允许在模板中自定义变量，自定义模板函数。

函数定义必须遵循如下格式：

func FuncName(args ...interface{}) string

通过 template.FuncMap() 强制类型转换为 FuncMap 类型，然后再通过 template实例的 Func(FuncMap) 添加在模板实例中，这样该模板内部在解析时就可以使用该函数。

Go模板包中自定义了一系列内置函数：

var builtins = FuncMap{
    "and":      and,
    "call":     call,
    "html":     HTMLEscaper,
    "index":    index,
    "js":       JSEscaper,
    "len":      length,
    "not":      not,
    "or":       or,
    "print":    fmt.Sprint,
    "printf":   fmt.Sprintf,
    "println":  fmt.Sprintln,
    "urlquery": URLQueryEscaper,
     
     
    // Comparisons
    "eq": eq, // ==
    "ge": ge, // >=
    "gt": gt, // >
    "le": le, // <=
    "lt": lt, // <
    "ne": ne, // !=
}