无法用Gin加载HTML模板

Question

我在通过r.HTMLRender设置使用Gin框架加载html模板时遇到了一些问题。

似乎没有找到模板。

我曾尝试使用以下的助理员：

• GinHTMLRender：https://gist.github.com/madhums/4340cbeb36871e227905
• EZ Gin模板：https://github.com/michelloworld/ez-gin-template

在设置模板的默认路径(在我的例子中是app/views)时，这两种方法似乎都不起作用；为了达到此目的，我的html模板文件结构如下所示：

/workspace
|-app
  |-views
    |-layouts
      |-application.html
    |-test.html

下面是Gin加载代码的示例：

import (
    "github.com/gin-contrib/location"
    "github.com/gin-gonic/gin"
    "fmt"
    "os"
    "github.com/gin-gonic/contrib/static"
    "github.com/michelloworld/ez-gin-template"
)

//CORSMiddleware ...
func CORSMiddleware() gin.HandlerFunc {
    /** CORS middleware **/
}

func Router() {

    if os.Getenv("ENVIRONMENT") == "production" {
        gin.SetMode(gin.ReleaseMode)
    }

    // Initialize Gin object
    r := gin.Default()

    // Cors Middleware
    r.Use(CORSMiddleware())

    // Rate limiting
    rl, err := helpers.RateLimiterMiddleware()
    if err != nil {
        panic("Rate Limiting Initialization error")
    }
    r.Use(rl)

    // Asset provision
    r.Use(static.ServeRoot("/public","app/assets"))

    // Get URL information
    r.Use(location.Default())

    // Attempt with EZ Template, fails
    // I ge this error: "runtime error: invalid memory address or nil pointer dereference" when calling c.HTML(...)
    render := eztemplate.New()
    render.TemplatesDir = "app/views/" // default
    render.Layout = "layouts/application"     // default
    render.Ext = ".html"               // default
    render.Debug = true               // default
    r.HTMLRender = render.Init()


    // Attempt with GinHTMLRender, fails
    // I get this error: https://gist.github.com/madhums/4340cbeb36871e227905#file-gin_html_render-go-L110
    /* 
    htmlRender := GinHTMLRender.New()
    htmlRender.TemplatesDir = "app/views/"
    htmlRender.Debug = gin.IsDebugging()
    htmlRender.Layout = "layouts/application"

    log.Println("Dir:"+htmlRender.TemplatesDir)

    r.HTMLRender = htmlRender.Create()*/

    /** Some Routes **/

    // Start web listener

    r.Run(":8009") // listen and serve on 0.0.0.0:8080
}

相应的呈现调用代码如下：

/* c is of type *gin.Context */
c.HTML(200, "test", "")

由于某些原因，r.HTMLRender函数似乎没有考虑到模板路径；我尝试过这样做：

_, err := template.ParseFiles("app/views/test.html")
if err != nil {
    log.Println("Template Error")
} else {
    log.Println("No Template Error")
}

这段代码始终显示“无模板错误”，这使我相信HTMLRender分配没有考虑TemplatesDir集变量。

我被这个问题困扰了一段时间，我不完全确定如何解决这个问题。

任何帮助，使这一工作将是非常感谢。

Answer 1

在做了一些进一步的研究之后，我发现了我的EZ模板问题的根源。

我希望这能帮助任何经历同样问题的人。

在深入研究了助手代码之后，我意识到模板匹配模式是严格的，不会递归地搜索文件；它需要一个特定的文件结构来查找模板文件：

在默认设置中，EZ模板需要以下文件结构才能工作：

/workspace
- app
  - views
    - layouts
      - some_layout.html
    - some_dir
      - template_file.html
      - _partial_template.html
    - partials
      - _some_other_partial.html

为了允许其他文件模式，需要修改辅助函数集。

在我的例子中，我在本地分叉了助手代码，以允许匹配第一级模板文件：

