HBX-2984: Create Reference Guide for Ant

ant/docs/examples/native/.gitignore

@@ -0,0 +1,19 @@
+############################################################################
+# Hibernate Tools, Tooling for your Hibernate Projects                     #
+#                                                                          #
+# 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.                                           #
+############################################################################
+generated-sources
+*.class

ant/docs/examples/native/Foo.hbm.xml

@@ -0,0 +1,6 @@
+<hibernate-mapping>
+    <class name="Foo">
+        <id name="id"/>
+        <property name="bar" type="string"/>
+    </class>
+</hibernate-mapping>

ant/docs/examples/native/Foo.java

@@ -0,0 +1,10 @@
+//
+// Source code recreated from a .class file by IntelliJ IDEA
+// (powered by FernFlower decompiler)
+//
+public class Foo {
+
+    public int id;
+    public String bar;
+
+}

ant/docs/examples/native/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 

ant/docs/examples/native/build.xml

@@ -0,0 +1,42 @@
+<!--
+  ~ 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="native" default="reveng">
+
+  <!-- Include the 'hibernatetool' task definition from the file '../common/included.xml' -->
+  <include file="../common/included.xml"/>
+
+  <target name="clean">
+    <!-- Delete the folder 'generated-sources' if it exists -->
+    <delete dir="generated-sources"/>
+    <delete file="Foo.class"/>
+  </target>
+
+  <target name="compile" depends="clean">
+    <!-- Compile the custom exporter 'HelloExporter' -->
+    <javac srcdir="." destdir="." classpathref="classpath"/>
+  </target>
+
+  <target name="reveng" depends="compile">
+    <hibernatetool destdir="generated-sources">
+      <classpath location="."/>
+      <!-- Native configuration read from 'hibernate.cfg.xml' -->
+      <configuration configurationfile="hibernate.cfg.xml"/>
+      <hbm2ddl outputfilename="foo.sql"/>
+    </hibernatetool>
+  </target>
+
+</project>
+

ant/docs/examples/native/hibernate.cfg.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE hibernate-configuration PUBLIC "-//Hibernate/Hibernate Configuration DTD 3.0//EN" "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
+<hibernate-configuration>
+    <session-factory>
+        <property name="hibernate.connection.driver_class">org.h2.Driver</property>
+        <property name="hibernate.connection.url">jdbc:h2:mem:</property>
+        <property name="hibernate.connection.username">sa</property>
+        <mapping resource="Foo.hbm.xml"/>
+    </session-factory>
+</hibernate-configuration>