[GR-54953] Option -H:Preserve=all that preserves all classes and reflection metadata from a module, a package, or a classpath entry.

[graalvmbot]

This PR introduces a flag -H:Preserve that preserves all classes, resources and reflection metadata from module, class-path entry, or a package in the image. This will allow users to more easily support third-party libraries and get more user-friendly experience with Native Image.

The flag can be used in following ways:

1. -H:Preserve=all preserves all elements from the JDK, the classpath, and the module path
2. -H:Preserve=module=<module> preserves all elements from a given module
3. -H:Preserve=module=ALL-UNNAMED preserves all elements from all class-path entries
4. -H:Preserve=package=<package> preserves all elements from a given package
5. -H:Preserve=package=<package-wildcard> preserves all elements from packages captured by the wildcard. For example, -H:Preserve=package=my.app.*.
6. -H:Preserve=path=<cp-entry> preserves all elements from a given class-path entry
7. A combination of any of the previous uses, for example, -H:Preserve=path=<cp-entry>,module=<module>,package=<package>

-H:Preserve is only allowed on the native-image command line and cannot be embedded in the native-image.properties files.

Usages

1. Internal: We want to test the reflection implementation. Already useful as it found 5+ bugs and performance issues.
2. Internal/Framework: Want to test that the JDK/Framework works no matter what the user registers for reflection.
3. End User: i) Wants to obfuscate his library or make it standalone without providing reflection (especially interesting for AWT and JFX. ii) Wants to run his project and use an unsupported library. iii) Doesn't want to provide metadata for the test cases of his project.

Performance Impact of -H:Preserve=module=ALL-UNNAMED

1. Binary Size grows between 2x-3x without JDK modules being included.
2. Performance drops by roughly 10% in microservices wihtout PGO.
3. Time to first response grows proportionally to the image size by 10%-30%.
4. Max RSS is increased for a factor proportional to the image size (roughly 5%-10% of the image size).

Performance Impact of -H:Preserve=all

Performance impact is similar to -H:Preserve=module=ALL-UNNAMED, but the images are significantly larger.

"Hello, World!" on Linux with -Ob (JDK included):

$ native-image HelloWorld -Ob -H:Preserve=all
$ du -h ./helloworld
  283M    ./helloworld
$ time ./helloworld
Hello, World!
________________________________________________________
Executed in   34.94 millis    fish           external
  usr time   13.05 millis    0.00 micros   13.05 millis
  sys time   22.27 millis  510.00 micros   21.75 millis

Dangers

1. The whole community could use this option and make performance worse.
2. The usage of this option will slow down reachability metadata adoption.

Review

The entry point for review is the SubstrateOptions file where all the options are defined. Once the bugs are fixed, all reflection-related changes will be moved to a separate PR and back ported.