Add javadoc + native-image.properties

Signed-off-by: tvallin <thibault.vallin@oracle.com>

archetypes/helidon/src/main/archetype/common/common.xml

@@ -40,12 +40,16 @@
         <transformation id="multipart-mustache">
             <replace regex="\.multipart.mustache$" replacement=""/>
         </transformation>
-        <templates engine="mustache" transformations="mustache">
+        <transformation id="native-image">
+            <replace regex="groupid" replacement="${groupId/\./\/}"/>
+            <replace regex="artifactid" replacement="${artifactId/\./\/}"/>
+        </transformation>
+        <templates engine="mustache" transformations="mustache,packaged">
             <directory>files</directory>
             <includes>
                 <include>.helidon.mustache</include>
                 <include>README.md.mustache</include>
-                <include>src/main/java/*.java.mustache</include>
+                <include>src/main/java/**/*.java.mustache</include>
             </includes>
         </templates>
         <model>

archetypes/helidon/src/main/archetype/common/docker.xml

@@ -31,7 +31,16 @@
                          name="GraalVM Native Image Support"
                          description="Add a native-image capable Dockerfile to your project"
                          default="false"
-                         optional="true"/>
+                         optional="true">
+                    <output>
+                        <templates engine="mustache" transformations="mustache,native-image">
+                            <directory>files</directory>
+                            <includes>
+                                <include>src/*/resources/META-INF/**/*.mustache</include>
+                            </includes>
+                        </templates>
+                    </output>
+                </boolean>
                 <boolean id="jlink-image" name="JLink Support"
                          description="Add a JLink capable Dockerfile to your project"
                          default="false"

archetypes/helidon/src/main/archetype/common/extra.xml

@@ -110,9 +110,6 @@ java -cp "target/classes:target/libs/*" {{package}}.WebClientMain PORT
                             <list key="modules">
                                 <value if="${flavor} == 'mp'">io.helidon.microprofile.faulttolerance</value>
                             </list>
-                            <list key="Main-other-imports" if="${flavor} == 'mp'">
-                                <value>java.util.concurrent.TimeoutException</value>
-                            </list>
                             <list key="maven-plugins" if="${flavor} == 'mp'">
                                 <value><![CDATA[
             <plugin>

archetypes/helidon/src/main/archetype/common/files/src/main/resources/META-INF/groupid/artifactid/native-image.properties.mustache

@@ -0,0 +1 @@
+Args=--initialize-at-build-time={{package}}

archetypes/helidon/src/main/archetype/mp/common/common-mp.xml

@@ -84,24 +84,27 @@
             <value key="main-class-javadoc"><![CDATA[
 /**
  * Main entry point of the application.
- * This class is registered as the main class in the jar manifest, as well as the main class of the module.
- */
-            ]]></value>
+ * This class is required when using modules with Helidon MP.
+ * Since version 3.1.2, the maven-jar-plugin set module attribute such as `ModuleMainClass`. The main class must be
+ * in a package that is either exported or opened by the module. This means we cannot reference a built-in class and
+ * therefore this Main class is created with a simple implementation that calls the built-in one.
+ * See the Documentation for `--main-class` option used by maven-jar-plugin:
+ * <a href="https://docs.oracle.com/en/java/javase/21/docs/specs/man/jar.html#operation-modifiers-valid-only-in-create-and-update-modes">documentation</a>
+ */]]></value>
             <value key="main-method-javadoc"><![CDATA[
-/**
- * Main method. Starts CDI (and the application).
- *
- * @param args ignored
- */
-            ]]></value>
+    /**
+     * Main method. Starts CDI (and the application).
+     *
+     * @param args ignored
+     */]]></value>
             <list key="main-class-fields">
                 <value><![CDATA[
-/**
-* Cannot be instantiated.
-*/
-private Main() {
-}
-                    ]]></value>
+    /**
+    * Cannot be instantiated.
+    */
+    private Main() {
+    }
+]]></value>
             </list>
             <list key="main-method-content">
                 <value><![CDATA[        io.helidon.Main.main(args);]]></value>

archetypes/helidon/src/main/archetype/se/common/common-se.xml

@@ -94,20 +94,20 @@ app:
             </list>
             <value key="main-class-javadoc"><![CDATA[
 /**
-* The application main class.
-*/]]></value>
-            <value key="main-method-javadoc"><![CDATA[    /**
+ * The application main class.
+ */]]></value>
+            <value key="main-method-javadoc"><![CDATA[/**
      * Application main entry point.
      * @param args command line arguments.
      */]]></value>
             <list key="main-class-fields">
-                <value><![CDATA[
-/**
-* Cannot be instantiated.
-*/
-private Main() {
-}
-                    ]]></value>
+                <value order="0"><![CDATA[
+   /**
+     * Cannot be instantiated.
+     */
+   private Main() {
+   }
+]]></value>
             </list>
             <list key="main-method-content">
                 <value template="mustache"><![CDATA[
@@ -146,8 +146,7 @@ private Main() {
                {{#Main-routing-builder}}
                {{.}}{{#last}}; {{/last}}
                {{/Main-routing-builder}}
-    }
-                    ]]></value>
+    }]]></value>
             </list>
         </model>
     </output>