Merge pull request #988 from terrestris/update-keycloak

Include keycloak-js assets

Author: dnlkoch

pom.xml

@@ -102,6 +102,7 @@
     <jacoco-plugin.version>0.8.13</jacoco-plugin.version>
     <maven-project-info-reports-plugin.version>3.9.0</maven-project-info-reports-plugin.version>
     <jib-maven-plugin.version>3.4.6</jib-maven-plugin.version>
+    <exec-maven-plugin.version>3.1.0</exec-maven-plugin.version>
 
     <!-- Spring -->
     <spring-boot.version>3.5.5</spring-boot.version>
@@ -133,12 +134,14 @@
 
     <!-- GeoServer/Geodata -->
     <geoserver-manager.version>1.7.0</geoserver-manager.version>
+    <geotools.version>33.2</geotools.version>
 
     <!-- Utils -->
     <commons.io.version>2.20.0</commons.io.version>
     <tika.version>3.2.2</tika.version>
     <reflections.version>0.10.2</reflections.version>
     <evo-inflector.version>1.3</evo-inflector.version>
+    <commons-compress.version>1.28.0</commons-compress.version>
 
     <!-- Testing -->
     <maven-project-info-reports-plugin.version>3.9.0</maven-project-info-reports-plugin.version>
@@ -147,7 +150,10 @@
 
     <!-- Jib -->
     <image>docker-public.terrestris.de/shogun/${project.artifactId}:latest</image>
-    <geotools.version>33.2</geotools.version>
+
+    <!-- Frontend (Landing Page) -->
+    <bootstrap.version>5.1.1</bootstrap.version>
+    <fontawesome.version>5.15.4</fontawesome.version>
   </properties>
 
   <build>
@@ -501,6 +507,12 @@
         <version>${commons.io.version}</version>
       </dependency>
 
+      <dependency>
+        <groupId>org.apache.commons</groupId>
+        <artifactId>commons-compress</artifactId>
+        <version>${commons-compress.version}</version>
+      </dependency>
+
       <!-- Apache Tika -->
       <dependency>
         <groupId>org.apache.tika</groupId>

shogun-boot/pom.xml

@@ -161,6 +161,11 @@
       <groupId>org.geotools</groupId>
       <artifactId>gt-main</artifactId>
     </dependency>
+
+    <dependency>
+      <groupId>org.apache.commons</groupId>
+      <artifactId>commons-compress</artifactId>
+    </dependency>
   </dependencies>
 
   <build>
@@ -198,6 +203,58 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>exec-maven-plugin</artifactId>
+        <version>${exec-maven-plugin.version}</version>
+        <executions>
+          <execution>
+            <id>download-keycloak-js</id>
+            <phase>compile</phase>
+            <goals>
+              <goal>java</goal>
+            </goals>
+            <configuration>
+              <mainClass>de.terrestris.shogun.boot.util.ResourceDownloader</mainClass>
+              <arguments>
+                <argument>https://registry.npmjs.org/keycloak-js/-/keycloak-js-${keycloak.version}.tgz</argument>
+                <argument>${project.build.directory}/classes/public/assets/lib/keycloak</argument>
+              </arguments>
+              <classpathScope>compile</classpathScope>
+            </configuration>
+          </execution>
+          <execution>
+            <id>download-bootstrap</id>
+            <phase>compile</phase>
+            <goals>
+              <goal>java</goal>
+            </goals>
+            <configuration>
+              <mainClass>de.terrestris.shogun.boot.util.ResourceDownloader</mainClass>
+              <arguments>
+                <argument>https://registry.npmjs.org/bootstrap/-/bootstrap-${bootstrap.version}.tgz</argument>
+                <argument>${project.build.directory}/classes/public/assets/lib/bootstrap</argument>
+              </arguments>
+              <classpathScope>compile</classpathScope>
+            </configuration>
+          </execution>
+          <execution>
+            <id>download-fontawesome</id>
+            <phase>compile</phase>
+            <goals>
+              <goal>java</goal>
+            </goals>
+            <configuration>
+              <mainClass>de.terrestris.shogun.boot.util.ResourceDownloader</mainClass>
+              <arguments>
+                <argument>https://registry.npmjs.org/@fortawesome/fontawesome-free/-/fontawesome-free-${fontawesome.version}.tgz</argument>
+                <argument>${project.build.directory}/classes/public/assets/lib/fontawesome</argument>
+              </arguments>
+              <classpathScope>compile</classpathScope>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
       <plugin>
         <groupId>io.github.git-commit-id</groupId>
         <artifactId>git-commit-id-maven-plugin</artifactId>

shogun-boot/src/main/java/de/terrestris/shogun/boot/util/ResourceDownloader.java

@@ -0,0 +1,83 @@
+/* SHOGun, https://terrestris.github.io/shogun/
+ *
+ * Copyright © 2025-present terrestris GmbH & Co. KG
+ *
+ * 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
+ *
+ *   https://www.apache.org/licenses/LICENSE-2.0.txt
+ *
+ * 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.
+ */
+package de.terrestris.shogun.boot.util;
+
+import lombok.extern.log4j.Log4j2;
+import org.apache.commons.compress.archivers.ArchiveEntry;
+import org.apache.commons.compress.archivers.tar.TarArchiveInputStream;
+
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.nio.file.StandardCopyOption;
+import java.util.zip.GZIPInputStream;
+
+/**
+ * Utility class for downloading and extracting *.tar.gz resources from a given URL.
+ *
+ * It is currently designed to download resource assets (e.g. the Keycloak JS adapter) for the landing page during
+ * the project initialization only.
+ */
+@Log4j2
+public class ResourceDownloader {
+    public static void main(String[] args) throws IOException, URISyntaxException {
+        String fileUrl = args[0];
+        String extractPath = args[1];
+
+        ResourceDownloader.downloadAndExtract(fileUrl, extractPath);
+    }
+
+    public static void downloadAndExtract(String fileUrl, String extractPath) throws IOException, URISyntaxException {
+        log.info("Downloading file from URL: {}", fileUrl);
+
+        Path downloadedFile = Files.createTempDirectory("resource-downloader-");
+        try (InputStream in = new URI(fileUrl).toURL().openStream()) {
+            Files.copy(in, downloadedFile, StandardCopyOption.REPLACE_EXISTING);
+        }
+
+        log.info("Extracting archive contents to: {}", extractPath);
+
+        Path extractionDir = Paths.get(extractPath);
+        if (!Files.exists(extractionDir)) {
+            Files.createDirectories(extractionDir);
+        }
+
+        try (GZIPInputStream gzipInputStream = new GZIPInputStream(new FileInputStream(downloadedFile.toFile()));
+             TarArchiveInputStream tarInputStream = new TarArchiveInputStream(gzipInputStream)) {
+            ArchiveEntry entry;
+            while ((entry = tarInputStream.getNextEntry()) != null) {
+                log.info("Extracting file: {}", entry.getName());
+
+                Path outputFile = extractionDir.resolve(entry.getName());
+
+                if (entry.isDirectory()) {
+                    Files.createDirectories(outputFile);
+                } else {
+                    Files.createDirectories(outputFile.getParent());
+                    Files.copy(tarInputStream, outputFile, StandardCopyOption.REPLACE_EXISTING);
+                }
+            }
+        }
+
+        log.info("Successfully downloaded and extracted resources.");
+    }
+}