Skip to content

Commit a0c5fe0

Browse files
committed
Update native configuration best practices for proxies
Follow up to quarkusio#38186 and quarkusio#38936
1 parent fc5df7c commit a0c5fe0

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

docs/src/main/asciidoc/writing-native-applications-tips.adoc

+5-5
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ will include:
6161

6262
If globs are not sufficiently precise for your use case and you need to rely on regular expressions, or if you prefer relying on the GraalVM infrastructure,
6363
you can also create a `resource-config.json` JSON file defining which resources should be included.
64-
Ideally this, and other native image configuration files, should be placed under the `src/main/resources/META-INF/native-image/<group-id>/<artifact-id>` folder.
64+
This, and other native image configuration files, should be placed under the `src/main/resources/META-INF/native-image/<group-id>/<artifact-id>` folder.
6565
This way they will be automatically parsed by the native build, without additional configuration.
6666

6767
[WARNING]
@@ -302,9 +302,9 @@ In such a situation, the error you might encounter is:
302302
com.oracle.svm.core.jdk.UnsupportedFeatureError: Proxy class defined by interfaces [interface org.apache.http.conn.HttpClientConnectionManager, interface org.apache.http.pool.ConnPoolControl, interface com.amazonaws.http.conn.Wrapped] not found. Generating proxy classes at runtime is not supported. Proxy classes need to be defined at image build time by specifying the list of interfaces that they implement. To define proxy classes use -H:DynamicProxyConfigurationFiles=<comma-separated-config-files> and -H:DynamicProxyConfigurationResources=<comma-separated-config-resources> options.
303303
----
304304

305-
Solving this issue requires adding the `-H:DynamicProxyConfigurationResources=<comma-separated-config-resources>` option and to provide a dynamic proxy configuration file.
306-
307-
For more information about the format of this file, see the link:https://www.graalvm.org/{graalvm-docs-version}/reference-manual/native-image/guides/configure-dynamic-proxies/[GraalVM Configure Dynamic Proxies Manually] guide.
305+
Solving this issue requires creating a `proxy-config.json` file under the `src/main/resources/META-INF/native-image/<group-id>/<artifact-id>` folder.
306+
This way the configuration will be automatically parsed by the native build, without additional configuration.
307+
For more information about the format of this file, see the link:https://www.graalvm.org/{graalvm-docs-version}/reference-manual/native-image/metadata/#dynamic-proxy-metadata-in-json[Dynamic Proxy Metadata in JSON] documentation.
308308

309309
[[modularity-benefits]]
310310
=== Modularity Benefits
@@ -581,7 +581,7 @@ For more information about GraalVM resource handling in native executables, see
581581
====
582582

583583

584-
== Delay class initialization
584+
=== Delay class initialization
585585

586586
Quarkus simplifies things by allowing extensions authors to simply register a `RuntimeInitializedClassBuildItem`. A simple example of doing so could be:
587587

0 commit comments

Comments
 (0)