From 83d668b0a99511c5db0fe009d80383a5dfe6d5af Mon Sep 17 00:00:00 2001
From: guqing <38999863+guqing@users.noreply.github.com>
Date: Tue, 14 Jun 2022 23:38:12 +0800
Subject: [PATCH] feat: add plugin unstructured resource loader (#2154)

* feat: add plugin unstructured resource loader

* feat: add test unit case
---
 .../halo/app/plugin/HaloPluginManager.java    |   2 -
 ...nInitializationLoadOnApplicationReady.java |  27 ++++++
 .../PluginUnstructuredResourceLoader.java     |  86 ++++++++++++++++++
 .../PluginUnstructuredResourceLoaderTest.java |  36 ++++++++
 .../test-unstructured-resource-loader.jar     | Bin 0 -> 16472 bytes
 5 files changed, 149 insertions(+), 2 deletions(-)
 create mode 100644 src/main/java/run/halo/app/plugin/PluginInitializationLoadOnApplicationReady.java
 create mode 100644 src/main/java/run/halo/app/plugin/PluginUnstructuredResourceLoader.java
 create mode 100644 src/test/java/run/halo/app/plugin/PluginUnstructuredResourceLoaderTest.java
 create mode 100644 src/test/resources/plugin/test-unstructured-resource-loader.jar

diff --git a/src/main/java/run/halo/app/plugin/HaloPluginManager.java b/src/main/java/run/halo/app/plugin/HaloPluginManager.java
index 642d48737..ad0773dae 100644
--- a/src/main/java/run/halo/app/plugin/HaloPluginManager.java
+++ b/src/main/java/run/halo/app/plugin/HaloPluginManager.java
@@ -82,8 +82,6 @@ public class HaloPluginManager extends DefaultPluginManager
 
     @Override
     public void afterPropertiesSet() {
-        // This method load, start plugins and inject extensions in Spring
-        loadPlugins();
         this.pluginApplicationInitializer = new PluginApplicationInitializer(this);
 
         this.requestMappingManager =
diff --git a/src/main/java/run/halo/app/plugin/PluginInitializationLoadOnApplicationReady.java b/src/main/java/run/halo/app/plugin/PluginInitializationLoadOnApplicationReady.java
new file mode 100644
index 000000000..e3c6092f4
--- /dev/null
+++ b/src/main/java/run/halo/app/plugin/PluginInitializationLoadOnApplicationReady.java
@@ -0,0 +1,27 @@
+package run.halo.app.plugin;
+
+import org.springframework.boot.context.event.ApplicationReadyEvent;
+import org.springframework.context.ApplicationListener;
+import org.springframework.stereotype.Component;
+
+/**
+ * Load plugins after application ready.
+ *
+ * @author guqing
+ * @since 2.0.0
+ */
+@Component
+public class PluginInitializationLoadOnApplicationReady
+    implements ApplicationListener<ApplicationReadyEvent> {
+
+    private final HaloPluginManager haloPluginManager;
+
+    public PluginInitializationLoadOnApplicationReady(HaloPluginManager haloPluginManager) {
+        this.haloPluginManager = haloPluginManager;
+    }
+
+    @Override
+    public void onApplicationEvent(ApplicationReadyEvent event) {
+        haloPluginManager.loadPlugins();
+    }
+}
diff --git a/src/main/java/run/halo/app/plugin/PluginUnstructuredResourceLoader.java b/src/main/java/run/halo/app/plugin/PluginUnstructuredResourceLoader.java
new file mode 100644
index 000000000..2a72b19a6
--- /dev/null
+++ b/src/main/java/run/halo/app/plugin/PluginUnstructuredResourceLoader.java
@@ -0,0 +1,86 @@
+package run.halo.app.plugin;
+
+import java.io.IOException;
+import java.nio.file.Path;
+import java.util.List;
+import java.util.jar.JarFile;
+import java.util.zip.ZipEntry;
+import org.pf4j.PluginRuntimeException;
+import org.pf4j.PluginWrapper;
+import org.springframework.core.io.DefaultResourceLoader;
+import org.springframework.core.io.Resource;
+import org.springframework.lang.NonNull;
+import run.halo.app.extension.Unstructured;
+import run.halo.app.infra.utils.YamlUnstructuredLoader;
+
+/**
+ * Plug in unstructured data loader.
+ * TODO Rename this class to an appropriate name.
+ *
+ * @author guqing
+ * @see YamlUnstructuredLoader
+ * @see PluginWrapper
+ * @see DefaultResourceLoader
+ * @since 2.0.0
+ */
+public class PluginUnstructuredResourceLoader {
+    private static final String DEFAULT_RESOURCE_LOCATION = "extensions/";
+    private final String resourceLocation;
+
+    public PluginUnstructuredResourceLoader() {
+        resourceLocation = DEFAULT_RESOURCE_LOCATION;
+    }
+
+    public PluginUnstructuredResourceLoader(String resourceLocation) {
+        this.resourceLocation = resourceLocation;
+    }
+
+    /**
+     * Loading unstructured yaml configuration files in plugins.
+     *
+     * @param pluginWrapper Wrapper object holding plugin data
+     * @return a collection of {@link Unstructured} data(never null)
+     */
+    @NonNull
+    public List<Unstructured> loadUnstructured(PluginWrapper pluginWrapper) {
+        List<String> unstructuredFilePaths =
+            getUnstructuredFilePathFromJar(pluginWrapper.getPluginPath());
+
+        DefaultResourceLoader resourceLoader =
+            new DefaultResourceLoader(pluginWrapper.getPluginClassLoader());
+        Resource[] resources = unstructuredFilePaths.stream()
+            .map(resourceLoader::getResource)
+            .filter(Resource::exists)
+            .toArray(Resource[]::new);
+
+        YamlUnstructuredLoader yamlUnstructuredLoader = new YamlUnstructuredLoader(resources);
+        return yamlUnstructuredLoader.load();
+    }
+
+    /**
+     * <p>Lists the path of the unstructured yaml configuration file from the plugin jar.</p>
+     *
+     * @param jarPath plugin jar path
+     * @return Unstructured file paths relative to plugin classpath
+     * @throws PluginRuntimeException If loading the file fails
+     */
+    public List<String> getUnstructuredFilePathFromJar(Path jarPath) {
+        try (JarFile jarFile = new JarFile(jarPath.toFile())) {
+            return jarFile.stream()
+                .filter(jarEntry -> {
+                    String name = jarEntry.getName();
+                    return name.startsWith(resourceLocation)
+                        && !jarEntry.isDirectory()
+                        && isYamlFile(name);
+                })
+                .map(ZipEntry::getName)
+                .toList();
+        } catch (IOException e) {
+            throw new PluginRuntimeException(e);
+        }
+    }
+
+    private boolean isYamlFile(String path) {
+        return path.endsWith(".yaml") || path.endsWith(".yml");
+    }
+}
diff --git a/src/test/java/run/halo/app/plugin/PluginUnstructuredResourceLoaderTest.java b/src/test/java/run/halo/app/plugin/PluginUnstructuredResourceLoaderTest.java
new file mode 100644
index 000000000..ec3e2f2e5
--- /dev/null
+++ b/src/test/java/run/halo/app/plugin/PluginUnstructuredResourceLoaderTest.java
@@ -0,0 +1,36 @@
+package run.halo.app.plugin;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+import java.io.File;
+import java.io.FileNotFoundException;
+import java.util.List;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.util.ResourceUtils;
+
+/**
+ * Tests for {@link PluginUnstructuredResourceLoader}.
+ *
+ * @author guqing
+ * @since 2.0.0
+ */
+class PluginUnstructuredResourceLoaderTest {
+
+    private PluginUnstructuredResourceLoader unstructuredResourceLoader;
+
+    @BeforeEach
+    void setUp() {
+        unstructuredResourceLoader = new PluginUnstructuredResourceLoader();
+    }
+
+    @Test
+    void getUnstructuredFilePathFromJar() throws FileNotFoundException {
+        File file = ResourceUtils.getFile("classpath:plugin/test-unstructured-resource-loader.jar");
+        List<String> unstructuredFilePathFromJar =
+            unstructuredResourceLoader.getUnstructuredFilePathFromJar(file.toPath());
+        assertThat(unstructuredFilePathFromJar).hasSize(3);
+        assertThat(unstructuredFilePathFromJar).contains("extensions/roles.yaml",
+            "extensions/reverseProxy.yaml", "extensions/test.yml");
+    }
+}
\ No newline at end of file
diff --git a/src/test/resources/plugin/test-unstructured-resource-loader.jar b/src/test/resources/plugin/test-unstructured-resource-loader.jar
new file mode 100644
index 0000000000000000000000000000000000000000..bca38cec250ed5e78afcc9e07acebba67c45305f
GIT binary patch
literal 16472
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

literal 0
HcmV?d00001