func (r Render) Init() Render {
    globalPartials := r.getGlobalPartials()

    layout := r.TemplatesDir + r.Layout + r.Ext

    // Match multiple levels of templates
    viewDirs, _ := filepath.Glob(r.TemplatesDir + "**" + string(os.PathSeparator) + "*" + r.Ext)
    // Added the following two lines to match for app/views/some_file.html as well as files on the **/*.html matching pattern
    tmp, _ := filepath.Glob(r.TemplatesDir + "*" + r.Ext)
    viewDirs = append(viewDirs, tmp...)
    // Can be extended by replicating those two lines above and adding search paths within the base template path.

    fullPartialDir := filepath.Join(r.TemplatesDir + r.PartialDir)
    for _, view := range viewDirs {
        templateFileName := filepath.Base(view)
        //skip partials
        if strings.Index(templateFileName, "_") != 0 && strings.Index(view, fullPartialDir) != 0 {
            localPartials := r.findPartials(filepath.Dir(view))

            renderName := r.getRenderName(view)
            if r.Debug {
                log.Printf("[GIN-debug] %-6s %-25s --> %s\n", "LOAD", view, renderName)
            }
            allFiles := []string{layout, view}
            allFiles = append(allFiles, globalPartials...)
            allFiles = append(allFiles, localPartials...)
            r.AddFromFiles(renderName, allFiles...)
        }
    }

    return r
}

我还没有在GinHTMLRenderer中尝试过类似的解决方案，但我预计这个问题可能与预期的文件结构有关。

Answer 2

还可以将模板绑定到代码中。jessevdk/go-assets builder将生成一个go文件，其中包含指定目录中的资产。确保生成的文件位于主包所在的位置。Gin还在他们的文档 获取更多信息中提供了一个例子。它还将在二进制文件中包括子文件夹及其文件(即资产)。

获得发电机工具：

go get github.com/jessevdk/go-assets-builder

产生：

# go-assets-builder <dir> -o <generated file name>
go-assets-builder app -o assets.go

注意，<generated file name>也可以像cmd/client/assets.go一样指定要生成的文件的目标。

加载模板：

package main

// ... imports

func main() {
    r := gin.New()

    t, err := loadTemplate()
    if err != nil {
        panic(err)
    }
    r.SetHTMLTemplate(t)

    r.GET("/", func(c *gin.Context) {
        c.HTML(http.StatusOK, "app/views/layouts/application.html", nil)
    })
    r.GET("/test", func(c *gin.Context) {
        c.HTML(http.StatusOK, "app/views/test.html", nil)
    })
    r.Run(":8080")
}

// loadTemplate loads templates embedded by go-assets-builder
func loadTemplate() (*template.Template, error) {
    t := template.New("")
    // Assets is the templates
    for name, file := range Assets.Files {
        if file.IsDir() || !strings.HasSuffix(name, ".html") {
            continue
        }
        h, err := ioutil.ReadAll(file)
        if err != nil {
            return nil, err
        }
        t, err = t.New(name).Parse(string(h))
        if err != nil {
            return nil, err
        }
    }
    return t, nil
}

Answer 3

我就是这样做的。它遍历目录并收集标记为模板后缀的文件，即.html &然后我只包含所有这些文件。我在任何地方都没有看到这个答案，所以我想我把它发出去了。

// START UP THE ROUTER
router := gin.Default()

var files []string
filepath.Walk("./views", func(path string, info os.FileInfo, err error) error {
    if strings.HasSuffix(path, ".html") {
        files = append(files, path)
    }
    return nil
})

router.LoadHTMLFiles(files...)

// SERVE STATICS
router.Use(static.Serve("/css", static.LocalFile("./css", true)))
router.Use(static.Serve("/js", static.LocalFile("./js", true)))
router.Use(static.Serve("/images", static.LocalFile("./images", true)))

routers.LoadBaseRoutes(router)
routers.LoadBlog(router)

router.Run(":8080")

现在它们不需要像其他建议那样被嵌套在精确的深度..。文件结构可能不均匀。