135-1821-9792

GolangGinWeb框架7-静态文件/模板渲染

简介

本文接着上文(Golang GinWeb框架6-绑定请求字符串/URI/请求头/复选框/表单类型)继续探索GinWeb框架

静态文件服务

 
 
 
 
    
  
  
  
  
  1. package main
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. import (
    4. 
  
  
  
  
  4.   "github.com/gin-gonic/gin"
    5. 
  
  
  
  
  5.   "log"
    6. 
  
  
  
  
  6.   "net/http"
    7. 
  
  
  
  
  7.   "os"
    8. 
  
  
  
  
  8. )
    9. 
  
  
  
  
  9. 
  
  
  
  
  10. func main() {
    11. 
  
  
  
  
  11.   router := gin.Default()
    12. 
  
  
  
  
  12.   cwd, _ := os.Getwd()  //获取当前文件目录
    13. 
  
  
  
  
  13.   log.Printf("当前项目路径:%s", cwd)
    14. 
  
  
  
  
  14.   router.Static("/static", cwd) //提供静态文件服务器, 第一个参数为相对路径,第二个参数为根路径, 这个路径一般放置css,js,fonts等静态文件,前端html中采用/static/js/xxx或/static/css/xxx等相对路径的方式引用
    15. 
  
  
  
  
  15.   router.StaticFS("/more_static", http.Dir("./")) //将本地文件树结构映射到前端, 通过浏览器可以访问本地文件系统, 模拟访问:http://localhost:8080/more_static
    16. 
  
  
  
  
  16.   router.StaticFile("/logo.png", "./resources/logo.png")  //StaticFile提供单静态单文件服务, 模拟访问:http://localhost:8080/log.png
    17. 
  
  
  
  
  17. 
  
  
  
  
  18.   // Listen and serve on 0.0.0.0:8080
    19. 
  
  
  
  
  19.   router.Run(":8080")
    20. 
  
  
  
  
  20. }
    21.

返回文件数据

 
 
 
 
    
  
  
  
  
  1. package main
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. import (
    4. 
  
  
  
  
  4.   "github.com/gin-contrib/cors"
    5. 
  
  
  
  
  5.   "github.com/gin-gonic/gin"
    6. 
  
  
  
  
  6.   "net/http"
    7. 
  
  
  
  
  7. )
    8. 
  
  
  
  
  8. 
  
  
  
  
  9. func main() {
    10. 
  
  
  
  
  10.   router := gin.Default()
    11. 
  
  
  
  
  11.   router.Use(cors.Default())
    12. 
  
  
  
  
  12. 
  
  
  
  
  13.   router.GET("/local/file", func(c *gin.Context) {
    14. 
  
  
  
  
  14.     c.File("./main.go")
    15. 
  
  
  
  
  15.   })
    16. 
  
  
  
  
  16. 
  
  
  
  
  17. 
  
  
  
  
  18.   // A FileSystem implements access to a collection of named files.
    19. 
  
  
  
  
  19.   // The elements in a file path are separated by slash ('/', U+002F)
    20. 
  
  
  
  
  20.   // characters, regardless of host operating system convention.
    21. 
  
  
  
  
  21.   // FileSystem接口, 要求实现文件的访问的方法, 提供文件访问服务根路径的HTTP处理器
    22. 
  
  
  
  
  22.   var fs http.FileSystem = http.Dir("./")  //将本地目录作为文件服务根路径
    23. 
  
  
  
  
  23.   router.GET("/fs/file", func(c *gin.Context) {
    24. 
  
  
  
  
  24.     c.FileFromFS("main.go", fs)  //将文件服务系统下的文件数据返回
    25. 
  
  
  
  
  25.   })
    26. 
  
  
  
  
  26.   router.Run(":8080")
    27. 
  
  
  
  
  27. }
    28. 
  
  
  
  
  28. /*
    29. 
  
  
  
  
  29. 模拟访问文件数据:
    30. 
  
  
  
  
  30. curl http://localhost:8080/local/file
    31. 
  
  
  
  
  31. 
  
  
  
  
  32. 模拟访问文件系统下的文件数据:
    33. 
  
  
  
  
  33. curl http://localhost:8080/fs/file
    34. 
  
  
  
  
  34. */
    35.

