Go每日一庫之quicktemplate的使用

更新時(shí)間：2021年07月05日 15:51:22 作者：darjun

quicktemplate快速、功能強(qiáng)大、易于使用的Go模板引擎。比html/模板快20倍，本文我們就詳細(xì)的介紹一下quicktemplate的具體使用，感興趣的可以了解一下

簡介

最近在整理我們項(xiàng)目代碼的時(shí)候，發(fā)現(xiàn)有很多活動(dòng)的代碼在結(jié)構(gòu)和提供的功能上都非常相似。為了方便今后的開發(fā)，我花了一點(diǎn)時(shí)間編寫了一個(gè)生成代碼框架的工具，最大程度地降低重復(fù)勞動(dòng)。代碼本身并不復(fù)雜，且與項(xiàng)目代碼關(guān)聯(lián)性較大，這里就不展開介紹了。在這個(gè)過程中，我發(fā)現(xiàn) Go 標(biāo)準(zhǔn)的模板庫text/template和html/template使用起來比較束手束腳，很不方便。我從 GitHub 了解到quicktemplate這個(gè)第三方模板庫，功能強(qiáng)大，語法簡單，使用方便。今天我們就來介紹一下quicktemplate。

快速使用

本文代碼使用 Go Modules。

先創(chuàng)建代碼目錄并初始化：

$ mkdir quicktemplate && cd quicktemplate
$ go mod init github.com/darjun/go-daily-lib/quicktemplate

quicktemplate會(huì)將我們編寫的模板代碼轉(zhuǎn)換為 Go 語言代碼。因此我們需要安裝quicktemplate包和一個(gè)名為qtc的編譯器：

$ go get -u github.com/valyala/quicktemplate
$ go get -u github.com/valyala/quicktemplate/qtc

首先，我們需要編寫quicktemplate格式的模板文件，模板文件默認(rèn)以.qtpl作為擴(kuò)展名。下面我編寫了一個(gè)簡單的模板文件greeting.qtpl：

All text outside function is treated as comments.

{% func Greeting(name string, count int) %}
  {% for i := 0; i < count; i++ %}
    Hello, {%s name %}
  {% endfor %}
{% endfunc %}

模板語法非常簡單，我們只需要簡單了解以下 2 點(diǎn)：

模板以函數(shù)為單位，函數(shù)可以接受任意類型和數(shù)量的參數(shù)，這些參數(shù)可以在函數(shù)中使用。所有函數(shù)外的文本都是注釋，qtc編譯時(shí)會(huì)忽視注釋；
函數(shù)內(nèi)的內(nèi)容，除了語法結(jié)構(gòu)，其他都會(huì)原樣輸出到渲染后的文本中，包括空格和換行。

將greeting.qtpl保存到templates目錄，然后執(zhí)行qtc命令。該命令會(huì)生成對應(yīng)的 Go 文件greeting.qtpl.go，包名為templates?，F(xiàn)在，我們就可以使用這個(gè)模板了：

package main

import (
  "fmt"

  "github.com/darjun/go-daily-lib/quicktemplate/get-started/templates"
)

func main() {
  fmt.Println(templates.Greeting("dj", 5))
}

調(diào)用模板函數(shù)，傳入?yún)?shù)，返回渲染后的文本：

$ go run .
    Hello, dj

    Hello, dj

    Hello, dj

    Hello, dj

    Hello, dj

{%s name %}執(zhí)行文本替換，{% for %}循環(huán)生成重復(fù)文本。輸出中出現(xiàn)多個(gè)空格和換行，這是因?yàn)楹瘮?shù)內(nèi)除了語法結(jié)構(gòu)，其他內(nèi)容都會(huì)原樣保留，包括空格和換行。

需要注意的是，由于quicktemplate是將模板轉(zhuǎn)換為 Go 代碼使用的，所以如果模板有修改，必須先執(zhí)行qtc命令重新生成 Go 代碼，否則修改不生效。

語法結(jié)構(gòu)

quicktemplate支持 Go 常見的語法結(jié)構(gòu)，if/for/func/import/return。而且寫法與直接寫 Go 代碼沒太大的區(qū)別，幾乎沒有學(xué)習(xí)成本。只是在模板中使用這些語法時(shí)，需要使用{%和%}包裹起來，而且if和for等需要添加endif/endfor明確表示結(jié)束。

變量

