From 8a02715807fc779129ce004e51fc168657cd4180 Mon Sep 17 00:00:00 2001
From: Koen Aers <koen.aers@gmail.com>
Date: Wed, 28 May 2025 16:36:10 +0200
Subject: [PATCH] HBX-2984: Create Reference Guide for Ant   - Add a new
 example showing the use of the JPA configuration

Signed-off-by: Koen Aers <koen.aers@gmail.com>
---
 ant/docs/examples/common/included.xml         |  8 +++++
 ant/docs/examples/jpa/Foo.java                | 17 ++++++++++
 .../examples/jpa/META-INF/persistence.xml     | 24 ++++++++++++++
 ant/docs/examples/jpa/README.md               | 18 ++++++++++
 ant/docs/examples/jpa/build.xml               | 33 +++++++++++++++++++
 test/pom.xml                                  | 12 +++++--
 6 files changed, 110 insertions(+), 2 deletions(-)
 create mode 100644 ant/docs/examples/jpa/Foo.java
 create mode 100644 ant/docs/examples/jpa/META-INF/persistence.xml
 create mode 100644 ant/docs/examples/jpa/README.md
 create mode 100644 ant/docs/examples/jpa/build.xml

diff --git a/ant/docs/examples/common/included.xml b/ant/docs/examples/common/included.xml
index 6d1b811360..ca02661936 100644
--- a/ant/docs/examples/common/included.xml
+++ b/ant/docs/examples/common/included.xml
@@ -16,6 +16,7 @@
 <project name="common" xmlns:ivy="antlib:org.apache.ivy.ant">
 
     <property name="hibernate-tools.version" value="7.0.0.CR1"/>
+    <property name="javaee-api.version" value="8.0.1"/>
     <property name="jdbc-driver.org" value="com.h2database"/>
     <property name="jdbc-driver.module" value="h2"/>
     <property name="jdbc-driver.version" value="2.3.232"/>
@@ -26,6 +27,12 @@
             revision="${hibernate-tools.version}"
             pathid="hibernate-tools.path"
             inline="true"/>
+    <ivy:cachepath
+            organisation="javax"
+            module="javaee-api"
+            revision="${javaee-api.version}"
+            pathid="javaee-api.path"
+            inline="true"/>
     <ivy:cachepath
             organisation="${jdbc-driver.org}"
             module="${jdbc-driver.module}"
@@ -35,6 +42,7 @@
 
     <path id="classpath">
         <path refid="hibernate-tools.path"/>
+        <path refid="javaee-api.path"/>
         <path refid="jdbc-driver.path"/>
         <path location="."/>
     </path>
diff --git a/ant/docs/examples/jpa/Foo.java b/ant/docs/examples/jpa/Foo.java
new file mode 100644
index 0000000000..a6667c0628
--- /dev/null
+++ b/ant/docs/examples/jpa/Foo.java
@@ -0,0 +1,17 @@
+import jakarta.persistence.Entity;
+import jakarta.persistence.Id;
+
+@Entity
+public class Foo {
+
+    @Id
+    private int id;
+    private String bar;
+
+    public int getId() { return id; }
+    public void setId(int id) { this.id = id; }
+
+    public String getBar() { return bar;}
+    public void setBar(String bar) { this.bar = bar; }
+
+}
diff --git a/ant/docs/examples/jpa/META-INF/persistence.xml b/ant/docs/examples/jpa/META-INF/persistence.xml
new file mode 100644
index 0000000000..29236d021f
--- /dev/null
+++ b/ant/docs/examples/jpa/META-INF/persistence.xml
@@ -0,0 +1,24 @@
+<!--
+  ~ 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.
+  -->
+<persistence>
+    <persistence-unit name="bar">
+        <properties>
+            <property name="jakarta.persistence.jdbc.driver" value="org.h2.Driver" />
+            <property name="jakarta.persistence.jdbc.url" value="jdbc:h2:mem:" />
+        </properties>
+        <class>Foo</class>
+    </persistence-unit>
+</persistence>
\ No newline at end of file
diff --git a/ant/docs/examples/jpa/README.md b/ant/docs/examples/jpa/README.md
new file mode 100644
index 0000000000..71b3c53674
--- /dev/null
+++ b/ant/docs/examples/jpa/README.md
@@ -0,0 +1,18 @@
+<!--
+  ~ 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 Ant](https://ant.apache.org) installed
+  - Issue `ant` from a command-line window 
\ No newline at end of file
diff --git a/ant/docs/examples/jpa/build.xml b/ant/docs/examples/jpa/build.xml
new file mode 100644
index 0000000000..d284b47056
--- /dev/null
+++ b/ant/docs/examples/jpa/build.xml
@@ -0,0 +1,33 @@
+<!--
+  ~ 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.
+  -->
+<project name="jpa" default="reveng">
+
+  <!-- Include the 'hibernatetool' task definition from the file '../common/included.xml' -->
+  <include file="../common/included.xml"/>
+
+  <target name="reveng" depends="common.compile">
+    <hibernatetool destdir="generated">
+      <classpath location="."/>
+      <!-- JPA configuration read from 'META-INF/persistence.xml' -->
+      <jpaconfiguration persistenceunit="bar"/>
+      <!-- Export the DDL file as an example use of the JPA configuration above -->
+      <hbm2ddl outputfilename="bar.sql"/>
+    </hibernatetool>
+
+  </target>
+
+</project>
+
diff --git a/test/pom.xml b/test/pom.xml
index 5767827d4d..7ecdf72bf3 100644
--- a/test/pom.xml
+++ b/test/pom.xml
@@ -37,8 +37,16 @@
         <maven.deploy.skip>true</maven.deploy.skip>
         <maven.install.skip>true</maven.install.skip>
     </properties>
-    
- 	<profiles>
+    <dependencies>
+        <dependency>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter-api</artifactId>
+            <version>5.12.2</version>
+            <scope>compile</scope>
+        </dependency>
+    </dependencies>
+
+    <profiles>
      	<profile>
        		<id>all</id>
       		<modules>