用文件读出器提供文件数据服务

 
 
 
 
    
  
  
  
  
  1. package main
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. import (
    4. 
  
  
  
  
  4.   "github.com/gin-gonic/gin"
    5. 
  
  
  
  
  5.   "net/http"
    6. 
  
  
  
  
  6. )
    7. 
  
  
  
  
  7. 
  
  
  
  
  8. func main() {
    9. 
  
  
  
  
  9.   router := gin.Default()
    10. 
  
  
  
  
  10.   router.GET("/someDataFromReader", func(c *gin.Context) {
    11. 
  
  
  
  
  11.     response, err := http.Get("https://raw.githubusercontent.com/gin-gonic/logo/master/color.png")
    12. 
  
  
  
  
  12.     if err != nil || response.StatusCode != http.StatusOK {  //请求链接中的文件出现错误时, 直接返回服务不可用
    13. 
  
  
  
  
  13.       c.Status(http.StatusServiceUnavailable)
    14. 
  
  
  
  
  14.       return
    15. 
  
  
  
  
  15.     }
    16. 
  
  
  
  
  16. 
  
  
  
  
  17.     reader := response.Body  //用响应体内容构造一个文件读出器
    18. 
  
  
  
  
  18.     defer reader.Close()
    19. 
  
  
  
  
  19.     contentLength := response.ContentLength
    20. 
  
  
  
  
  20.     contentType := response.Header.Get("Content-Type")
    21. 
  
  
  
  
  21. 
  
  
  
  
  22.     extraHeaders := map[string]string{
    23. 
  
  
  
  
  23.       "Content-Disposition": `attachment; filename="gopher.png"`,
    24. 
  
  
  
  
  24.     }
    25. 
  
  
  
  
  25.     // DataFromReader writes the specified reader into the body stream and updates the HTTP code.
    26. 
  
  
  
  
  26.     // func (c *Context) DataFromReader(code int, contentLength int64, contentType string, reader io.Reader, extraHeaders map[string]string) {}
    27. 
  
  
  
  
  27.     // DataFromReader方法将指定的读出器reader中的内容, 写入http响应体流中, 并更新响应码, 响应头信息等
    28. 
  
  
  
  
  28.     c.DataFromReader(http.StatusOK, contentLength, contentType, reader, extraHeaders)
    29. 
  
  
  
  
  29.   })
    30. 
  
  
  
  
  30.   router.Run(":8080")
    31. 
  
  
  
  
  31. }
    32. 
  
  
  
  
  32. /*
    33. 
  
  
  
  
  33. 模拟访问:
    34. 
  
  
  
  
  34. curl http://localhost:8080/someDataFromReader
    35. 
  
  
  
  
  35. */
    36.

HTML渲染

使用LoadHTMLGlob()方法或LoadHTMLFiles()方法

 
 
 
 
    
  
  
  
  
  1. package main
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. import (
    4. 
  
  
  
  
  4.   "github.com/gin-gonic/gin"
    5. 
  
  
  
  
  5.   "net/http"
    6. 
  
  
  
  
  6. )
    7. 
  
  
  
  
  7. 
  
  
  
  
  8. func main() {
    9. 
  
  
  
  
  9.   router := gin.Default()
    10. 
  
  
  
  
  10.   //LoadHTMLGlob方法以glob模式加载匹配的HTML文件, 并与HTML渲染器结合
    11. 
  
  
  
  
  11.   router.LoadHTMLGlob("templates/*")
    12. 
  
  
  
  
  12.   //router.LoadHTMLFiles("templates/template1.html", "templates/template2.html")
    13. 
  
  
  
  
  13.   router.GET("/index", func(c *gin.Context) {
    14. 
  
  
  
  
  14.     //HTML方法设置响应码, 模板文件名, 渲染替换模板中的值, 设置响应内容类型Content-Type "text/html"
    15. 
  
  
  
  
  15.     c.HTML(http.StatusOK, "index.tmpl", gin.H{
    16. 
  
  
  
  
  16.       "title": "Main website",
    17. 
  
  
  
  
  17.     })
    18. 
  
  
  
  
  18.   })
    19. 
  
  
  
  
  19.   router.Run(":8080")
    20. 
  
  
  
  
  20. }
    21. 
  
  
  
  
  21. /*
    22. 
  
  
  
  
  22. 模拟测试:
    23. 
  
  
  
  
  23. curl http://localhost:8080/index
    24. 
  
  
  
  
  24. */
    25.

