refactor(storage): 优化存储模块

Co-authored-by: QAQ_Z<[email protected]>



# message auto-generated for no-merge-commit merge:
merge storage into dev

优化存储模块

Created-by: QAQ_Z
Commit-by: QAQ_Z
Merged-by: Charles_7c
Description: <!--
  非常感谢您的 PR！在提交之前，请务必确保您 PR 的代码经过了完整测试，并且通过了代码规范检查。
-->

<!-- 在 [] 中输入 x 来勾选) -->

## PR 类型

<!-- 您的 PR 引入了哪种类型的变更？ -->
<!-- 只支持选择一种类型，如果有多种类型，可以在更新日志中增加 “类型” 列。 -->

- [ ] 新 feature
- [ ] Bug 修复
- [x] 功能增强
- [ ] 文档变更
- [ ] 代码样式变更
- [x] 重构
- [ ] 性能改进
- [ ] 单元测试
- [ ] CI/CD
- [ ] 其他

## PR 目的

<!-- 描述一下您的 PR 解决了什么问题。如果可以，请链接到相关 issues。 -->
- 重新设计了文件上传的预处理和后处理流程
- 优化了文件验证、命名、路径生成等环节
- 增加了单文件上传监听逻辑
- 增加了装饰器模式,支持重写指定存储策略实现的具体方法

## 解决方案

<!-- 详细描述您是如何解决的问题 -->

## PR 测试

<!-- 如果可以，请为您的 PR 添加或更新单元测试。 -->
<!-- 请描述一下您是如何测试 PR 的。例如：创建/更新单元测试或添加相关的截图。 -->

## Changelog

| 模块  | Changelog | Related issues |
|-----|-----------| -------------- |
|   continew-starter-storage  |    优化存储模块       |                |

<!-- 如果有多种类型的变更，可以在变更日志表中增加 “类型” 列，该列的值与上方 “PR 类型” 相同。 -->
<!-- Related issues 格式为 Closes #<issue号>，或者 Fixes #<issue号>，或者 Resolves #<issue号>。 -->

## 其他信息

<!-- 请描述一下还有哪些注意事项。例如：如果引入了一个不向下兼容的变更，请描述其影响。 -->

## 提交前确认

- [x] PR 代码经过了完整测试，并且通过了代码规范检查
- [ ] 已经完整填写 Changelog，并链接到了相关 issues
- [x] PR 代码将要提交到 dev 分支

See merge request: continew/continew-starter!4

Author: Time-w

continew-starter-storage/src/main/java/top/continew/starter/storage/annotation/PlatformProcessor.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2022-present Charles7c Authors. All Rights Reserved.
+ * <p>
+ * Licensed under the GNU LESSER GENERAL PUBLIC LICENSE 3.0;
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * <p>
+ * http://www.gnu.org/licenses/lgpl.html
+ * <p>
+ * 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 top.continew.starter.storage.annotation;
+
+import java.lang.annotation.*;
+
+/**
+ * 平台处理器注解
+ * <p>
+ * 该注解用于标记文件前置处理器类，以指定其适用的平台范围。
+ * 主要用于实现平台特定的文件处理逻辑，如文件名生成、路径转换、格式适配等。
+ * <p>
+ *
+ * @author echo
+ * @since 2.14.0
+ */
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+@Documented
+public @interface PlatformProcessor {
+    /**
+     * 适用的平台列表
+     */
+    String[] platforms();
+}

continew-starter-storage/src/main/java/top/continew/starter/storage/autoconfigure/LocalStorageAutoConfiguration.java

@@ -21,7 +21,7 @@
 import top.continew.starter.core.constant.PropertiesConstants;
 import top.continew.starter.storage.autoconfigure.properties.LocalStorageConfig;
 import top.continew.starter.storage.autoconfigure.properties.StorageProperties;
-import top.continew.starter.storage.router.StorageStrategyRegistrar;
+import top.continew.starter.storage.engine.StorageStrategyRegistrar;
 import top.continew.starter.storage.strategy.StorageStrategy;
 import top.continew.starter.storage.strategy.impl.LocalStorageStrategy;
 
@@ -43,7 +43,7 @@ public LocalStorageAutoConfiguration(StorageProperties storageProperties) {
     }
 
     /**
-     * 注册配置策略
+     * 注册本地存储策略
      *
      * @param strategies 策略列表
      */

