Ratpack + Thymeleaf + shadowJar - 解析模板时出错 "home"，模板可能不存在或可能无法访问

Question

我正在开发 ratpack.io 网络应用程序并使用 gradle 作为构建工具。模板从 src/main/thymeleaf 目录中的模板文件呈现，在运行时运行良好（仅使用 gradle run）。

$ ls ./src/main/thymeleaf
home.html

我在创建 uber jar 时运行遇到了问题，其中不包含模板文件。当我打开输出 jar 文件时，我看到 thymeleaf 目录是空的。

我知道 shadow-jar 过程的一部分是将所有依赖项合并到一个 jar 中，但我不确定我需要做什么，包括模板文件。我尝试创建特殊规则以包含 html 文件，但我最终只在 jar 中获得 html 文件，甚至没有来自 thymeleaf 目录的文件。

我需要配置什么才能获得此 uber jar 中包含的模板文件？
如果我确实获得了包含在 jar 模板目录中的文件，我是否需要更新模板解析器以从 jar 与当前工作目录中提取文件？

Answer 1

您将模板文件保存在 src/main/thymeleaf 中有什么原因吗？默认情况下，Thymeleaf 模板应存储在 src/ratpack/thymeleaf 目录中。

ThymeleafModule class 定义一个存放所有模板的文件夹名称。默认值为 thymeleaf，当您创建 shadowJar 时，您应该在 JAR 存档中找到一个文件夹 thymeleaf。 shadowJar 毫无问题地将 src/ratpack/thymeleaf 复制到此目的地。

默认情况下，基于

Java 的 Ratpack 项目不知道 src/ratpack，但您可以通过在 src/ratpack 中创建一个名为 .ratpack 的空文件并配置来轻松配置它server -> server.findBaseDir()（下面有更详细的示例）。

这是一个简单的例子：

build.gradle

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath "io.ratpack:ratpack-gradle:1.5.4"
        classpath "com.github.jengelman.gradle.plugins:shadow:1.2.4"
    }
}

apply plugin: "io.ratpack.ratpack-java"
apply plugin: "com.github.johnrengelman.shadow"
apply plugin: "idea"
apply plugin: "eclipse"

mainClassName = 'app.RatpackApp'

repositories {
    jcenter()
}

dependencies {
    // Default SLF4J binding.  Note that this is a blocking implementation.
    // See here for a non blocking appender http://logging.apache.org/log4j/2.x/manual/async.html
    runtime 'org.slf4j:slf4j-simple:1.7.25'

    compile ratpack.dependency('thymeleaf')
    compile ratpack.dependency('guice')

    testCompile "org.spockframework:spock-core:1.0-groovy-2.4"
}

src/main/java/app/RatpackApp.java

package app;

import ratpack.guice.Guice;
import ratpack.server.BaseDir;
import ratpack.server.RatpackServer;
import ratpack.thymeleaf.ThymeleafModule;

import java.util.HashMap;

import static ratpack.thymeleaf.Template.thymeleafTemplate;

public final class RatpackApp {

    public static void main(String[] args) throws Exception {

        RatpackServer.start(server ->
                server.serverConfig(config -> config.findBaseDir())
                        .registry(Guice.registry(bindings -> bindings.module(ThymeleafModule.class)))
                        .handlers(chain -> chain.get(ctx -> ctx.render(thymeleafTemplate(new HashMap<String, Object>() {{
                            put("title", "Hello, Ratpack!");
                            put("header", "Hello, Ratpack!");
                            put("text", "This template got rendered using Thymeleaf");
                        }}, "home"))))
        );
    }
}

src/ratpack/thymeleaf/home.html

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org">
<head>
    <title th:text="${title}" />
</head>
<body>
    <h1 th:text="${header}"></h1>
    <p th:text="${text}" />
</body>
</html>

Remember to create an empty file .ratpack in src/ratpack so Ratpack can discover this location as a files base dir.

现在，在使用 gradle shadowJar 创建最终 JAR 后，我可以看到模板文件被正确复制：

ratpack-thymeleaf-example [master●●] % unzip -l build/libs/ratpack-thymeleaf-example-all.jar | grep home
      232  06-24-2018 10:12   thymeleaf/home.html

在这里你可以找到完整的例子 - https://github.com/wololock/ratpack-thymeleaf-example

Ratpack + Thymeleaf + shadowJar - 解析模板时出错 "home"，模板可能不存在或可能无法访问

Ratpack + Thymeleaf + shadowJar - Error resolving template "home", template might not exist or might not be accessible

gradle

groovy

thymeleaf

ratpack

shadowjar