上面我們已經(jīng)看到如何渲染傳入的參數(shù)name，使用{%s name %}。由于name是 string 類型，所以在{%后使用s指定類型。quicktemplate還支持其他類型的值：

整型：{%d int %}，{%dl int64 %}，{%dul uint64 %}；
浮點(diǎn)數(shù)：{%f float %}。還可以設(shè)置輸出的精度，使用{%f.precision float %}。例如{%f.2 1.2345 %}輸出1.23；
字節(jié)切片（[]byte）：{%z bytes %}；
字符串：{%q str %}或字節(jié)切片：{%qz bytes %}，引號(hào)轉(zhuǎn)義為"；
字符串：{%j str %}或字節(jié)切片：{%jz bytes %}，沒有引號(hào)；
URL 編碼：{%u str %}，{%uz bytes %}；
{%v anything %}：輸出等同于fmt.Sprintf("%v", anything)。

先編寫模板：

{% func Types(a int, b float64, c []byte, d string) %}
  int: {%d a %}, float64: {%f.2 b %}, bytes: {%z c %}, string with quotes: {%q d %}, string without quotes: {%j d %}.
{% endfunc %}

然后使用：

func main() {
  fmt.Println(templates.Types(1, 5.75, []byte{'a', 'b', 'c'}, "hello"))
}

運(yùn)行：

$ go run .

int: 1, float64: 5.75, bytes: abc, string with quotes: "hello", string without quotes: hello.

調(diào)用函數(shù)

quicktemplate支持在模板中調(diào)用模板函數(shù)、標(biāo)準(zhǔn)庫的函數(shù)。由于qtc會(huì)直接生成 Go 代碼，我們甚至還可以在同目錄下編寫自己的函數(shù)給模板調(diào)用，模板 A 中也可以調(diào)用模板 B 中定義的函數(shù)。

我們先在templates目錄下編寫一個(gè)文件rank.go，定義一個(gè)Rank函數(shù)，傳入分?jǐn)?shù)，返回評級(jí)：

package templates

func Rank(score int) string {
  if score >= 90 {
    return "A"
  } else if score >= 80 {
    return "B"
  } else if score >= 70 {
    return "C"
  } else if score >= 60 {
    return "D"
  } else {
    return "E"
  }
}

然后我們可以在模板中調(diào)用這個(gè)函數(shù)：

{% import "fmt" %}
{% func ScoreList(name2score map[string]int) %}
  {% for name, score := range name2score %}
    {%s fmt.Sprintf("%s: score-%d rank-%s", name, score, Rank(score)) %}
  {% endfor %}
{% endfunc %}

編譯模板：

$ qtc

編寫程序：

func main() {
  name2score := make(map[string]int)
  name2score["dj"] = 85
  name2score["lizi"] = 96
  name2score["hjw"] = 52

  fmt.Println(templates.ScoreList(name2score))
}

運(yùn)行程序輸出：

$ go run .

    dj: score-85 rank-B

    lizi: score-96 rank-A

    hjw: score-52 rank-E

由于我們在模板中用到fmt包，需要先使用{% import %}將該包導(dǎo)入。

在模板中調(diào)用另一個(gè)模板的函數(shù)也是類似的，因?yàn)槟０遄罱K都會(huì)轉(zhuǎn)為 Go 代碼。Go 代碼中有同樣簽名的函數(shù)。

Web

quicktemplate常用來編寫 HTML 頁面的模板：

{% func Index(name string) %}
<html>
  <head>
    <title>Awesome Web</title>
  </head>
  <body>
    <h1>Hi, {%s name %}
    <p>Welcome to the awesome web!!!</p>
  </body>
</html>
{% endfunc %}

下面編寫一個(gè)簡單的 Web 服務(wù)器：

func index(w http.ResponseWriter, r *http.Request) {
  templates.WriteIndex(w, r.FormValue("name"))
}

func main() {
  mux := http.NewServeMux()
  mux.HandleFunc("/", index)

  server := &http.Server{
    Handler: mux,
    Addr:    ":8080",
  }

  log.Fatal(server.ListenAndServe())
}

qtc會(huì)生成一個(gè)Write*的方法，它接受一個(gè)io.Writer的參數(shù)。將模板渲染的結(jié)果寫入這個(gè)io.Writer中，我們可以直接將http.ResponseWriter作為參數(shù)傳入，非常便捷。

運(yùn)行：