如何访问 Quarkus 原生镜像中的资源？

Question

我开始玩 quarkus 和 graalvm。我将文件（txt 和 jpg）添加到项目中的资源中 (

src/main/resources/

)。为了确保我可以在控制器中访问该文件，我显示了它的大小：

URL url = Thread.currentThread().getContextClassLoader().getResource("/Resource2.txt");
File file = new File(url.toURI());
return "Hello My Friend! File size in bytes = " + file.length();

当我用 maven (

mvn quarkus:dev

) 运行它时它就可以工作了。控制器代码在这里。

当我创建本机 Quarkus 应用程序并尝试在 docker 内运行时出现问题。为了确保该文件包含在本机图像中，我添加了一个大 jpg 文件 (3.3MB)，创建了

resources-config.json

:

{ "resources": 
 { "includes": [
        { "pattern": "IMG_3_3M\\.jpg$"},
        { "pattern": "Resources2\\.txt$"}
       ]
}}

并在

application.properties

中添加：

quarkus.native.additional-build-args = -H:ResourceConfigurationFiles=resources-config.json

。原生跑步者尺寸增加自：

39M Mar 21 12:48 hello-quarkus-1.0-SNAPSHOT-runner

致：

44M Mar 21 12:19 hello-quarkus-1.0-SNAPSHOT-runner

所以我假设包含了 jpg 文件，但是当在 docker 镜像内运行本机应用程序时，我得到了 NPE：

 Caused by: java.lang.NullPointerException
  at it.tostao.quickstart.GreetingResource.hello(GreetingResource.java:24)

第 24 行：是

url.toURI()

。

知道如何读取本机图像中的资源吗？配置中是否缺少某些内容？

这里是重现问题的示例图像，构建和运行本机图像所需的所有命令都可以在 README.MD:

中找到

https://github.com/sleski/hello-quarkus

到目前为止，我检查了这个网址，但仍然无法在本机图像中找到资源：

• 如何在 Quarkus 本机映像中包含类路径资源？

• 如何读取Quarkus原生镜像中的类路径资源？

• https://quarkus.io/guides/writing-native-applications-tips

• 从 Docker 容器中的 maven Quarkus 项目上的资源文件夹中读取 txt 文件

Answer 1

首先修复json

{
    "resources": [
      {
        "pattern": "Resource2.txt"
      }
    ]
}

或者您可以将 *.txt 作为模式。就像在doc

中一样

https://github.com/oracle/graal/blob/master/docs/reference-manual/native-image/Resources.md说使用

InputStream resource = ModuleLayer.boot().findModule(moduleName).getResourceAsStream(resourcePath);

当我尝试时遇到了问题。您可以在下面看到您项目的工作代码

@Path("/hello")
public class GreetingResource {


    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() throws IOException {
        String moduleName = "java.base";
        String resourcePath = "/Resource2.txt";
        Module resource = ModuleLayer.boot().findModule(moduleName).get();
        InputStream ins = resource.getResourceAsStream(resourcePath);
        if (ins == null) {
            System.out.println("module came empty, now trying to load from GreetingResource");
            ins = GreetingResource.class.getResourceAsStream(resourcePath);
        }
        if (ins != null) {
            StringBuilder sb = new StringBuilder();
            for (int ch; (ch = ins.read()) != -1; ) {
                sb.append((char) ch);
            }
            return "Hello My Friend! File size in bytes = " + sb;
        }
        return "empty";
    }

}

GreetingResource.class.getResourceAsStream(resourcePath);

其实就是把资源带到这里来的。我认为这个功能将来可能会改变，所以我也在代码中留下了 ModuleLayer 。我用的是 graalvm 17-21.3.0

您可以在下面找到构建日志

[INFO] [io.quarkus.deployment.pkg.steps.NativeImageBuildRunner] C:\Program Files\GraalVM\graalvm-ce-java17-21.3.0\bin\native-image.cmd -J-Dsun.nio.ch.maxUpdateArraySize=100 -J-Djava.util.logging.manager=org.jboss.logmanager.LogManager -J-Dvertx.logger-delegate-factory-class-name=io.quarkus.vertx.core.runtime.VertxLogDelegateFactory -J-Dvertx.disableDnsResolver=true -J-Dio.netty.leakDetection.level=DISABLED -J-Dio.netty.allocator.maxOrder=3 -J-Duser.language=en -J-Duser.country=GB -J-Dfile.encoding=UTF-8 -H:-ParseOnce -J--add-exports=java.security.jgss/sun.security.krb5=ALL-UNNAMED -J--add-opens=java.base/java.text=ALL-UNNAMED -H:ResourceConfigurationFiles=resources-config.json -H:+PrintAnalysisCallTree -H:Log=registerResource:verbose -H:InitialCollectionPolicy=com.oracle.svm.core.genscavenge.CollectionPolicy\$BySpaceAndTime -H:+JNI -H:+AllowFoldMethods -J-Djava.awt.headless=true -H:FallbackThreshold=0 -H:+ReportExceptionStackTraces -H:-AddAllCharsets -H:EnableURLProtocols=http -H:-UseServiceLoaderFeature -H:+StackTrace -J--add-exports=java.management/sun.management=ALL-UNNAMED hello-quarkus-1.0-SNAPSHOT-runner -jar hello-quarkus-1.0-SNAPSHOT-runner.jar
[hello-quarkus-1.0-SNAPSHOT-runner:20428]    classlist:   2,920.35 ms,  0.94 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]        (cap):   1,493.84 ms,  0.94 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]        setup:   2,871.07 ms,  0.94 GB
[Use -Dgraal.LogFile=<path> to redirect Graal log output to a file.]
[thread:1] scope: main
  [thread:1] scope: main.registerResource
  ResourcesFeature: registerResource: Resource2.txt
