文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

Golang中quicktemplate库如何使用

2023-06-20 14:30

关注

Golang中quicktemplate库如何使用,相信很多没有经验的人对此束手无策,为此本文总结了问题出现的原因和解决方法,通过这篇文章希望你能解决这个问题。


先创建代码目录并初始化:

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

quicktemplate会将我们编写的模板代码转换为 Go 语言代码。因此我们需要安装quicktemplate包和一个名为qtc的编译器:

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

首先,我们需要编写quicktemplate格式的模板文件,模板文件默认以.qtpl作为扩展名。下面我编写了一个简单的模板文件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 点:

将greeting.qtpl保存到templates目录,然后执行qtc命令。该命令会生成对应的 Go 文件greeting.qtpl.go,包名为templates。现在,我们就可以使用这个模板了:

package mainimport (  "fmt"  "github.com/darjun/go-daily-lib/quicktemplate/get-started/templates")func main() {  fmt.Println(templates.Greeting("dj", 5))}

调用模板函数,传入参数,返回渲染后的文本:

$ go run .
    Hello, dj

    Hello, dj

    Hello, dj

    Hello, dj

    Hello, dj

{%s name %}执行文本替换,{% for %}循环生成重复文本。输出中出现多个空格和换行,这是因为函数内除了语法结构,其他内容都会原样保留,包括空格和换行。

需要注意的是,由于quicktemplate是将模板转换为 Go 代码使用的,所以如果模板有修改,必须先执行qtc命令重新生成 Go 代码,否则修改不生效。

语法结构

quicktemplate支持 Go 常见的语法结构,if/for/func/import/return。而且写法与直接写 Go 代码没太大的区别,几乎没有学习成本。只是在模板中使用这些语法时,需要使用{%和%}包裹起来,而且if和for等需要添加endif/endfor明确表示结束。

变量

上面我们已经看到如何渲染传入的参数name,使用{%s name %}。由于name是 string 类型,所以在{%后使用s指定类型。quicktemplate还支持其他类型的值:

先编写模板:

{% 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"))}

运行:

$ go run .

  int: 1, float64: 5.75, bytes: abc, string with quotes: &quot;hello&quot;, string without quotes: hello.

调用函数

quicktemplate支持在模板中调用模板函数、标准库的函数。由于qtc会直接生成 Go 代码,我们甚至还可以在同目录下编写自己的函数给模板调用,模板 A 中也可以调用模板 B 中定义的函数。

我们先在templates目录下编写一个文件rank.go,定义一个Rank函数,传入分数,返回评级:

package templatesfunc 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"  }}

然后我们可以在模板中调用这个函数:

{% 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))}

运行程序输出:

$ go run .

    dj: score-85 rank-B

    lizi: score-96 rank-A

    hjw: score-52 rank-E

由于我们在模板中用到fmt包,需要先使用{% import %}将该包导入。

在模板中调用另一个模板的函数也是类似的,因为模板最终都会转为 Go 代码。Go 代码中有同样签名的函数。

Web

quicktemplate常用来编写 HTML 页面的模板:

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

下面编写一个简单的 Web 服务器

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会生成一个Write*的方法,它接受一个io.Writer的参数。将模板渲染的结果写入这个io.Writer中,我们可以直接将http.ResponseWriter作为参数传入,非常便捷。

运行:

$ qtc
$ go run .

浏览器输入localhost:8080?name=dj查看结果。

总结

quicktemplate至少有下面 3 个优势:

看完上述内容,你们掌握Golang中quicktemplate库如何使用的方法了吗?如果还想学到更多技能或想了解更多相关内容,欢迎关注编程网行业资讯频道,感谢各位的阅读!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