feat: restructure RSS generation to support extension by other plugins

.github/workflows/cd.yaml

@@ -16,3 +16,4 @@ jobs:
     with:
       app-id: app-KhIVw
       skip-node-setup: true
+      artifacts-path: 'app/build/libs'

.github/workflows/ci.yaml

@@ -13,3 +13,4 @@ jobs:
     uses: halo-sigs/reusable-workflows/.github/workflows/plugin-ci.yaml@v1
     with:
       skip-node-setup: true
+      artifacts-path: 'app/build/libs'

.gitignore

@@ -72,3 +72,4 @@ application-local.properties
 
 /admin-frontend/node_modules/
 /workplace/
+*/workplace/

api/build.gradle

@@ -0,0 +1,73 @@
+plugins {
+    id 'java-library'
+    id 'maven-publish'
+    id "io.freefair.lombok" version "8.0.0-rc2"
+}
+
+group = 'run.halo.feed'
+version = rootProject.version
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_17
+    targetCompatibility = JavaVersion.VERSION_17
+}
+
+compileJava.options.encoding = "UTF-8"
+compileTestJava.options.encoding = "UTF-8"
+javadoc.options.encoding = "UTF-8"
+
+dependencies {
+    api platform('run.halo.tools.platform:plugin:2.20.0-SNAPSHOT')
+    compileOnly 'run.halo.app:api'
+}
+
+test {
+    useJUnitPlatform()
+}
+
+publishing {
+    publications {
+        mavenJava(MavenPublication) {
+            from components.java
+            artifactId = 'api'
+            version = project.hasProperty('version') ? project.property('version') : 'unspecified'
+
+            pom {
+                name = 'RSS'
+                description = '为站点生成 RSS 订阅链接'
+                url = 'https://www.halo.run/store/apps/app-KhIVw'
+
+                licenses {
+                    license {
+                        name = 'GPL-3.0'
+                        url = 'https://github.com/halo-dev/plugin-feed/blob/main/LICENSE'
+                    }
+                }
+
+                developers {
+                    developer {
+                        id = 'guqing'
+                        name = 'guqing'
+                        email = '[email protected]'
+                    }
+                }
+
+                scm {
+                    connection = 'scm:git:[email protected]:halo-dev/plugin-feed.git'
+                    developerConnection = 'scm:git:[email protected]:halo-dev/plugin-feed.git'
+                    url = 'https://github.com/halo-dev/plugin-feed'
+                }
+            }
+        }
+    }
+    repositories {
+        maven {
+            url = version.endsWith('-SNAPSHOT') ? 'https://s01.oss.sonatype.org/content/repositories/snapshots/' :
+                    'https://s01.oss.sonatype.org/content/repositories/releases/'
+            credentials {
+                username = project.findProperty("ossr.user") ?: System.getenv("OSSR_USERNAME")
+                password = project.findProperty("ossr.password") ?: System.getenv("OSSR_PASSWORD")
+            }
+        }
+    }
+}

api/src/main/java/run/halo/feed/RSS2.java

@@ -0,0 +1,105 @@
+package run.halo.feed;
+
+import jakarta.validation.constraints.NotBlank;
+import java.time.Instant;
+import java.util.List;
+import lombok.Builder;
+import lombok.Data;
+
+@Data
+@Builder
+public class RSS2 {
+    /**
+     * (Recommended) The name of the feed, which should be plain text only
+     */
+    @NotBlank
+    private String title;
+
+    /**
+     * (Recommended) The URL of the website associated with the feed, which should link to a
+     * human-readable website
+     */
+    @NotBlank
+    private String link;
+
+    /**
+     * (Optional) The summary of the feed, which should be plain text only
+     */
+    private String description;
+
+    /**
+     * The primary language of the feed, which should be a value from
+     * <a href="https://www.rssboard.org/rss-language-codes">RSS Language Codes</a> or ISO
+     * 639 language codes
+     */
+    private String language;
+
+    /**
+     * (Recommended) The URL of the image that represents the channel, which should be relatively
+     * large and square
+     */
+    private String image;
+
+    private List<Item> items;
+
+    @Data
+    @Builder
+    public static class Item {
+        /**
+         * (Required) The title of the item, which should be plain text only
+         */
+        @NotBlank
+        private String title;
+
+        /**
+         * (Recommended) The URL of the item, which should link to a human-readable website
+         */
+        @NotBlank
+        private String link;
+
+        /**
+         * <p>(Recommended) The content of the item. For an Atom feed, it's the atom:content
+         * element.</p>
+         * <p>For a JSON feed, it's the content_html field.</p>
+         */
+        @NotBlank
+        private String description;
+
+        /**
+         * (Optional) The author of the item
+         */
+        private String author;
+
+        /**
+         * (Optional) The category of the item. You can use a plain string or an array of strings
+         */
+        private List<String> categories;
+
+        /**
+         * (Recommended) The publication
+         * <a href="https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date">date </a> of the item, which should be a Date object
+         * following <a href="https://docs.rsshub.app/joinus/advanced/pub-date">the standard</a>
+         */
+        private Instant pubDate;
+
+        /**
+         * (Optional) The unique identifier of the item
+         */
+        private String guid;
+
+        /**
+         * (Optional) The URL of an enclosure associated with the item
+         */
+        private String enclosureUrl;
+
+        /**
+         * (Optional) The size of the enclosure file in byte, which should be a number
+         */
+        private String enclosureLength;
+
+        /**
+         * (Optional) The MIME type of the enclosure file, which should be a string
+         */
+        private String enclosureType;
+    }
+}