增加模板文件, templates/index.tmpl

 
 
 
 
    
  
  
  
  
  1. 
  
  
  
  
  2.   
    3. 
  
  
  
  
  3.     {{ .title }}
    4. 
  
  
  
  
  4.   
    5. 
  
  
  
  
  5.

 使用不同文件夹下的相同文件名的模板文件

 
 
 
 
    
  
  
  
  
  1. func main() {
    2. 
  
  
  
  
  2.   router := gin.Default()
    3. 
  
  
  
  
  3.   router.LoadHTMLGlob("templates/**/*")
    4. 
  
  
  
  
  4.   router.GET("/posts/index", func(c *gin.Context) {
    5. 
  
  
  
  
  5.     c.HTML(http.StatusOK, "posts/index.tmpl", gin.H{
    6. 
  
  
  
  
  6.       "title": "Posts",
    7. 
  
  
  
  
  7.     })
    8. 
  
  
  
  
  8.   })
    9. 
  
  
  
  
  9.   router.GET("/users/index", func(c *gin.Context) {
    10. 
  
  
  
  
  10.     c.HTML(http.StatusOK, "users/index.tmpl", gin.H{
    11. 
  
  
  
  
  11.       "title": "Users",
    12. 
  
  
  
  
  12.     })
    13. 
  
  
  
  
  13.   })
    14. 
  
  
  
  
  14.   router.Run(":8080")
    15. 
  
  
  
  
  15. }
    16.

posts目录下添加模板文件, templates/posts/index.tmpl

 
 
 
 
    
  
  
  
  
  1. {{ define "posts/index.tmpl" }}
    2. 
  
  
  
  
    3. 
  
  
  
  
  3.   {{ .title }}
    4. 
  
  
  
  
  4. 
  
  
  
  
  5. Using posts/index.tmpl
    6. 
  
  
  
  
  6. 
  
  
  
  
  7. {{ end }}
    8.

 users目录下添加模板文件, templates/users/index.tmpl

 
 
 
 
    
  
  
  
  
  1. {{ define "users/index.tmpl" }}
    2. 
  
  
  
  
    3. 
  
  
  
  
  3.   {{ .title }}
    4. 
  
  
  
  
  4. 
  
  
  
  
  5. Using users/index.tmpl
    6. 
  
  
  
  
  6. 
  
  
  
  
  7. {{ end }}
    8.

 自定义模板渲染器

你也可以使用你自定义的HTML模板渲染器, 需要自定义模板文件file1, file2等

 
 
 
 
    
  
  
  
  
  1. package main
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. import (
    4. 
  
  
  
  
  4.   "github.com/gin-gonic/gin"
    5. 
  
  
  
  
  5.   "html/template"
    6. 
  
  
  
  
  6.   "net/http"
    7. 
  
  
  
  
  7. )
    8. 
  
  
  
  
  8. 
  
  
  
  
  9. func main() {
    10. 
  
  
  
  
  10.   router := gin.Default()
    11. 
  
  
  
  
  11.   //template.ParseFiles(文件1,文件2...)创建一个模板对象, 然后解析一组模板，使用文件名作为模板的名字
    12. 
  
  
  
  
  12.   // Must方法将模板和错误进行包裹, 返回模板的内存地址 一般用于变量初始化,比如:var t = template.Must(template.New("name").Parse("html"))
    13. 
  
  
  
  
  13.   html := template.Must(template.ParseFiles("file1", "file2"))
    14. 
  
  
  
  
  14.   router.SetHTMLTemplate(html) //关联模板和HTML渲染器
    15. 
  
  
  
  
  15. 
  
  
  
  
  16.   router.GET("/index", func(c *gin.Context) {
    17. 
  
  
  
  
  17.     //HTML方法设置响应码, 模板文件名, 渲染替换模板中的值, 设置响应内容类型Content-Type "text/html"
    18. 
  
  
  
  
  18.     c.HTML(http.StatusOK, "file1", gin.H{
    19. 
  
  
  
  
  19.       "title": "Main website",
    20. 
  
  
  
  
  20.     })
    21. 
  
  
  
  
  21.   })
    22. 
  
  
  
  
  22.   router.Run(":8080")
    23. 
  
  
  
  
  23. }
    24.

自定义分隔符

