HBX-2984: Create Reference Guide for Ant

  - Add use of 'propertyfile' attribute and 'fileset' element to the 'native' example

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

Author: koentsje

ant/docs/examples/native/build.xml

@@ -22,9 +22,14 @@
     <hibernatetool destdir="generated">
       <classpath location="."/>
       <!-- Native configuration read from 'hibernate.cfg.xml' -->
-      <configuration configurationfile="hibernate.cfg.xml"/>
+      <configuration
+              configurationfile="hibernate.cfg.xml"
+              propertyfile="hibernate.properties">
+        <fileset file="Foo.hbm.xml"/>
+      </configuration>
       <hbm2ddl outputfilename="foo.sql"/>
     </hibernatetool>
+
   </target>
 
 </project>

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

@@ -1,10 +1,25 @@
 <?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">
+<!--
+  ~ 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.
+  -->
+<!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"/>
+        <property name="hibernate.connection.url">url_to_be_overridden_in_hibernate_properties</property>
     </session-factory>
 </hibernate-configuration>

ant/docs/examples/native/hibernate.properties

@@ -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.                                           #
+############################################################################
+hibernate.connection.url=jdbc:h2:mem:
+