Galosys.Foundation.FileStorage 26.5.20.1

Galosys.Foundation.FileStorage

成熟度: 🟡 实验性 — 新增模块，接口稳定中

简介

文件存储抽象层，基于 Plugin 策略路由模式，提供统一的文件上传/下载/预签名 URL/删除接口。通过 PluginRegistry 实现多 Provider 路由，各适配器模块按需引入。

特性

• 统一接口 — IFileStorageProvider 定义 Upload / Download / PresignedUrl / Delete 四大操作
• 策略路由 — 基于 PluginRegistry<IFileStorageProvider, FileStorageRequest> 按 Provider 名称自动路由
• 多提供方共存 — 支持 Minio、阿里云 OSS、七牛、本地文件系统等多种存储后端
• 零侵入扩展 — 各适配器模块独立注册 IFileStorageProvider，无需修改业务代码

安装

dotnet add package Galosys.Foundation.FileStorage
dotnet add package Galosys.Foundation.Minio       # 按需选择适配器

可用适配器

配置

最小化配置（Minio 示例）

{
  "Minio": {
    "Endpoint": "play.min.io",          // Minio 服务地址
    "AccessKey": "your-access-key",
    "SecretKey": "your-secret-key",
    "DefaultBucket": "my-bucket"        // 默认桶名，可选
  }
}

快速开始

注册服务

// Program.cs / Startup.cs
services.AddMinio(configuration);       // 注册 Minio 适配器，同时自动注册为默认 Provider

使用 PluginRegistry 获取 Provider

var registry = serviceProvider.GetRequiredService<PluginRegistry<IFileStorageProvider, FileStorageRequest>>();
var provider = registry.GetPluginFor(new FileStorageRequest());  // 获取默认 Provider

上传文件

await using var stream = File.OpenRead("photo.jpg");
var result = await provider.UploadAsync(stream, "images/photo.jpg", "my-bucket");
// result.FilePath → "images/photo.jpg"
// result.Url      → 访问地址（如适用）
// result.Size     → 文件大小

下载文件

await using var stream = await provider.DownloadAsync("images/photo.jpg", "my-bucket");

预签名 URL

var url = await provider.GetPresignedUrlAsync("images/photo.jpg", expirySeconds: 3600, bucket: "my-bucket");

删除文件

await provider.DeleteAsync("images/photo.jpg", "my-bucket");

多 Provider 路由

// 注册多个 Provider
services.AddMinio(configuration);           // default + "minio"
services.AddLocalFileSystem(configuration); // "local"

var registry = serviceProvider.GetRequiredService<PluginRegistry<IFileStorageProvider, FileStorageRequest>>();

// 路由到指定 Provider
var minioProvider = registry.GetPluginFor(new FileStorageRequest(Provider: "minio"));
var localProvider = registry.GetPluginFor(new FileStorageRequest(Provider: "local"));

// 路由到默认 Provider（Provider 为空或 null）
var defaultProvider = registry.GetPluginFor(new FileStorageRequest());

TryAddSingleton 注册策略：后注册不覆盖，第一个注册的为默认 Provider。

核心类

DI 注册详情

依赖

• Galosys.Foundation.Core（提供 PluginRegistry、IModule）
• Microsoft.Extensions.DependencyInjection

注意事项

• FileStorage 模块本身不需要额外配置，PluginRegistry 由 Core 模块统一注册
• 各适配器模块独立引用，业务项目只需引用所需适配器即可
• FileStorageRequest.Provider 为空或 null 时匹配默认 Provider（第一个注册的），指定名称时精确匹配