Bitzsoft.Integrations.CloudDrive.Nutstore 1.0.0-alpha.8

Bitzsoft.Integrations.CloudDrive.Nutstore

坚果云企业网盘服务实现，基于 WebDAV 协议与坚果云服务端交互。

功能

• 基于 WebDAV 协议实现文件上传、下载、移动、复制、删除等基础操作
• 支持文件夹创建、列举、删除
• 支持 NSDAV XML API 搜索、创建分享链接、文件夹 ACL 权限管理
• 认证方式：邮箱 + 应用专用密码（HTTP Basic Auth）
• 统一异常处理，WebDAV 错误自动映射为 CloudDriveException

安装

dotnet add package Bitzsoft.Integrations.CloudDrive.Nutstore

<PackageReference Include="Bitzsoft.Integrations.CloudDrive.Nutstore" Version="*" />

配置

{
  "CloudDrive": {
    "Nutstore": {
      "AuthEmail": "your-email@example.com",
      "AuthPassword": "your-app-password",
      "BaseUrl": "https://dav.jianguoyun.com/dav/",
      "RestApiUrl": "https://api.jianguoyun.com/v2/",
      "HttpClientName": "NutstoreCloudDrive"
    }
  }
}

注册

// 方式一：Action 配置
services.AddBitzsoftNutstoreCloudDrive(options =>
{
    options.AuthEmail = "your-email@example.com";
    options.AuthPassword = "your-app-password";
});

// 方式二：IConfiguration 绑定
services.AddBitzsoftNutstoreCloudDrive(configuration, "CloudDrive:Nutstore");

第三方请求日志

内置 Bitzsoft.Integrations.RequestLogging 出站请求记录管道，默认 NullRequestLogStore 不持久化。

// ① 默认：启用记录管道但不持久化（日志丢弃）
services.AddBitzsoftNutstoreCloudDrive(options => { /* ... */ });

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxBodyLength = 8192;            // 单条正文截断上限
    opts.SensitiveFields.Add("mySecret"); // 额外脱敏字段
});
services.AddBitzsoftNutstoreCloudDrive(options => { /* ... */ });

使用示例

public class MyService
{
    private readonly ICloudDriveProvider _cloudDrive;

    public MyService(ICloudDriveProvider cloudDrive) => _cloudDrive = cloudDrive;

    public async Task UploadAndListAsync()
    {
        // 上传文件
        await using var stream = File.OpenRead("report.pdf");
        var uploadResult = await _cloudDrive.UploadAsync(new UploadFileRequest
        {
            FolderId = "/documents",
            FileName = "report.pdf",
            Content = stream,
            ContentType = "application/pdf"
        });

        // 列出文件夹内容
        var files = await _cloudDrive.ListFilesAsync("/documents");
        foreach (var file in files.Items)
        {
            Console.WriteLine($"{file.Name} ({file.Size} bytes)");
        }

        // 下载文件
        var downloadStream = await _cloudDrive.DownloadAsync("/documents/report.pdf");
    }
}

实现状态

注意事项

• WebDAV 协议不支持服务端搜索和分页，ListFilesAsync 采用客户端分页
• SearchAsync 使用 NSDAV 搜索接口，分页和类型/扩展名筛选在客户端完成
• 分享链接创建接口不支持访问密码、过期时间或最大访问次数
• 权限管理接口会提交完整 ACL 列表，封装会先读取再替换/移除目标权限
• fileId 和 folderId 均为 WebDAV 相对路径（如 /documents/report.pdf）
• 应用密码需在坚果云 Web 端「安全选项」中生成第三方应用专用密码
• 文件夹 ID 以路径形式表示，根目录使用 /

依赖

• Bitzsoft.Integrations.CloudDrive，企业网盘抽象层
• Bitzsoft.Integrations.Compatibility，基础工具库

相关包