feat: added ResourceExtractor that extracts resource files from deployed jar to local FS

Author: AlmasB

fxgl-core/src/main/kotlin/com/almasb/fxgl/core/util/ResourceExtractor.kt

@@ -0,0 +1,54 @@
+/*
+ * FXGL - JavaFX Game Library. The MIT License (MIT).
+ * Copyright (c) AlmasB ([email protected]).
+ * See LICENSE for details.
+ */
+
+package com.almasb.fxgl.core.util
+
+import com.almasb.fxgl.logging.Logger
+import java.net.URL
+import java.nio.file.Files
+import java.nio.file.Paths
+
+/**
+ * Extracts resources from the deployed jar to the local file system.
+ *
+ * @author Almas Baim (https://github.com/AlmasB)
+ */
+class ResourceExtractor {
+
+    companion object {
+
+        private val log = Logger.get(ResourceExtractor::class.java)
+
+        /**
+         * Extracts the file at jar [url] as a [relativeFilePath].
+         *
+         * @return the url on the local file system of the extracted file
+         */
+        @JvmStatic fun extract(url: URL, relativeFilePath: String): URL {
+            log.debug("Extracting $url as $relativeFilePath")
+
+            val file = Paths.get(System.getProperty("user.home"))
+                    .resolve(".openjfx")
+                    .resolve("cache")
+                    .resolve("fxgl-21")
+                    .resolve(relativeFilePath)
+
+            val fileParentDir = file.parent
+
+            if (Files.notExists(fileParentDir)) {
+                log.debug("Creating directories: $fileParentDir")
+
+                Files.createDirectories(fileParentDir)
+            }
+
+            url.openStream().use {
+                Files.copy(it, file)
+            }
+
+            return file.toUri().toURL()
+        }
+    }
+}

fxgl-intelligence/src/main/java/com/almasb/fxgl/intelligence/WebAPI.java

@@ -6,8 +6,14 @@
 
 package com.almasb.fxgl.intelligence;
 
+import com.almasb.fxgl.core.util.ResourceExtractor;
 import com.almasb.fxgl.logging.Logger;
 
+import java.net.URL;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
 /**
  * Stores constants related to web-api projects.
  * Changes to these values must be synchronized with the web-api project (https://github.com/AlmasB/web-api).
@@ -18,29 +24,49 @@ public final class WebAPI {
 
     private static final Logger log = Logger.get(WebAPI.class);
 
-    public static final String TEXT_TO_SPEECH_API = getURL("tts/index.html");
+    /**
+     * K - URL relative to resources/com.almasb.fxgl.intelligence in jar.
+     * V - absolute URL on the file system.
+     */
+    private static final Map<String, URL> URLS = extractURLs();
+
+    public static final URL TEXT_TO_SPEECH_API = URLS.get("tts/index.html");
     public static final String SPEECH_RECOGNITION_API = "https://almasb.github.io/web-api/speech-recog-v1/";
     public static final String GESTURE_RECOGNITION_API = "https://almasb.github.io/web-api/gesture-recog-v1/";
 
     public static final int TEXT_TO_SPEECH_PORT = 55550;
     public static final int SPEECH_RECOGNITION_PORT = 55555;
     public static final int GESTURE_RECOGNITION_PORT = 55560;
 
-    static {
-        log.debug("TTS API: " + TEXT_TO_SPEECH_API + ":" + TEXT_TO_SPEECH_PORT);
+    private static Map<String, URL> extractURLs() {
+        var map = new HashMap<String, URL>();
+
+        List.of(
+                "rpc-common.js",
+                "tts/index.html",
+                "tts/script.js"
+        ).forEach(relativeURL -> {
+            map.put(relativeURL, extractURL(relativeURL, "intelligence/" + relativeURL));
+        });
+
+        return map;
     }
 
-    private static String getURL(String relativeURL) {
+    private static URL extractURL(String relativeURL, String relateFilePath) {
         try {
-            var url = WebAPI.class.getResource(relativeURL).toExternalForm();
+            var url = WebAPI.class.getResource(relativeURL);
+
+            if (url == null) {
+                throw new IllegalArgumentException("URL is null: " + relativeURL);
+            }
 
-            if (url != null)
-                return url;
+            return ResourceExtractor.extract(url, relateFilePath);
 
         } catch (Exception e) {
             log.warning("Failed to get url: " + relativeURL, e);
         }
 
-        return "DUMMY_URL";
+        // TODO: github URLs, e.g. https://raw.githubusercontent.com/AlmasB/FXGL/dev/fxgl-intelligence/src/main/resources/com/almasb/fxgl/intelligence/rpc-common.js
+        throw new IllegalArgumentException("Failed to extract URL: " + relativeURL);
     }
 }