Galosys.Foundation.LocalFileSystem 26.5.20.1

Galosys.Foundation.LocalFileSystem

🟡 实验性 — 本地文件系统存储适配器，实现 IFileStorageProvider 接口，适用于开发环境和单机部署。

快速开始

// Program.cs / Startup.cs — 最小化配置（使用默认路径 ./uploads）
services.AddLocalFileSystem();

从配置文件绑定：

services.AddLocalFileSystem(configuration);

配置

// appsettings.json
{
 "LocalFileSystem": {
 "BasePath": "./uploads" // 文件存储根目录，默认 "./uploads"
 }
}

使用示例

var provider = serviceProvider.GetRequiredService<IFileStorageProvider>();

// Upload — 文件写入本地磁盘
var result = await provider.UploadAsync(stream, "docs/report.pdf");

// Download — 从本地磁盘读取
var stream = await provider.DownloadAsync("docs/report.pdf");

// GetPresignedUrl — 返回物理文件路径（本地无预签名 URL）
var path = await provider.GetPresignedUrlAsync("docs/report.pdf");

// Delete — 删除本地文件
await provider.DeleteAsync("docs/report.pdf");

// 使用子目录（bucket 参数映射为子目录）
await provider.UploadAsync(stream, "photo.jpg", bucket: "images");
// 文件保存到: ./uploads/images/photo.jpg

主要类型

注意事项

• 适用于开发环境和单机部署场景，分布式环境请使用对象存储适配器
• GetPresignedUrlAsync 返回物理路径而非 HTTP URL
• bucket 参数映射为 BasePath 下的子目录
• 线程安全，支持并发读写