既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上Go语言开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新
大多数服务器端语言的机制主要是在静态页面插入一个动态生成的组件,如清单列表项目。典型的例子是在JSP、PHP和许多其他语言的脚本中。GO的template
包中采取了相对简单的脚本化语言。
因为新的template包是刚刚被采用的,所有现在的template包中的文档少的可怜,旧的old/template
包中也还存有少量的旧模板。新发布的帮助页面还没有关于新包的文档。关于template包的更改请参阅r60 (released 2011/09/07).
在这里,我们描述了这个新包。该包是描述了通过使用对象值改变了原来文本的方式从而在输入和输出时获取不同的文本。与JSP或类似的不同,它的作用不仅限于HTML文件,但在那可能会有更大的作用。
源文件被称作 template ,包括文本传输方式不变,以嵌入命令可以作用于和更改文本。命令规定如 {{ ... }}
,类似于JSP命令 <%= ... =%>
和PHP命令 <?php ... ?>
。
Inserting object values
插入对象值
模板应用于GO对象中.GO对象的字段被插入到模板后,你就能从域中“挖”到他的子域,等等。当前对象以’.'代替, 所以把当前对象当做字符串插入时,你可以采用{{.}}
的方式。这个包默认采用 fmt
包来作为插入值的字符串输出。
要插入当前对象的一个字段的值,你使用的字段名前加前缀 ‘.’。 例如, 如果要插入的对象的类型为
type Person struct {
Name string
Age int
Emails []string
Jobs []*Jobs
}
那么你要插入的字段 Name
和 Age
如下
The name is {{.Name}}.
The age is {{.Age}}.
我们可以使用range
命令来循环一个数组或者链表中的元素。所以要获取 Emails
数组的信息,我们可以这么干
{{range .Emails}}
...
{{end}}
如果Job
定义为
type Job struct {
Employer string
Role string
}
如果我们想访问 Person
字段中的 Jobs
, 我们可以这么干 {{range .Jobs}}
。这是一种可以将当前对象转化为Jobs
字段的方式. 通过 {{with ...}} ... {{end}}
这种方式, 那么{{.}}
就可以拿到Jobs
字段了,如下:
{{with .Jobs}}
{{range .}}
An employer is {{.Employer}}
and the role is {{.Role}}
{{end}}
{{end}}
你可以用这种方法操作任何类型的字段,而不仅限于数组。亲,用模板吧!
当我们拥有了模板,我们将它应用在对象中生成一个字符串,用这个对象来填充这个模板的值。分两步来实现模块的转化和应用,并且输出一个Writer
, 如下
t := template.New("Person template")
t, err := t.Parse(templ)
if err == nil {
buff := bytes.NewBufferString("")
t.Execute(buff, person)
}
下面是一个例子来演示模块应用在对象上并且标准输入:
/\*\*
\* PrintPerson
\*/
package main
import (
"fmt"
"html/template"
"os"
)
type Person struct {
Name string
Age int
Emails []string
Jobs []*Job
}
type Job struct {
Employer string
Role string
}
const templ = `The name is {{.Name}}.
The age is {{.Age}}.
{{range .Emails}}
An email is {{.}}
{{end}}
{{with .Jobs}}
{{range .}}
An employer is {{.Employer}}
and the role is {{.Role}}
{{end}}
{{end}}
`
func main() {
job1 := Job{Employer: "Monash", Role: "Honorary"}
job2 := Job{Employer: "Box Hill", Role: "Head of HE"}
person := Person{
Name: "jan",
Age: 50,
Emails: []string{"jan@newmarch.name", "jan.newmarch@gmail.com"},
Jobs: []*Job{&job1, &job2},
}
t := template.New("Person template")
t, err := t.Parse(templ)
checkError(err)
err = t.Execute(os.Stdout, person)
checkError(err)
}
func checkError(err error) {
if err != nil {
fmt.Println("Fatal error ", err.Error())
os.Exit(1)
}
}
输出如下:
The name is jan.
The age is 50.
An email is jan@newmarch.name
An email is jan.newmarch@gmail.com
An employer is Monash
and the role is Honorary
An employer is Box Hill
and the role is Head of HE
注意,上面有很多空白的输出,这是因为我们的模板中有很多空白。如果想消除它, 模板设置如下:
{{range .Emails}} An email is {{.}} {{end}}
在这个示例例中,我们用字符串应用于模板。你同样也可以用方法template.ParseFiles()
来从文件中下载模板。因为某些原因,我还不没搞清楚(在早期版本没有强制要求),关联模板的名字必须要与文件列表的第一个文件的基名相同。话说,这个是BUG吗?
Pipelines
管道
上述转换到模板中插入的文本块。这些字符基本上是任意的,是任何字符串的字段值。如果我们希望它们出现的是HTML文档(或其他的特殊形式)的一部分,那么我们将不得不脱离特定的字符序列。例如,要显示任意文本在HTML文档中,我们要将“<”改成“<”。GO模板有一些内建函数,其中之一是html
。这些函数的作用与Unix的管道类似,从标准输入读取和写入到标准输出。
如果想用“.”来获取当前对象值并且应用于HTML转义,你可以在模板里写个“管道”:
{{. | html}}
其他方法类似。
Mike Samuel指出,目前在exp/template/html
包里有一个方便的方法。如果所有的模板中的条目需要通过html
模板函数,那么Go语言方法 Escape(t *template.Template)
就能获取模板而后将html
函数添加到模板中不存在该函数的每个节点中。用于HTML文档的模板是非常有用的,并能在其他使用场合生成相似的方法模式。
Defining functions
定义方法
模板使用对象化的字符串表示形式插入值,使用fmt
包将对象转换为字符串。有时候,这并不是必需。例如,为了避免被垃圾邮件发送者掌握电子邮件地址,常见的方式是把字符号“@”替换为“at”,如“jan at newmarch.name”。如果我们要使用一个模板,显示在该表单中的电子邮件地址,那么我们就必须建立一个自定义的功能做这种转变。
每个模板函数中使用的模板本身有的一个名称,以及相关联的函数。他们用下面方式进行关联如下
type FuncMap map[string]interface{}
例如,如果我们希望我们的模板函数是“emailExpand”,用来关联到Go函数EmailExpander
,然后,我们像这样添加函数到到模板中
t = t.Funcs(template.FuncMap{"emailExpand": EmailExpander})
EmailExpander
通常像这样标记:
func EmailExpander(args ...interface{}) string
我们感兴趣的是在使用过程中,那是一个只有一个参数的函数,并且是个字符串。在Go模板库的现有功能有初步的代码来处理不符合要求的情况,所以我们只需要复制。然后,它就能通过简单的字符串操作来改变格式的电子邮件地址。程序如
/\*\*
\* PrintEmails
\*/
package main
import (
"fmt"
"os"
"strings"
"text/template"
)
type Person struct {
Name string
Emails []string
}
const templ = `The name is {{.Name}}.
{{range .Emails}}
An email is "{{. | emailExpand}}"
{{end}}
`
func EmailExpander(args ...interface{}) string {
ok := false
var s string
if len(args) == 1 {
s, ok = args[0].(string)
}
if !ok {
s = fmt.Sprint(args...)
}
// find the @ symbol
substrs := strings.Split(s, "@")
if len(substrs) != 2 {
return s
}
// replace the @ by " at "
return (substrs[0] + " at " + substrs[1])
}
func main() {
person := Person{
Name: "jan",
Emails: []string{"jan@newmarch.name", "jan.newmarch@gmail.com"},
}
t := template.New("Person template")
// add our function
t = t.Funcs(template.FuncMap{"emailExpand": EmailExpander})
t, err := t.Parse(templ)
checkError(err)
err = t.Execute(os.Stdout, person)
checkError(err)
}
func checkError(err error) {
if err != nil {
fmt.Println("Fatal error ", err.Error())
os.Exit(1)
}
}
The output is
输出为:
The name is jan.
An email is "jan at newmarch.name"
An email is "jan.newmarch at gmail.com"
Variables
变量
template包,允许您定义和使用变量。这样做的动机,可能我们会考虑通过把他们的名字当做电子邮件地址前缀打印出来。我们又使用这个类型
type Person struct {
Name string
Emails []string
}
为了访问email的所有字符串, 可以用 range
,如下
{{range .Emails}}
{{.}}
{{end}}
但是需要指出的是,我们无法用’.’ 的形式来访问字段 Name
,因为当他被转化成数组元素时,字段Name
并不包括其中。解决方法是,将字段Name
存储为一个变量,那么它就能在任意范围内被访问。变量在模板中用法是加前缀’$'。所以可以这样
{{$name := .Name}}
{{range .Emails}}
Name is {{$name}}, email is {{.}}
{{end}}
程序如下:
/\*\*
\* PrintNameEmails
\*/
package main
import (
"html/template"
"os"
"fmt"
)
type Person struct {
Name string
Emails []string
}
const templ = `{{$name := .Name}}
{{range .Emails}}
Name is {{$name}}, email is {{.}}
{{end}}
`
func main() {
person := Person{
Name: "jan",
Emails: []string{"jan@newmarch.name", "jan.newmarch@gmail.com"},
}
t := template.New("Person template")
t, err := t.Parse(templ)
checkError(err)
err = t.Execute(os.Stdout, person)
checkError(err)
}
func checkError(err error) {
if err != nil {
fmt.Println("Fatal error ", err.Error())
os.Exit(1)
}
}
输出为
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上Go语言开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新
ror(err)
err = t.Execute(os.Stdout, person)
checkError(err)
}
func checkError(err error) {
if err != nil {
fmt.Println("Fatal error ", err.Error())
os.Exit(1)
}
}
输出为
[外链图片转存中...(img-GEIjS68X-1715443349220)]
[外链图片转存中...(img-0JsBCJ5I-1715443349221)]
[外链图片转存中...(img-mon28BtJ-1715443349221)]
**既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上Go语言开发知识点,真正体系化!**
**由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新**
**[如果你需要这些资料,可以戳这里获取](https://bbs.csdn.net/topics/618658159)**