Fixes #4546 - Add ability to override default DataSource (#4614)

mnriem · web-flow · commit 2a963f90edfd · 2025-03-06T09:25:57.000-06:00
diff --git a/extension/datasource/pom.xml b/extension/datasource/pom.xml
@@ -72,4 +72,11 @@
             </plugin>            
         </plugins>
     </build>
+
+    <distributionManagement>
+        <site>
+            <id>default</id>
+            <url>file:///tmp/piranha/extension/datasource/</url>
+        </site>
+    </distributionManagement>        
 </project>
diff --git a/extension/datasource/src/site/markdown/index.md b/extension/datasource/src/site/markdown/index.md
@@ -0,0 +1,33 @@
+# Piranha DataSource Extension
+
+The DataSource extension delivers you with a default DataSource in a Piranha runtime.
+
+## Override the default DataSource using web.xml
+
+You override the default DataSource using the snippet below:
+
+```xml
+    <data-source>
+        <name>java:comp/DefaultDataSource</name>
+        <class-name>my.CustomDataSource</class-name>
+        <url>jdbc:custom://localhost:3306/mydb</url>
+        <user>myuser</user>
+        <password>mypassword</password>
+        <property>
+            <name>myProperty</name>
+            <value>myValue</value>
+        </property>
+    </data-source>
+```
+
+For runtimes that do not include the web.xml extension you will need to add it if you want
+to override the default DataSource as described above. You can do this by adding the
+following dependency to your pom.xml:
+
+```xml
+<dependency>
+    <groupId>cloud.piranha.extension</groupId>
+    <artifactId>piranha-extension-webxml</artifactId>
+    <version>${piranha.version}</version>
+</dependency>
+```
diff --git a/extension/datasource/src/site/site.xml b/extension/datasource/src/site/site.xml
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<project>
+    <body>
+        <menu name="Overview">
+            <item name="Introduction" href="index.html"/>
+        </menu>
+    </body>
+</project>
