允许 Apache 的 FreeMarker 模板引擎从外部资源文件夹加载模板

Question

我使用 Spring Initilizr 创建了一个 Spring Boot 应用程序。然后我包含了Apache's Freemarker 模板引擎来从我的项目中加载模板。默认情况下，引擎从以下位置加载模板：src/main/resources/templates/ 文件夹。

当用户访问网页http://localhost:8080 时，我正在尝试加载一个简单的index.ftl 文件作为模板。但我需要从src/main/webapp/ 文件夹加载模板。每当我尝试从 resources 文件夹外部加载模板时，模板引擎都无法找到模板。

我已经阅读了各种教程和 Stack Overflow 问题。没有人回答我的问题，我被 404 ERROR 卡住了，因为引擎无法找到文件。

文件结构为：

|-src
|---main
|-----java
|-------MainApplication.java
|-------controllers
|---------ViewController.java
|-----resources
|-------static
|-------templates
|-------application.properties
|-----webapp
|-------index.ftl

经过大量挖掘，我发现了一篇帖子，他们建议更改模板引擎搜索文件的位置。它建议在 application.properties 中添加以下行：

spring.freemarker.enabled=true
spring.freemarker.template-loader-path=classpath:src/main/webapp/

这似乎根本不起作用。

当我访问http://localhost:8080 的网页时，我正在尝试解析简单的索引页面。我编写了以下代码来映射ViewController.java 中的 HTTP 请求：

@RequestMapping("/")
public ModelAndView home(Model model)
{
    return new ModelAndView("index");
}

不知道是我完全弄错了还是我错过了一些配置。

Answer 1

来自 Spring 文档：

如果您的应用程序是，请不要使用 src/main/webapp 目录 包装成罐子。虽然这个目录是一个通用标准，但它 仅适用于战争包装，并且被大多数人默默忽略 生成战争时构建工具。

src/main/webapp 与 web 存档相关联，并在您生成战争时由 maven war 插件打包。

假设您需要一个单独的位置来保存 ftl 模板，并且您仍想打包为 jar，您可以按照以下步骤操作。

在构建 pom 文件中添加资源条目，以便资源插件可以将该目录复制到类路径。

<build>
    <resources>
      <resource>
         <directory>src/main/webapp</directory>
     </resource>
    <resources>
<build>

将加载器路径更改为从类路径的ROOT读取。

spring.freemarker.template-loader-path=classpath:

如果它仅用于 ftl 模板，我会将目录更改为 src/main/ftls 以避免混淆并在资源中更新。

更新

我其实是想构建一个WAR部署包

你必须使用战争插件来构建战争。在 pom.xml 中添加插件并将包装更改为 war。

有关传统部署的更多信息：https://docs.spring.io/spring-boot/docs/current/reference/html/howto-traditional-deployment.html#howto-create-a-deployable-war-file

Answer 2

编辑

在嵌入式tomcat中，您可以在application-properties中定义静态资源路径

 spring.mvc.static-path-pattern=

如果你部署到tomcat，在tomcat中使用可以在server.xml里面定义static context可以保存freemarker文件，如

 <Context docBase="/home/stuff" path="/static" />

<Context> 元素被添加到 <Host> 元素中。 Context 有两个属性：docBase 是磁盘上包含您的静态文件的目录，path 是您要在其上提供文件的 URL。