初始化仓库

xtools-boot-knife4j/pom.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>org.xujun</groupId>
+        <artifactId>xtools-boot</artifactId>
+        <version>5.0.0</version>
+    </parent>
+    <artifactId>xtools-boot-knife4j</artifactId>
+
+    <!-- 项目依赖 -->
+    <dependencies>
+        <!-- xtools-boot begin -->
+        <!-- xtools-boot-core -->
+        <dependency>
+            <groupId>org.xujun</groupId>
+            <artifactId>xtools-boot-core</artifactId>
+        </dependency>
+        <!-- xtools-boot end -->
+
+        <!-- SpringBoot begin -->
+        <!-- springdoc -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+        </dependency>
+        <!-- knife4j -->
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+        </dependency>
+        <!-- SpringBoot end -->
+    </dependencies>
+
+</project>

xtools-boot-knife4j/src/main/java/xtools/boot/knife4j/BootKnife4jConfiguration.java

@@ -0,0 +1,28 @@
+package xtools.boot.knife4j;
+
+import org.springframework.context.annotation.Import;
+import xtools.boot.core.utils.ModuleLoadUtils;
+import xtools.boot.knife4j.selector.BootKnife4jImportSelector;
+
+/**
+ * <p>Title : BootKnife4jConfiguration</p>
+ * <p>Description : BootKnife4jConfiguration</p>
+ * <p>DevelopTools : Idea_x64_v2026.1</p>
+ * <p>DevelopSystem : macOS Sequoia 15.7.5</p>
+ * <p>Company : org.xujun</p>
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+@Import(BootKnife4jImportSelector.class)
+public class BootKnife4jConfiguration {
+
+    /**
+     * 构造方法
+     */
+    public BootKnife4jConfiguration() {
+        ModuleLoadUtils.loadSuccess(BootKnife4jConfiguration.class);
+    }
+
+}

xtools-boot-knife4j/src/main/java/xtools/boot/knife4j/config/Knife4jFilterWhitelist.java

@@ -0,0 +1,35 @@
+package xtools.boot.knife4j.config;
+
+import org.springframework.stereotype.Component;
+import xtools.boot.core.interfaces.FilterWhitelist;
+
+import java.util.Set;
+
+/**
+ * <p>Title : Knife4jFilterWhitelist</p>
+ * <p>Description : Knife4jFilterWhitelist</p>
+ * <p>DevelopTools : Idea_x64_v2026.1</p>
+ * <p>DevelopSystem : macOS Sequoia 15.7.5</p>
+ * <p>Company : org.xujun</p>
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/3/8 12:28
+ */
+@Component
+public class Knife4jFilterWhitelist implements FilterWhitelist {
+
+    /**
+     * 添加过滤器白名单
+     *
+     * @return 过滤器白名单
+     */
+    @Override
+    public Set<String> add() {
+        return Set.of(
+                "/doc.html",
+                "/webjars/**",
+                "/v3/api-docs/**"
+        );
+    }
+}

xtools-boot-knife4j/src/main/java/xtools/boot/knife4j/selector/BootKnife4jImportSelector.java

@@ -0,0 +1,36 @@
+package xtools.boot.knife4j.selector;
+
+import org.jspecify.annotations.NonNull;
+import org.springframework.beans.factory.support.BeanDefinitionRegistry;
+import org.springframework.context.annotation.ClassPathBeanDefinitionScanner;
+import org.springframework.context.annotation.ImportBeanDefinitionRegistrar;
+import org.springframework.core.type.AnnotationMetadata;
+
+/**
+ * <p>Title : BootKnife4jImportSelector</p>
+ * <p>Description : BootKnife4jImportSelector</p>
+ * <p>DevelopTools : Idea_x64_v2026.1</p>
+ * <p>DevelopSystem : macOS Sequoia 15.7.5</p>
+ * <p>Company : org.xujun</p>
+ *
+ * @author : XuJun
+ * @version : 5.0.0
+ * @date : 2026/01/01 09:30
+ */
+public class BootKnife4jImportSelector implements ImportBeanDefinitionRegistrar {
+
+    /**
+     * 根据给定的注释元数据,根据需要注册bean
+     *
+     * @param importingClassMetadata AnnotationMetadata
+     * @param registry               BeanDefinitionRegistry
+     */
+    @Override
+    public void registerBeanDefinitions(@NonNull AnnotationMetadata importingClassMetadata, @NonNull BeanDefinitionRegistry registry) {
+        // 构建扫描对象
+        ClassPathBeanDefinitionScanner scanner = new ClassPathBeanDefinitionScanner(registry, true);
+        // 扫描包下路径
+        scanner.scan("xtools.boot.knife4j");
+    }
+
+}

xtools-boot-knife4j/src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -0,0 +1 @@
+xtools.boot.knife4j.BootKnife4jConfiguration