java - 顶点网络 : where do I place webroot folder?

Question

这应该是一件容易的事，但到目前为止还不是很容易。我一直在使用 vert.x 2，最近切换到 vert.x 3。我想我会尝试一个简单的 vertx-web 示例，但无法通过简单的静态文件服务。

我的服务器类包含以下片段:

    HttpServer server = vertx.createHttpServer();
    Router router = ...;
    router.route("/static/*").handler(StaticHandler.create().setCachingEnabled(false));
    server.requestHandler(router::accept).listen(ctx.port);

我正在使用 Eclipse，但也一直在尝试从命令行运行 vertx。我也在使用 Maven。我有三个 webroot 文件夹，vert.x 一个也找不到:

myproject/webroot
myproject/src/main/resources/webroot
myproject/src/main/java/webroot

每个“webroot”都包含一个 index.html 和一个 css/base.css 文件。

第一个在我项目的根文件夹中。第二个在 Maven 资源文件夹中，第三个应该在我的 classpath 中。在我的 Eclipse 运行配置中，我将 myproject/src/main/resources/webroot 添加到类路径，并确保我的工作目录设置为“myproject”。从命令行运行时，我在 myproject 目录中，我的脚本如下所示:

JAVA_OPTS="-Dmyproject.port=8099" CLASSPATH="src/main/java:src/main/resources:target/dependencies/*:target/classes" vertx run com.my.MyProject

无论如何，当我尝试这些 URL 时，我总是得到 404:

http://localhost:8099
http://localhost:8099/
http://localhost:8099/index.html
http://localhost:8099/static/css/base.css

还有什么我需要做的吗？

Answer 1

我找到的解决方案取决于以下问题的答案:静态内容在运行时将位于何处，以及您希望 vertx 从何处提供它？

在我的例子中，安装的文件系统将是静态内容所在的位置(而不是在 jar 文件中)，我希望 vertx 从该位置提供它，以便它可以实时更新。因此，我通过设置 JVM 系统属性 vertx.disableFileCPResolving 禁用了 StaticHandler 中的类路径解析。至 true在顶点启动时。

然后我放置了 webroot jvm 启动目录下的文件夹。就我而言，我使用的是保证 jvm 的 cwd 的脚本。总是 <app-root>/bin , 所以删除 <app-root>/bin/webroot 中的内容足够了。如果你不能保证 jvm 将从哪里开始，它可能会更难，因为你可能需要将绝对路径传递给 StaticHandler.webroot() 指向这个固定位置，但我认为有一个悬而未决的问题关于对此的支持(参见 here)。

如果静态内容要打包成jar，就简单一点。您可以将“webroot”作为资源添加到 jar 中，并将所有感兴趣的内容放在那里。在这种情况下，您不想禁用类路径解析，因此要么设置 vertx.disableFileCPResolving至 false ，或者根本不设置它。现在当你运行 vertx , 它会找到 webroot在 jar 文件中并将其内容提取到 <cwd>/.vertx/.file-cache-<guid> (其中 cwd 是您启动 jvm 的地方)，并从那里提供内容。请注意，如果您打算能够对内容进行实时更新，这是不可行的，因为当 vertx 关闭时，对该目录下文件的任何更改都将丢失，因为 vertx-web将删除该目录。重新启动时，它将再次从 jar 资源中检索原始文件，并且更改将丢失。

无论如何，希望这对您有所帮助。