Go标准库http/template

简介: Go标准库http/template

关于html/template

       html/template中实现了数据驱动的模板,与text/template具有相同的接口。前者用于输出THTML,或者用户text。通过关于html/template包可以有效防止代码注入,破坏HTML的内容。

模板与渲染有什么作用呢?

在前端和后端分离的Web项目中,我们经常要将后端的数据应用在前端的HTML页面中。那通过发送响应报文,然后前端去修改不就好了。设想每次都去修改的话,是不是特别的不方便。所以模板渲染的作用就显而易见了。比如,很多HTML页面的布局都差不多,但是需要展示的数据却不相同,这时候我们就可以通过模板的方式动态的更新HTML页面中的数据。(如何去调用这些数据,其实无非就是通过某种规定的语法去获取数据)

注:在大多数的web框架中都支持模板引擎

模板是什么呢?就是HTML文件而已

渲染时什么呢?就是用后台的数据(此时此刻我想在HTML页面中展示的数据)去替换HTML模板中的有模板语法规定的地方,从而将数据实时的显示在模板文件中。

Go模板引擎的相关规定

1.模板文件必须使用utf-8编码方式,文件后缀名最好使用 .tmpl 后者 .tpl (当然使用.html也可以)

2.模板文件中通过 {{}} 来表示需要获取的内容。(也可以自己定义)

3.通过 . 获取数据 .fieldName来获取结构体中的字段

GO模板引擎的使用

       GO模板引擎的使用分为三个步骤:定义模板、解析模板、渲染模板

定义模板:

       定义模板就是用一些规定的语法规则去写HTML文件

  • 语法规则

       1.语法规则(语句)都要写在{{XXX}}中【XXX为语法规则】

       2.{{.}} 中的 . 表示传过来的内容

       3.{{/* XXXX */}}中的 /*  */表示注释,可以多行,不能嵌套,必需紧跟着{{和}}

       4.GO模板中可以使用  | 来链接多个命令,前面的命令会将运算结果传递给后一个命令

       5. 变量,通过$来定义变量

       6.去掉前后空格{{- XXX  -}}   -必须紧贴  {{  和   }}

       7.条件判断

{{if 条件}}内容1{{end}}
{{if 条件}}内容1{{else}}内容2{{end}}
{{if 条件1}}内容1{{else if 条件2}}}内容2{{end}}
{{if 条件1}}内容1{{else if 条件2}}}内容2{{else}}内容3{{end}}

      8.range(遍历)   遍历的对象必须是数组、切片、字段典、通道

{{range pipeline}} 内容 {{end}}
{{range pipeline}} 内容1 {{else}} 内容2{{end}}

       9.with

{{with pipeline}} T1 {{end}}
{{with pipeline}} T1 {{else}}T2{{end}}

注:执行模板时,一般先从函数模板字典查找,然后再从全局函数字典中查找。不建议在模板内定义函数,而是将函数添加到模板函数中。    

 10.预定义全局函数(大概来了解下,需要用的时候再回来查)

and
    函数返回它的第一个empty参数或者最后一个参数;
    就是说"and x y"等价于"if x then y else x";所有参数都会执行;
or
    返回第一个非empty参数或者最后一个参数;
    亦即"or x y"等价于"if x then x else y";所有参数都会执行;
not
    返回它的单个参数的布尔值的否定
len
    返回它的参数的整数类型长度
index
    执行结果为第一个参数以剩下的参数为索引/键指向的值;
    如"index x 1 2 3"返回x[1][2][3]的值;每个被索引的主体必须是数组、切片或者字典。
print
    即fmt.Sprint
printf
    即fmt.Sprintf
println
    即fmt.Sprintln
html
    返回与其参数的文本表示形式等效的转义HTML。
    这个函数在html/template中不可用。
urlquery
    以适合嵌入到网址查询中的形式返回其参数的文本表示的转义值。
    这个函数在html/template中不可用。
js
    返回与其参数的文本表示形式等效的转义JavaScript。
call
    执行结果是调用第一个参数的返回值,该参数必须是函数类型,其余参数作为调用该函数的参数;
    如"call .X.Y 1 2"等价于go语言里的dot.X.Y(1, 2);
    其中Y是函数类型的字段或者字典的值,或者其他类似情况;
    call的第一个参数的执行结果必须是函数类型的值(和预定义函数如print明显不同);
    该函数类型值必须有1到2个返回值,如果有2个则后一个必须是error接口类型;
    如果有2个返回值的方法返回的error非nil,模板执行会中断并返回给调用模板执行者该错误;

       11.比较函数(布尔函数)

               注1:布尔函数会将任何类型的零值视为false,非零值视为true

               注2:只有相同类型可以相互比较

