使用Golang流行的web框架Gin渲染HTML模板页面的简单例子
Gin是Golang最流行的web框架之一。我之前已经写过如何使用Golang基础模板包渲染HTML页面。使用Gin渲染HTML模板更加简单。
为了使工作流更加顺畅，尝试新的想法并进行调试，我还决定使用Codegangsta的自动重载工具Gin。
安装Gin
安装Gin HTTP web框架就像安装大多数（如果不是所有）Golang包一样简单：
go get -u github.com/gin-gonic/gin
Gin 代码
package main
import (
"html/template"
"net/http"
"strings"
"github.com/gin-gonic/gin"
)
func main() {
router := gin.Default()
router.SetFuncMap(template.FuncMap{
"upper": strings.ToUpper,
})
router.Static("/assets", "./assets")
router.LoadHTMLGlob("templates/*.html")
router.GET("/", func(c *gin.Context) {
c.HTML(http.StatusOK, "index.html", gin.H{
"content": "This is an index page...",
})
})
router.GET("/about", func(c *gin.Context) {
c.HTML(http.StatusOK, "about.html", gin.H{
"content": "This is an about page...",
})
})
router.Run("localhost:8080")
}
引入的包
在第4到7行，我们引入了一些包：
- Gin HTTP web框架的包。
- Golang的
html/template基础包，用于引入FuncMap()函数。在模板中使用函数时需要此函数。 - 与Gin一起使用的Golang
net/http基础包。 -
strings基础包，用于FuncMap中的upper函数。
main()函数
在第11行，我们创建了一个名为router的默认Gin路由。默认的Gin路由使用日志和恢复中间件，以及基本功能。
在第12到14行，使用SetFuncMap()创建一个供模板使用的函数映射。这里我们添加了一个简单的模板函数upper，它使用strings.ToUpper()函数将字符串中的所有字符设置为大写。
在第15行，我们让Gin路由知道我们在./assets目录中保存了一些静态资产。Gin可以以这种方式访问任何静态资源。
在这个例子中，我在那个目录中放了一个Bulma CSS库的最小版本。通过使用Static()函数，现在HTML模板可以访问这个库。
在第16行，所有满足template/*.html模式的模板都由LoadHTMLGlob()函数加载。这个模式意味着模板文件应该有.html的扩展名，并且位于/template目录中。
在第18到22行，我们告诉Gin路由接受URL路径/上的HTTP GET方法请求。当收到请求时，Gin发送一个HTTP OK状态消息，并用gin.H{}括号内提供的数据渲染index.html模板。在这种情况下，数据只包括一个键/值对，键名为content。
在第24到28行，与上面类似，我们告诉Gin路由接受/about路径上的HTTP GET方法请求。这次渲染的是about.html模板。
在第29行，我们让Gin在localhost端口8080上运行web服务器。
模板和目录结构
下面你可以找到本例中使用的四个模板。这些模板每个都需要在自己的文件中。每段代码之前都有文件名。
模板的语法与html/template基础包中的相同。你可以我之前的文章中阅读更多关于模板语法的内容。
// header.html
{{define "header.html"}}
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" type="text/css" href="/assets/bulma.min.css">
<title></title>
</head>
<body>
<div class="container">
<br><br>
{{end}}
// footer.html
{{define "footer.html"}}
</div>
</body>
</html>
{{end}}
// index.html
{{template "header.html"}}
<h1 class="title">
INDEX PAGE
</h1>
<p>{{ .content }}</p>
{{template "footer.html"}}
// about.html
{{template "header.html"}}
<h1 class="title">
ABOUT PAGE
</h1>
<p>{{ .content | upper}}</p>
{{template "footer.html"}}
下面你也可以找到这个项目的目录结构：
自动重载Gin
如前所述，我在开发时使用codegangsta/gin工具来自动重载gin。这使得在浏览器中检查我们代码的结果变得更加容易。当我们改变了代码，无需停止当前的可执行文件，重新构建和运行它，就可以做到这一点。
以下是Github页面上对这个工具的描述：
gin是一个简单的命令行工具，用于实时重新加载Go web应用程序。只需在你的应用程序目录下运行gin，你的web应用就会以gin作为代理来服务。gin会在检测到更改时自动重新编译你的代码。下次它接收到HTTP请求时，你的应用将会重启。
安装codegangsta/gin
go get github.com/codegangsta/gin
运行codegangsta/gin
gin -i --appPort 8080 --port 3000 run main.go
上述代码需要在命令行中运行。它假设你正在localhost的8080端口上运行你的Go web应用，并且你将使用3000端口作为Gin自动重载代理。
关于运行代码的注意事项
在从命令行运行代码之前，你可能需要运行以下命令：
go mod init
go mod tidy
在网页浏览器中检查结果
在浏览器的URL字段中输入以下内容以检查代码的结果：
localhost:3000/
…对于索引页面，和…
localhost:3000/about
对于关于页面。
列表清单
请记住，始终保持学习的态度，并享受编码的乐趣！祝您编码愉快！
如果你喜欢我的文章，点赞，关注，转发！