continew-starter-storage/src/main/java/top/continew/starter/storage/autoconfigure/S3StorageAutoConfiguration.java renamed to continew-starter-storage/src/main/java/top/continew/starter/storage/autoconfigure/OssStorageAutoConfiguration.java

@@ -19,9 +19,9 @@
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
 import org.springframework.context.annotation.Bean;
 import top.continew.starter.core.constant.PropertiesConstants;
-import top.continew.starter.storage.autoconfigure.properties.S3StorageConfig;
+import top.continew.starter.storage.autoconfigure.properties.OssStorageConfig;
 import top.continew.starter.storage.autoconfigure.properties.StorageProperties;
-import top.continew.starter.storage.router.StorageStrategyRegistrar;
+import top.continew.starter.storage.engine.StorageStrategyRegistrar;
 import top.continew.starter.storage.strategy.StorageStrategy;
 import top.continew.starter.storage.strategy.impl.OssStorageStrategy;
 
@@ -33,24 +33,24 @@
  * @author echo
  * @since 2.14.0
  */
-@ConditionalOnProperty(prefix = PropertiesConstants.STORAGE, name = "s3")
-public class S3StorageAutoConfiguration implements StorageStrategyRegistrar {
+@ConditionalOnProperty(prefix = PropertiesConstants.STORAGE, name = "oss")
+public class OssStorageAutoConfiguration implements StorageStrategyRegistrar {
 
     private final StorageProperties properties;
 
-    public S3StorageAutoConfiguration(StorageProperties properties) {
+    public OssStorageAutoConfiguration(StorageProperties properties) {
         this.properties = properties;
     }
 
     /**
-     * 注册配置策略
+     * 注册 OSS 存储策略
      *
      * @param strategies 策略列表
      */
     @Override
     @Bean
     public void register(List<StorageStrategy> strategies) {
-        for (S3StorageConfig config : properties.getS3()) {
+        for (OssStorageConfig config : properties.getOss()) {
             if (config.isEnabled()) {
                 strategies.add(new OssStorageStrategy(config));
             }

continew-starter-storage/src/main/java/top/continew/starter/storage/autoconfigure/StorageAutoConfiguration.java

@@ -19,29 +19,29 @@
 import jakarta.annotation.PostConstruct;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
-import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.boot.autoconfigure.AutoConfiguration;
-import org.springframework.boot.autoconfigure.condition.ConditionalOnBean;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
 import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
 import org.springframework.boot.autoconfigure.web.servlet.MultipartProperties;
 import org.springframework.boot.context.properties.EnableConfigurationProperties;
+import org.springframework.context.ApplicationContext;
 import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
 import org.springframework.context.annotation.Import;
+import top.continew.starter.storage.annotation.PlatformProcessor;
 import top.continew.starter.storage.autoconfigure.properties.StorageProperties;
 import top.continew.starter.storage.core.FileStorageService;
-import top.continew.starter.storage.core.ProcessorRegistry;
-import top.continew.starter.storage.core.StrategyProxyFactory;
-import top.continew.starter.storage.prehandle.*;
-import top.continew.starter.storage.prehandle.impl.*;
-import top.continew.starter.storage.router.StorageStrategyRegistrar;
-import top.continew.starter.storage.router.StorageStrategyRouter;
+import top.continew.starter.storage.engine.StorageDecoratorManager;
+import top.continew.starter.storage.processor.registry.ProcessorRegistry;
+import top.continew.starter.storage.processor.preprocess.*;
+import top.continew.starter.storage.processor.preprocess.impl.*;
+import top.continew.starter.storage.engine.StorageStrategyRegistrar;
+import top.continew.starter.storage.engine.StorageStrategyRouter;
+import top.continew.starter.storage.service.FileProcessor;
 import top.continew.starter.storage.service.FileRecorder;
 import top.continew.starter.storage.service.impl.DefaultFileRecorder;
-import top.continew.starter.storage.strategy.StorageStrategyOverride;
 
 import java.util.List;
+import java.util.Map;
 
 /**
  * 存储自动配置
@@ -51,15 +51,17 @@
  */
 @AutoConfiguration
 @EnableConfigurationProperties(StorageProperties.class)
-@Import({ProcessorRegistry.class, StrategyProxyFactory.class})
+@Import({ProcessorRegistry.class})
 public class StorageAutoConfiguration {
 
     private static final Logger log = LoggerFactory.getLogger(StorageAutoConfiguration.class);
 
     private final StorageProperties properties;
+    private final ApplicationContext applicationContext;
 
-    public StorageAutoConfiguration(StorageProperties properties) {
+    public StorageAutoConfiguration(StorageProperties properties, ApplicationContext applicationContext) {
         this.properties = properties;
+        this.applicationContext = applicationContext;
     }
 
     /**
@@ -70,17 +72,27 @@ public StorageAutoConfiguration(StorageProperties properties) {
      */
     @Bean
     public StorageStrategyRouter strategyRouter(List<StorageStrategyRegistrar> registrars) {
-        return new StorageStrategyRouter(registrars);
+        return new StorageStrategyRouter(registrars, properties, storageDecoratorManager());
     }
 
     /**
-     * S3存储自动配置
+     * 存储装饰器管理器
      *
-     * @return {@link S3StorageAutoConfiguration }
+     * @return {@link StorageDecoratorManager }
      */
     @Bean
-    public S3StorageAutoConfiguration s3StorageAutoConfiguration() {
-        return new S3StorageAutoConfiguration(properties);
+    public StorageDecoratorManager storageDecoratorManager() {
+        return new StorageDecoratorManager(applicationContext);
+    }
+
+    /**
+     * oss存储自动配置
+     *
+     * @return {@link OssStorageAutoConfiguration }
+     */
+    @Bean
+    public OssStorageAutoConfiguration ossStorageAutoConfiguration() {
+        return new OssStorageAutoConfiguration(properties);
     }
 
     /**
@@ -99,16 +111,15 @@ public LocalStorageAutoConfiguration localStorageAutoConfiguration() {
      * @param router            路由
      * @param storageProperties 存储属性
      * @param processorRegistry 处理器注册表
-     * @param proxyFactory      代理工厂
+     * @param fileRecorder      文件记录器
      * @return {@link FileStorageService }
      */
     @Bean
     public FileStorageService fileStorageService(StorageStrategyRouter router,
                                                  StorageProperties storageProperties,
                                                  ProcessorRegistry processorRegistry,
-                                                 StrategyProxyFactory proxyFactory,
                                                  FileRecorder fileRecorder) {
-        return new FileStorageService(router, storageProperties, processorRegistry, proxyFactory, fileRecorder);
+        return new FileStorageService(router, storageProperties, processorRegistry, fileRecorder);
     }
 
     /**
@@ -122,125 +133,74 @@ public FileRecorder fileRecorder() {
         return new DefaultFileRecorder();
     }
 
+    /**
+     * 处理器注册中心
+     */
+    @Bean
+    public ProcessorRegistry processorRegistry() {
+        ProcessorRegistry registry = new ProcessorRegistry();
+
+        // 自动发现并注册所有 FileProcessor 实现
+        Map<String, FileProcessor> processors = applicationContext.getBeansOfType(FileProcessor.class);
+        processors.values().forEach(processor -> {
+            // 检查是否有平台注解
+            PlatformProcessor annotation = processor.getClass().getAnnotation(PlatformProcessor.class);
+            if (annotation != null) {
+                for (String platform : annotation.platforms()) {
+                    registry.register(processor, platform);
+                }
+            } else {
+                // 注册为全局处理器
+                registry.register(processor);
+            }
+        });
+        return registry;
+    }
+
     /**
      * 默认文件名生成器
-     *
-     * @param registry 登记处
-     * @return {@link FileNameGenerator }
      */
     @Bean
-    @ConditionalOnMissingBean(name = "defaultFileNameGenerator")
-    public FileNameGenerator defaultFileNameGenerator(ProcessorRegistry registry) {
-        DefaultFileNameGenerator generator = new DefaultFileNameGenerator();
-        registry.registerGlobalNameGenerator(generator);
-        return generator;
+    @ConditionalOnMissingBean(FileNameGenerator.class)
+    public FileNameGenerator defaultFileNameGenerator() {
+        return new DefaultFileNameGenerator();
     }
 
     /**
-     * 默认文件路径生成器
-     *
-     * @param registry 注册
-     * @return {@link FilePathGenerator }
+     * 默认路径生成器
      */
     @Bean
-    @ConditionalOnMissingBean(name = "defaultFilePathGenerator")
-    public FilePathGenerator defaultFilePathGenerator(ProcessorRegistry registry) {
-        DefaultFilePathGenerator generator = new DefaultFilePathGenerator();
-        registry.registerGlobalPathGenerator(generator);
-        return generator;
+    @ConditionalOnMissingBean(FilePathGenerator.class)
+    public FilePathGenerator defaultFilePathGenerator() {
+        return new DefaultFilePathGenerator();
     }
 
     /**
      * 默认缩略图处理器
-     *
-     * @param registry 注册
-     * @return {@link ThumbnailProcessor }
      */
     @Bean
-    @ConditionalOnMissingBean(name = "defaultThumbnailProcessor")
+    @ConditionalOnMissingBean(ThumbnailProcessor.class)
     @ConditionalOnClass(name = "net.coobird.thumbnailator.Thumbnails")
-    public ThumbnailProcessor defaultThumbnailProcessor(ProcessorRegistry registry) {
-        DefaultThumbnailProcessor processor = new DefaultThumbnailProcessor();
-        registry.registerGlobalThumbnailProcessor(processor);
-        return processor;
+    public ThumbnailProcessor defaultThumbnailProcessor() {
+        return new DefaultThumbnailProcessor();
     }
 
     /**
      * 文件大小验证器
-     *
-     * @param registry 注册
-     * @return {@link FileValidator }
      */
     @Bean
     @ConditionalOnMissingBean(name = "fileSizeValidator")
-    public FileValidator fileSizeValidator(ProcessorRegistry registry, MultipartProperties multipartProperties) {
-        FileSizeValidator validator = new FileSizeValidator(multipartProperties);
-        registry.registerGlobalValidator(validator);
-        return validator;
+    public FileValidator fileSizeValidator(MultipartProperties multipartProperties) {
+        return new FileSizeValidator(multipartProperties);
     }
 
     /**
      * 文件类型验证器
-     *
-     * @param registry 注册
-     * @return {@link FileValidator }
      */
     @Bean
     @ConditionalOnMissingBean(name = "fileTypeValidator")
-    public FileValidator fileTypeValidator(ProcessorRegistry registry) {
-        FileTypeValidator validator = new FileTypeValidator();
-        registry.registerGlobalValidator(validator);
-        return validator;
-    }
-
-    /**
-     * 策略重写自动注册
-     */
-    @Configuration
-    @ConditionalOnBean(StorageStrategyOverride.class)
-    public static class StrategyOverrideConfiguration {
-
-        /**
-         * 注册覆盖
-         */
-        @Autowired
-        public void registerOverrides(List<StorageStrategyOverride<?>> overrides, StrategyProxyFactory proxyFactory) {
-            for (StorageStrategyOverride<?> override : overrides) {
-                proxyFactory.registerOverride(override);
-            }
-        }
-    }
-
-    /**
-     * 处理器自动注册
-     */
-    @Configuration
-    public static class ProcessorAutoConfiguration {
-        @Autowired(required = false)
-        public void registerGlobalProcessors(List<FileNameGenerator> nameGenerators,
-                                             List<FilePathGenerator> pathGenerators,
-                                             List<ThumbnailProcessor> thumbnailProcessors,
-                                             List<FileValidator> validators,
-                                             List<UploadCompleteProcessor> completeProcessors,
-                                             ProcessorRegistry registry) {
-
-            // 注册全局处理器
-            if (nameGenerators != null) {
-                nameGenerators.forEach(registry::registerGlobalNameGenerator);
-            }
-            if (pathGenerators != null) {
-                pathGenerators.forEach(registry::registerGlobalPathGenerator);
-            }
-            if (thumbnailProcessors != null) {
-                thumbnailProcessors.forEach(registry::registerGlobalThumbnailProcessor);
-            }
-            if (validators != null) {
-                validators.forEach(registry::registerGlobalValidator);
-            }
-            if (completeProcessors != null) {
-                completeProcessors.forEach(registry::registerGlobalCompleteProcessor);
-            }
-        }
+    public FileValidator fileTypeValidator() {
+        return new FileTypeValidator();
     }
 
     @PostConstruct