HBX-3128: Avoid use of Maven invoker plugin while performing functional testing

     - Add the 'hbm2java/template-path' example

Signed-off-by: Koen Aers <[email protected]>

Author: koentsje

maven/docs/examples/hbm2java/template-path/README.md

@@ -16,6 +16,9 @@
 To run this example:
   - Have [Apache Maven](https://maven.apache.org) installed
   - Have [H2 Sakila database](https://github.com/hibernate/sakila-h2) running
+  - Remove the backslash `\` in the occurence of `\${basedir}` (the backslash is needed for the
+    tests to run correctly). You can do this from the command-line:
+    `sed -i.bak 's/\\${basedir}/${basedir}/' pom.xml && rm pom.xml.bak`
   - Issue the following commands from a command-line window opened in this folder:
     `mvn generate-sources -Dh2.version=${h2.version} -Dhibernate.version=${hibernate.version}`
 

maven/docs/examples/hbm2java/template-path/pom.xml

@@ -47,7 +47,7 @@
                     </execution>
                 </executions>
                 <configuration>
-                    <templatePath>templates</templatePath>
+                    <templatePath>\${basedir}/templates</templatePath>
                 </configuration>
             </plugin>
         </plugins>

maven/docs/examples/hbm2java/use-generics/README.md

@@ -0,0 +1,21 @@
+<!--
+  ~ Copyright 2004 - 2025 Red Hat, Inc.
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     http://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" basis,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+To run this example:
+  - Have [Apache Maven](https://maven.apache.org) installed
+  - Have [H2 Sakila database](https://github.com/hibernate/sakila-h2) running
+  - Issue the following commands from a command-line window opened in this folder:
+    `mvn generate-sources -Dh2.version=${h2.version} -Dhibernate.version=${hibernate.version}`
+  

maven/pom.xml

@@ -245,10 +245,7 @@
                   </includes>
                 </resource>
               </resources>
-              <delimiters>
-                <delimiter>${h2.version}</delimiter>
-                <delimiter>${hibernate.version}</delimiter>
-              </delimiters>
+              <escapeString>${basedir}</escapeString>
             </configuration>
           </execution>
         </executions>