Skip to main content

Crate wordval_fs

Crate wordval_fs 

Source
Expand description

§wordval-fs

Wordval 文件存储:本地文件系统、MinIO 等多种后端。

§支持的后端

  • LocalFs — 本地文件系统存储
  • MinioFs — MinIO 对象存储(minio feature,默认启用)
  • FsBackendEnum::Custom — 任意实现 FsBackend 的自定义后端

§作为插件使用

ⓘ
use wordval_fs::FsPlugin;

let mgr = PluginManager::new()
    .add(FsPlugin::new(&config.fs));

§直接使用

ⓘ
use wordval_fs::{LocalFs, FsBackend, FsBackendEnum};

let backend = FsBackendEnum::Local(std::sync::Arc::new(LocalFs::new("./uploads")));
let meta = backend.write("path/to/file.txt", b"hello").await?;
let data = backend.read("path/to/file.txt").await?;

§自定义后端扩展

实现 FsBackend trait 后包装为 FsBackendEnum::Custom 即可接入 (如 FTP、WebDAV 等协议后端),无需修改本 crate:

ⓘ
struct FtpFs { /* 连接配置 */ }

#[async_trait::async_trait]
impl FsBackend for FtpFs {
    fn backend_name(&self) -> &str { "ftp" }
    async fn write(&self, relative_path: &str, data: &[u8]) -> StoreResult<FileMeta> { /* ... */ }
    // read / delete / exists / list 同理
}

let backend = FsBackendEnum::Custom(std::sync::Arc::new(FtpFs::new()));

Re-exports§

pub use backend::FsBackend;
pub use backend::FsBackendEnum;
pub use local::LocalFs;
pub use minio::MinioFs;
pub use plugin::FsPlugin;
pub use types::FileEntry;
pub use types::FileMeta;
pub use types::StoreResult;

Modules§

backend
local
minio
plugin
文件存储插件 —— 管理存储后端实例的生命周期
types