api/src/main/java/run/halo/feed/RssRouteItem.java

@@ -0,0 +1,41 @@
+package run.halo.feed;
+
+import org.pf4j.ExtensionPoint;
+import org.springframework.lang.NonNull;
+import org.springframework.web.reactive.function.server.ServerRequest;
+import reactor.core.publisher.Mono;
+
+public interface RssRouteItem extends ExtensionPoint {
+
+    /**
+     * <p>Path pattern of this route.</p>
+     * <p>If return {@link Mono#empty()}, the route will be ignored.</p>
+     * <p>Otherwise, the route will be registered with the returned path pattern by rule: {@code
+     * /feed/[namespace]/{pathPattern}}.</p>
+     */
+    Mono<String> pathPattern();
+
+    @NonNull
+    String displayName();
+
+    default String description() {
+        return "";
+    }
+
+    /**
+     * An example URI for this route.
+     */
+    default String example() {
+        return "";
+    }
+
+    /**
+     * The namespace of this route to avoid conflicts.
+     */
+    default String namespace() {
+        return "";
+    }
+
+    @NonNull
+    Mono<RSS2> handler(ServerRequest request);
+}

app/build.gradle

@@ -0,0 +1,34 @@
+plugins {
+    id 'java'
+    id "io.freefair.lombok" version "8.0.0-rc2"
+    id "run.halo.plugin.devtools" version "0.4.1"
+}
+
+group = 'run.halo.feed'
+version = rootProject.version
+
+jar {
+    dependsOn(":api:jar")
+}
+
+dependencies {
+    implementation project(':api')
+    compileOnly 'run.halo.app:api'
+    implementation 'org.dom4j:dom4j:2.1.3'
+    implementation('org.apache.commons:commons-text:1.10.0') {
+        // Because the transitive dependency already exists in halo.
+        exclude group: 'org.apache.commons', module: 'commons-lang3'
+    }
+
+    testImplementation 'run.halo.app:api'
+    testImplementation 'org.springframework.boot:spring-boot-starter-test'
+}
+
+test {
+    useJUnitPlatform()
+}
+
+halo {
+    version = '2.20.10'
+    debug = true
+}

app/src/main/java/run/halo/feed/BasicProp.java

@@ -0,0 +1,37 @@
+package run.halo.feed;
+
+import lombok.Data;
+import lombok.experimental.Accessors;
+import reactor.core.publisher.Mono;
+import run.halo.app.plugin.ReactiveSettingFetcher;
+
+@Data
+@Accessors(chain = true)
+public class BasicProp {
+    private boolean enableCategories = Boolean.TRUE;
+    private boolean enableAuthors = Boolean.TRUE;
+    private String descriptionType;
+    private Integer outputNum;
+
+    public boolean isExcerptDescriptionType() {
+        return DescriptionType.EXCERPT.name().equalsIgnoreCase(descriptionType);
+    }
+
+    public enum DescriptionType {
+        EXCERPT,
+        CONTENT
+    }
+
+    public static Mono<BasicProp> getBasicProp(ReactiveSettingFetcher settingFetcher) {
+        return settingFetcher.fetch("basic", BasicProp.class)
+            .defaultIfEmpty(new BasicProp())
+            .doOnNext(prop -> {
+                if (prop.getOutputNum() == null) {
+                    prop.setOutputNum(20);
+                }
+                if (prop.getDescriptionType() == null) {
+                    prop.setDescriptionType(DescriptionType.EXCERPT.name());
+                }
+            });
+    }
+}