Go Web 编程--超详细的模板库应用指南

模板库介绍

如果你有过Web编程的经验,那么或多或少都听说过或者使用过模板。简而言之,模板是可用于创建动态内容的文本文件。例如,你有一个网站导航栏的模板,其中动态内容的一部分可能是根据当前用户是否登录显示登录还是退出按钮。

Go提供了两个模板库text/templatehtml/template。这两个模板库的使用方式是相同的,但是html/template包在渲染页面模板时会在后台进行一些编码以帮助防止造成代码注入(XSS 攻击)。

因为两个模板库都使用相同的接口,因此本文中介绍的所有内容均可用于这两个程序包,但是大多数时候我们都会使用html/template程序包来生成HTML代码段。

Go Web 编程系列的每篇文章的源代码都打了对应版本的软件包,供大家参考。公众号中回复 gohttp07获取本文源代码

模板文件的后缀名

模板文件可以使用.html或任何其他扩展名。但是通常我们将使用.gohtml扩展名来命名模板文件,因为编辑器通常使用它来表示你想要高亮Go HTML模板语法。 AtomSublime Text等编辑器都具有Go插件,来默认识别此扩展名。

模板语法

我们先来创建一个简单的模板文件test.gohtml:



    
        
        Go Web
    
    
        {{ . }}
    

{{ 和 }} 中间的半角句号 . 它代表模板对象执行Execute(w, data)传入模板的数据,它是顶级作用域范围内的,根据传入的数据不同渲染不同的内容。. 可以代表Go语言中的任何类型,如结构体、Map等。

在写模板的时候,会经常用到.。比如{{.}}{{len .}}{{.Name}}{{$x.Name}}

{{ 和 }} 包裹的内容统称为 action,分为两种类型:

  • 数据求值(data evaluations)
  • 控制结构(control structures)

action求值的结果会直接复制到模板中,控制结构和我们写Go程序差不多,也是条件语句、循环语句、变量、函数调用等等...模板中的 action 并不多,我们一个一个看。

注释

{{/* comment */}}

裁剪空字符

注意裁剪的是替换内容前面或者后面的空字符,你可以理解成模板中{{前面或}}后面的空字符(包括换行符、制表符、空格等)。

// 裁剪 content 前后的空字符
{{- content -}}

// 裁剪 content 前面的空字符
{{- content }}

// 裁剪 content 后面的空字符
{{ content -}}

文本输出

{{ pipeline }}

pipeline代表的数据会产生与调用 fmt.Print 函数类似的输出,例如整数类型的 3 会转换成字符串 "3" 输出。

条件语句

{{ if pipeline }} T1 {{ end }}

{{ if pipeline }} T1 {{ else }} T0 {{ end }}

{{ if pipeline }} T1 {{ else if pipeline }} T0 {{ end }}

// 上面的语法其实是下面的简写
{{ if pipeline }} T1 {{ else }}{{ if pipeline }} T0 { {end }}{{ end }}

{{ if pipeline }} T1 {{ else if pipeline }} T2 {{ else }} T0 {{ end }}

如果 pipeline 的值为空,不会输出 T1,除此之外 T1 都会被输出。

空值有false0nil空字符串 ""(长度为 0 的字符串)。

循环语句

{{ range pipeline }} T1 {{ end }}

// 这个 else 比较有意思,如果 pipeline 的长度为 0 则输出 else 中的内容
{{ range pipeline }} T1 {{ else }} T0 {{ end }}

// 获取容器的下标
{{ range $index, $value := pipeline }} T1 {{ end }}

循环语句中的pipeline 的值必须是数组、切片、字典和通道中的一种,即可迭代类型的值,根据值的长度输出多个 T1。

define

{{ define "name" }} T {{ end }}

定义命名为 name 的模板。

template

{{ template "name" }}

{{ template "name" pipeline }}

第一种是直接执行名为name的模板,模板的全局数据对象.设置为nil。第二种是点.设置为pipeline的值,并执行名为name的模板。

block

{{ block "name" pipeline }} T1 {{ end }}

block 的语义是如果有命名为 name 的模板,就引用过来执行,如果没有命名为 name 的模板,就是执行自己定义的内容。换句话说,block可以认为是设置一个默认模板。

with

{{ with pipeline }} T1 {{ end }}

// 如果 pipeline 是空值则输出 T0
{{ with pipeline }} T1 {{ else }} T0 {{ end }}

{{ with arg }}
    . // 此时 . 就是 arg
{{ end }}

with 创建一个新的上下文环境,在此环境中的 . 与外面的 . 无关。

对于第一种格式,当pipeline不为0值的时候,点.设置为pipeline运算的值,否则跳过。对于第二种格式,当pipeline为0值时,执行else语句块,否则.设置为pipeline运算的值,并执行T1。

例如:

{{with .Person}}{{ .Name}}{{end}}

在这个 with 块中.Name实际上引用的是全局数据对象的.Person.Name

实践练习:课程花名册页面