你可以自定义分隔符, 模板中默认的分隔符是{{ }}, 我们也可以修改, 比如下面增加一对中括号

 
 
 
 
    
  
  
  
  
  1. r := gin.Default()
    2. 
  
  
  
  
  2. r.Delims("{[{", "}]}")
    3. 
  
  
  
  
  3. r.LoadHTMLGlob("/path/to/templates")
    4.

自定义模板方法

详见 示例代码.

模板中与后端都定义好模板方法, 模板渲染时执行该方法, 类似过滤器方法, 比如时间格式化操作

 
 
 
 
    
  
  
  
  
  1. package main
    2. 
  
  
  
  
  2. 
  
  
  
  
  3. import (
    4. 
  
  
  
  
  4.   "fmt"
    5. 
  
  
  
  
  5.   "html/template"
    6. 
  
  
  
  
  6.   "net/http"
    7. 
  
  
  
  
  7.   "time"
    8. 
  
  
  
  
  8. 
  
  
  
  
  9.   "github.com/gin-gonic/gin"
    10. 
  
  
  
  
  10. )
    11. 
  
  
  
  
  11. 
  
  
  
  
  12. func formatAsDate(t time.Time) string {
    13. 
  
  
  
  
  13.   year, month, day := t.Date()  //Date方法返回年,月,日
    14. 
  
  
  
  
  14.   return fmt.Sprintf("%d%02d/%02d", year, month, day)  //格式化时间
    15. 
  
  
  
  
  15. }
    16. 
  
  
  
  
  16. 
  
  
  
  
  17. func main() {
    18. 
  
  
  
  
  18.   router := gin.Default()
    19. 
  
  
  
  
  19.   router.Delims("{[{", "}]}") //自定义模板中的左右分隔符
    20. 
  
  
  
  
  20.   //SetFuncMap方法用给定的template.FuncMap设置到Gin引擎上, 后面模板渲染时会调用同名方法
    21. 
  
  
  
  
  21.   //FuncMap是一个map,键名关联方法名, 键值关联方法, 每个方法必须返回一个值, 或者返回两个值,其中第二个是error类型
    22. 
  
  
  
  
  22.   router.SetFuncMap(template.FuncMap{
    23. 
  
  
  
  
  23.     "formatAsDate": formatAsDate,
    24. 
  
  
  
  
  24.   })
    25. 
  
  
  
  
  25.   router.LoadHTMLFiles("./testdata/template/raw.tmpl") //加载单个模板文件并与HTML渲染器关联
    26. 
  
  
  
  
  26. 
  
  
  
  
  27.   router.GET("/raw", func(c *gin.Context) {
    28. 
  
  
  
  
  28.     c.HTML(http.StatusOK, "raw.tmpl", gin.H{
    29. 
  
  
  
  
  29.       "now": time.Date(2017, 07, 01, 0, 0, 0, 0, time.UTC),
    30. 
  
  
  
  
  30.     })
    31. 
  
  
  
  
  31.   })
    32. 
  
  
  
  
  32. 
  
  
  
  
  33.   router.Run(":8080")
    34. 
  
  
  
  
  34. }
    35. 
  
  
  
  
  35. 
  
  
  
  
  36. /*
    37. 
  
  
  
  
  37. 模拟测试:
    38. 
  
  
  
  
  38. curl http://localhost:8080/raw
    39. 
  
  
  
  
  39. */
    40.

定义模板文件: raw.tmpl

 
 
 
 
    
  
  
  
  
  1. Date: {[{.now | formatAsDate}]}
    2.

时间格式化结果:

 
 
 
 
    
  
  
  
  
  1. Date: 2017/07/01
    2.

多个模板

Gin默认只使用一个html.Template模板引擎, 也可以参考多模板渲染器使用类似Go1.6的块级模板block template功能.

模板相关详情请参考官方template包

参考文档

Gin官方仓库:https://github.com/gin-gonic/gin


网站名称：GolangGinWeb框架7-静态文件/模板渲染
本文路径：http://wtcwzsj.com/article/dhippjo.html

其他资讯


关于我们
我们的服务
网站建设案例
新闻动态
联系我们

135-1821-9792

公司服务热线
友情链接： 简阳机房托管   香港空间腾讯云   白乌鱼   资中网站设计   免备案虚拟主机   h5页面制作   简阳服务器托管   橡塑保温管   关键词优化   龙泉网站建设   

Copyright © 2009-2022 www.wtcwzsj.com 青羊区广皓图文设计工作室（个体工商户） 版权所有　蜀ICP备19037934号