14:23:38,709 INFO  [org.jbo.threads] JBoss Threads version 3.4.2.Final
  [thread:1] scope: main.registerResource
  ResourcesFeature: registerResource: java/lang/uniName.dat
[hello-quarkus-1.0-SNAPSHOT-runner:20428]     (clinit):     475.20 ms,  5.14 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]   (typeflow):   2,931.83 ms,  5.14 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]    (objects):  24,294.27 ms,  5.14 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]   (features):   2,979.07 ms,  5.14 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]     analysis:  32,083.24 ms,  5.14 GB
# Printing call tree to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\call_tree_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142406.txt
# Printing list of used methods to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\used_methods_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142407.txt
# Printing list of used classes to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\used_classes_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142407.txt
# Printing list of used packages to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\used_packages_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142407.txt
# Printing call tree for vm entry point to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_vm_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
# Printing call tree for methods to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_methods_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
# Printing call tree for virtual methods to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_virtual_methods_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
# Printing call tree for entry points to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_entry_points_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
# Printing call tree for direct edges to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_direct_edges_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
# Printing call tree for overriden by edges to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_override_by_edges_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
# Printing call tree for virtual edges to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\reports\csv_call_tree_virtual_edges_hello-quarkus-1.0-SNAPSHOT-runner_20220324_142408.csv
[hello-quarkus-1.0-SNAPSHOT-runner:20428]     universe:   1,547.28 ms,  5.14 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]      (parse):   4,919.32 ms,  4.87 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]     (inline):   7,013.78 ms,  5.83 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]    (compile):  27,387.04 ms,  5.56 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]      compile:  41,595.59 ms,  5.56 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]        image:   2,515.22 ms,  5.56 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]        write:     858.79 ms,  5.56 GB
[hello-quarkus-1.0-SNAPSHOT-runner:20428]      [total]:  90,068.97 ms,  5.56 GB
# Printing build artifacts to: C:\Users\ozkan\tmp\hello-quarkus\target\hello-quarkus-1.0-SNAPSHOT-native-image-source-jar\hello-quarkus-1.0-SNAPSHOT-runner.build_artifacts.txt
[INFO] [io.quarkus.deployment.QuarkusAugmentor] Quarkus augmentation completed in 94323ms
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:37 min
[INFO] Finished at: 2022-03-24T14:24:56Z
[INFO] ------------------------------------------------------------------------

Answer 2

这就是我解决问题的方法 - 更改的示例位于此分支中：https://github.com/sleski/hello-quarkus/tree/solution_for_native

说明：

图像位于：

src/main/resources/images

，名称为：

IMG_3_3M.jpg

。在

application.properties

中我添加了

images.location

变量：

images.location=src/main/resources/images/
%prod.images.location=/work/images/

在 java 控制器中我添加了：

@ConfigProperty(name = "images.location")
String imageLocation;

在

docker.native

中添加：

COPY target/classes/images/*.jpg /work/images/

当我使用

querkus:dev

启动应用程序时，它会从

src/main/resources/images

获取图像，当我运行 narive 图像时：

/work/images

。

在这两种情况下都有效：

File size is = 3412177

。

Answer 3

另一种答案是让 Quarkus 为您完成工作。

根据HTTP参考：

要从应用程序 jar 提供静态资源，您必须放置它们位于应用程序的 META-INF/resources 目录中。这选择位置是因为它是资源的标准位置 Servlet 规范定义的 jar 文件。尽管夸库斯可以不使用 Servlet，遵循此约定允许现有代码将其资源放置在这个位置才能正常运行。

和编写本机应用程序的技巧：

默认情况下，构建本机可执行文件时，GraalVM 不会将类路径上的任何资源包含到本机中它创建的可执行文件。本应成为一部分的资源本机可执行文件需要显式配置。

Quarkus 自动包含以下资源 META-INF/resources（网络资源）但是，在此目录之外，你只能靠自己了。

所以，所有资源都进去了

src/main/resources/META-INF/resources/

，你就可以像普通资源一样加载它们了：

java.util.Properties p = new Properties();

try (InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream("META-INF/resources/my-runtime.properties")) {
    if (is != null) {
        p.load(is);
    }
} catch (IOException ex) {
    Log.error(ex);
}

遵循此约定可以让您避免使用 GraalVM 特定的配置和选项。

如何访问 Quarkus 原生镜像中的资源？

问题描述投票：0回答：3

3个回答

最新问题

如何访问 Quarkus 原生镜像中的资源？

问题描述 投票：0回答：3

3个回答

最新问题

问题描述投票：0回答：3