eq      如果arg1 == arg2则返回真
ne      如果arg1 != arg2则返回真
lt      如果arg1 < arg2则返回真
le      如果arg1 <= arg2则返回真
gt      如果arg1 > arg2则返回真
ge      如果arg1 >= arg2则返回真

       12.自定义函数

       Go支持自定义模板函数,并且自定义函数一般不写在模板文件中(即不写在{{}}中)

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title>干饭小白</title>
    </head>
    <body>
        {{tmpFunc .}}
    </body>
</html>
package main
import (
  "fmt"
  "html/template"
  "io/ioutil"
  "net/http"
)
//测试:模板函数自定义函数
func MyHandler(w http.ResponseWriter, r *http.Request) {
  //读取模板文件中的内容
  temByte, err := ioutil.ReadFile("./index.tmpl")
  if err != nil {
    fmt.Println("read tmpl err=", err)
    return
  }
  //自定义一个模板函数   我们为了方便定义一个匿名函数
  tmpFunc := func(arg string) string {
    return arg + "love you"
  }
  //创建一个模板实例
  tem := template.New("index")
  //添加自定义函数  map[key]interface{}-->key方便在模板函数中找到函数入口
  tmp2 := tem.Funcs(template.FuncMap{"tmpFunc": tmpFunc})
  //解析模板(解析模板函数中的内容)
  tmp2, err = tmp2.Parse(string(temByte))
  if err != nil {
    fmt.Println("Parse err=", err)
    return
  }
  //执行模板
  tmp2.Execute(w, "chen")
}
func main() {
  http.HandleFunc("/", MyHandler)
  http.ListenAndServe(":9090", nil)
}

       13.嵌套template

               GO模板支持在一个模板文件中嵌套另一个模板文件

               支持直接在同一个文件中:

               {{define  "待嵌套文件名"}}

                       XXXXX

               {{end}}

package main
import (
  "fmt"
  "html/template"
  "net/http"
)
type User struct {
  Id       int
  Name     string
  Password string
}
func temHandler(w http.ResponseWriter, r *http.Request) {
  //定义模板
  //解析模板
  temp, err := template.ParseFiles("t1.tmpl", "t2.tmpl")
  if err != nil {
    fmt.Println("模板解析失败")
    return
  }
  //执行模板
  //搞个结构体吧
  u := &User{
    Id:   22,
    Name: "干饭小白",
  }
  temp.Execute(w, u)
}
func main() {
  http.HandleFunc("/temp", temHandler)
  http.ListenAndServe(":9090", nil)
}
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>干饭小白</title>
</head>
<body>
<h2>嵌套模板t2</h2>
<hr>
{{.Name}}
<!-- define嵌套  -->
<h3>define嵌套</h3>
{{template "t3.tmpl"}}
<hr>
<!-- 跨文件嵌套  -->
<h3>跨文件嵌套</h3>
{{template "t2.tmpl"}}
</body>
</html>
{{define "t3.tmpl"}}
<ol>
    <li>吃饭</li>
    <li>干饭</li>
    <li>睡觉</li>
</ol>
{{end}}
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>干饭小白</title>
</head>
<body>
   <P>
       我就喜欢干饭,哇哇哇哇
   </P>
</body>
</html>

14.block(用于买吧继承)

        定义一个根模板base.tmpl

package main
import (
  "fmt"
  "html/template"
  "net/http"
)
func blockHandle(w http.ResponseWriter, r *http.Request) {
  //定义模板
  //解析模板
  tem, err := template.ParseGlob(".//*.tmpl")
  if err != nil {
    fmt.Println("template.ParseFiles err=", err)
    return
  }
  //执行模板
  tem.ExecuteTemplate(w, "login.tmpl", "宠妻狂魔")
}
func main() {
  http.HandleFunc("/block", blockHandle)
  http.ListenAndServe(":9090", nil)
}
<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8">
        <title>干饭小白</title>
        <style>
            #dd{
                color: aqua;
            }
        </style>
    </head>
    <body>
    <h2>模板继承 父</h2>
    <div class="dd">
        {{block "con1" .}}{{end}}
    </div>
    </body>
</html>
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>干饭小白</title>
</head>
<body>
<h2>模板继承 子</h2>
<hr>
<div>
    {{template "base.tmpl"}}
    <div>
        {{define "con1"}}
            HELLO
        {{end}}
    </div>
