最近刚好有个task是要用Golang把Junit的XML格式report转换成HTML格式，便学习了Golang的template包。
基于template做的那个tool transforming Junit XML report to HTML.
Golang提供了对模板的支持（按照文档的说法，是数据驱动模板，data-driven template），分别在"text/template"和"html/template"两个包下。这两个包在api级别是一致的，只是"html/template"提供了对html文本的更好支持，比如会将一些html中的关键符号（类似'<', '>'之类的）做些转义处理再输出。所以以下就只对"html/template"做下介绍。
模板定义
hello world
t := template.Must(template.New("hello").Parse("hello world"))
t.Execute(os.Stdout, nil)
// output:
// hello
此处，template.Must(*template.Template, error )会在Parse返回err不为nil时，调用panic。Must的引入，说的不好听点，就是为了中和Golang将error置于函数返回值这种做法带来的缺点。
有了Must，我们可以将两句inline在一起。
template.Must(template.New("hello").Parse("hello world")).Execute(os.Stdout, nil)
从文件初始化模板
t := template.Must(template.ParseFiles("hello.txt"))
t.Execute(os.Stdout, nil)
// hello.txt:
// hello world
// output:
// hello world
通过文件名字，指定对应的模板
t := template.New("hello")
template.Must(t.ParseFiles("hello.txt"))
template.Must(t.ParseFiles("world.txt"))
t.ExecuteTemplate(os.Stdout, "world.txt", nil)
// world.txt:
// another file
// output:
// another file
所以，一个template实例，其实是一个模板的集合，我们可以为每个模板命名。
数据驱动
hello world
s := "LiLei"
t := template.Must(template.New("test").Parse("Watch out, {{.}}!"))
t.Execute(os.Stdout, s)
// output:
// Watch out, LiLei!
也可以传点别的
s := &student{Name: "Han Meimei", Age: 30}
t := template.Must(template.New("test").Parse("{{.Name}} looks like more than {{.Age}} years old!"))
t.Execute(os.Stdout, s)
// output:
// Han Meimei looks like more than 30 years old!
Map
marrage_info := map[string]bool{
"HanMeimei": true,
"LiLei": false,
}
t := template.Must(template.New("test").Parse("Married: Han Meimei:{{.HanMeimei}}; Li Lei:{{.LiLei}}"))
t.Execute(os.Stdout, marrage_info )
// output:
// Married: Han Meimei:true; Li Lei:false
在template中key有空格，得用到index。
info := map[string]bool{
"Han Meimei": true,
"LiLei": false,
}
t := template.Must(template.New("test").Parse(`Married: Han Meimei:{{index . "Han Meimei"}}; Li Lei:{{.LiLei}}`))
t.Execute(os.Stdout, info)
// output:
// Married: Han Meimei:true; Li Lei:false
array/slice
infos := []string{"Han Meimei", "Lilei"}
t := template.Must(template.New("test").Parse("Students List:" +
"{{range .}}" +
"\n{{.}}," +
"{{end}}"))
t.Execute(os.Stdout, infos)
// output:
// Students List:
// Han Meimei,
// Lilei,
自定义变量
infos := []string{"Han Meimei", "Lilei"}
t := template.Must(template.New("test").Parse("Students List:" +
"{{range $index, $_ := .}}" +
"\n{{$index}}. {{.}}," +
"{{end}}"))
t.Execute(os.Stdout, infos)
// output:
// Students List:
// 0. Han Meimei,
// 1. Lilei,
条件查询
s := "LiLei"
t := template.Must(template.New("test").Parse(`{{if eq . "LiLei"}}Man{{else if eq . "Han Meimei"}}Women{{end}}`))
t.Execute(os.Stdout, s)
�// output:
// Man
转义
在"html/template"中，如下两端代码是等价的。
<a href="/search?q={{.}}">{{.}}</a>
<a href="/search?q={{. | urlquery}}">{{. | html}}</a>
比如
s := "<script>"
t := template.Must(template.New("test").Parse("{{. | urlquery}} and {{. | html}}"))
t.Execute(os.Stdout, s)
// output:
// %3Cscript%3E and <script>
模板重构
Golang提供的几个功能，为模板的重构提供了更多的可能。
自定义方法
// func returnBool(b bool) bool {
// return b
// }
funcs := template.FuncMap{
"is_teacher_coming": returnBool,
}
t := template.New("test").Funcs(funcs)
template.Must(t.Parse("{{if is_teacher_coming .}}Carefully!{{end}}"))
t.Execute(os.Stdout, true)
// output:
// Carefully!
嵌套模板
s := &student{Name: "Han Meimei", Age: 30}
t := template.New("test")
template.Must(t.Parse(`Name: {{.Name}}; {{template "age" .Age}}.`))
// another way to name a template
template.Must(t.Parse(`{{define "age"}}Age: {{.}}{{end}}`))
t.Execute(os.Stdout, s)
// output:
// Name: Han Meimei; Age: 30.
这里也提供了另外一个方法去指定一个模板的名字。