了解完模板语法后,接下来让我们再http_demo项目中结合BootStrap创建一个简单的模板,来展示服务器如何把数据传递给模板、渲染HTML页面,把页面响应返回给客户端。

我们创建一个用来展示大学物理课程的花名册(授课老师和上课学生)

创建页面模板

首先在我们的项目添加一个views目录用于存放模板文件,在创建三个模板文件分别是:

layout.gohtml 用于存放页面的整体布局。



    
    
    
    
    

    Bootstrap Template Page for Go Web Programming

    
    




{{ template "nav" .}}

{{template "content" .}}

nav.gohtml是网页头部区域的页面模板。

{{define "nav"}}


Hello, Professor {{.Teacher.Name}}

  • Name : {{.Teacher.Name}}

  • Subject : {{.Teacher.Subject}}

More »

{{end}}

content.gohtml是网页主体内容部分的页面模板。

{{define "content"}}
{{range .Students}}

Name

Name has the value of : {{.Name}}

More »

Id

Id has the value of : {{.Id}}

More »

Country

Country has the value of : {{.Country}}

More »

{{end}} {{end}}

layout.gohtml中我们引用了另外的两个模板:

{{ template "nav" .}}
{{template "content" .}}

这样不同的页面变化的部分就只是content部分,针对不同的页面我们只需要定义多个content模板,每次根据不同请求使用不同的content模板就行了。当然这里的例子有点简陋,大家理解意思就行了。

注意模板名称后面的.,我们把layout.gohtml的全局数据对象传给了另外两个模板这样,在子模板里也能访问传给模板的数据了。如果页面模板中使用的数据字段和循环语句有点疑惑可以先不用管,继续往下看,等看过传给页面模板的数据后自然就理解了。

创建响应页面请求的Handler

接下来创建一个伺服页面请求的Handler

package handler

import (
    "fmt"
    "html/template"
    "net/http"
)

type Teacher struct {
    Name    string
    Subject string
}
type Student struct {
    Id      int
    Name    string
    Country string
}

type Rooster struct {
    Teacher Teacher
    Students []Student
}

func ShowIndexView(response http.ResponseWriter, request *http.Request) {

    teacher := Teacher{
        Name:    "Alex",
        Subject: "Physics",
    }
    students := []Student{
        {Id: 1001, Name: "Peter", Country: "China"},
        {Id: 1002, Name: "Jeniffer", Country: "Sweden"},
    }
    rooster := Rooster{
        Teacher:  teacher,
        Students: students,
    }

    tmpl, err := template.ParseFiles("./views/layout.gohtml", 
                                   "./views/nav.gohtml", 
                                   "./views/content.gohtml")
  
    if err != nil {
        fmt.Println("Error " +  err.Error())
    }
    tmpl.Execute(response, rooster)
}

使用template.ParseFiles加载这个页面要使用的全部三个模板(如果加载少了,访问页面时会发生panic),然后使用模板对象的 Execute方法把我们存储了花名册信息的数据对象传给模板: tmpl.Execute(response, rooster) 渲染页面并写到响应里去(http.ResponseWriter对象)。

注册页面路由

处理程序写完后,为其注册路由,在我们项目的路由模块添加如下路由:

package router

import (
    "example.com/http_demo/middleware"
    "github.com/gorilla/mux"
    "example.com/http_demo/handler"
)

func RegisterRoutes(r *mux.Router) {
    r.Use(middleware.Logging())
...

  viewRouter := r.PathPrefix("/view").Subrouter()
  viewRouter.HandleFunc("/index", handler.ShowIndexView)
}

访问页面

现在所有步骤都完成了,重启我们的服务器后就可以访问到新写的页面了。

如果是在本地电脑里,用Ctrl+C结束服务器进程后再次执行go run main.go。如果是使用我们之前文章里的Docker开发环境的话(公众号回复:go-docker 获取Docker环境的安装指南)需要在docker-compose.yml所在的目录里用docker-compose restart重启服务。

打开浏览器输入http://localhost:8000/view/index就能访问到我们刚才写的页面了。

l

总结

今天的文章讲解了Go模板最常使用的几个功能的使用方法,使用html/template模板库结合BootStrap做页面模板,还是比较简单的BootStrap帮我们解决了很多前端的样式问题。模板库还有很多更高级的用法,比如在模板中调用函数、定义变量等功能,可以看下文末给出的参考链接了解这些内容。在前后端分离架构流行的今天我觉得作为用Go开发的后端工程师了解文章中列出的这些功能就够了。

今天的例子中是通过 CDN 引用的BootStrap静态资源,到目前我们的服务器还无法伺服静态资源,这个我们下篇文章再讲。公众号回复gohttp07即可获取今天文章中示例代码的下载链接。如果觉得我的文章有收获,请帮忙分享给更多人。

参考

Go 语言标准库 text/template 包深入浅出

An Introduction to Templates in Go

前文回顾

深入学习用Go编写HTTP服务器

设置HTTP服务器的路由

Go Web编程--应用ORM

Go Web编程--深入学习解析HTTP请求

你可能感兴趣的:(golang,web,模板引擎,实践)