</div>
</body>
</html>

15.修改默认的标识符{{ }}

            在实际的项目开发中,有时候会用到其它的一些框架,这时候可能会与{{}}冲突。

            GO提供了让我们直接定义标识符。《在解析模板之前可以定义》

template.New("test").Delims("{[", "]}").ParseFiles("./t.tmpl")

解析模板:

       方法1:直接使用默认的模板template

func (t *Template) Parse(src string) (*Template, error)
func ParseFiles(filenames ...string) (*Template, error)
func ParseGlob(pattern string) (*Template, error)

       方法2:创建自己的模板

               func New(name string) *Template

渲染模板:

       渲染模板就是用数据去填充模板的内容

func (t *Template) Execute(wr io.Writer, data interface{}) error
func (t *Template) ExecuteTemplate(wr io.Writer, name string, data interface{}) error
相关文章
|
2月前
|
JavaScript 前端开发 Java
通义灵码 Rules 库合集来了,覆盖Java、TypeScript、Python、Go、JavaScript 等
通义灵码新上的外挂 Project Rules 获得了开发者的一致好评:最小成本适配我的开发风格、相当把团队经验沉淀下来,是个很好功能……
865 103
|
1月前
|
Go
在golang中发起http请求以获取访问域名的ip地址实例(使用net, httptrace库)
这只是追踪我们的行程的简单方法,不过希望你跟着探险家的脚步,即使是在互联网的隧道中,也可以找到你想去的地方。接下来就是你的探险之旅了,祝你好运!
88 26
|
3月前
|
算法 测试技术 C语言
深入理解HTTP/2:nghttp2库源码解析及客户端实现示例
通过解析nghttp2库的源码和实现一个简单的HTTP/2客户端示例,本文详细介绍了HTTP/2的关键特性和nghttp2的核心实现。了解这些内容可以帮助开发者更好地理解HTTP/2协议,提高Web应用的性能和用户体验。对于实际开发中的应用,可以根据需要进一步优化和扩展代码,以满足具体需求。
352 29
|
3月前
|
Go 开发者
go-carbon v2.6.0 重大版本更新,轻量级、语义化、对开发者友好的 golang 时间处理库
carbon 是一个轻量级、语义化、对开发者友好的 Golang 时间处理库,提供了对时间穿越、时间差值、时间极值、时间判断、星座、星座、农历、儒略日 / 简化儒略日、波斯历 / 伊朗历的支持
85 3
|
4月前
|
网络协议 Linux Go
用 Go 基于 epoll 实现一个最小化的IO库
Go 语言社区中存在多个异步网络框架,如 evio、nbio、gnet 和 netpoll 等。这些框架旨在解决标准库 netpoll 的低效问题,如一个连接占用一个 goroutine 导致的资源浪费。easyio 是一个最小化的 IO 框架,核心代码不超过 500 行,仅实现 Linux 下的 epoll 和 TCP 协议。它通过 Worker Pool、Buffer 等优化提高了性能,并提供了简单的事件处理机制。
|
7月前
|
JSON Go 开发者
go-carbon v2.5.0 发布,轻量级、语义化、对开发者友好的 golang 时间处理库
carbon 是一个轻量级、语义化、对开发者友好的 Golang 时间处理库,提供了对时间穿越、时间差值、时间极值、时间判断、星座、星座、农历、儒略日 / 简化儒略日、波斯历 / 伊朗历的支持。
178 4
|
7月前
|
网络协议 安全 Go
Go语言进行网络编程可以通过**使用TCP/IP协议栈、并发模型、HTTP协议等**方式
【10月更文挑战第28天】Go语言进行网络编程可以通过**使用TCP/IP协议栈、并发模型、HTTP协议等**方式
134 13
|
7月前
|
存储 Cloud Native Shell
go库介绍:Golang中的Viper库
Viper 是 Golang 中的一个强大配置管理库,支持环境变量、命令行参数、远程配置等多种配置来源。本文详细介绍了 Viper 的核心特点、应用场景及使用方法,并通过示例展示了其强大功能。无论是简单的 CLI 工具还是复杂的分布式系统,Viper 都能提供优雅的配置管理方案。
180 6
|
7月前
|
JSON 安全 网络协议
go语言使用内置函数和标准库
【10月更文挑战第18天】
77 3
|
7月前
|
JSON 监控 安全
go语言选择合适的工具和库
【10月更文挑战第17天】
72 2