Bitzsoft.Integrations.CloudDrive.AnyShare 1.0.0-alpha.10

Bitzsoft.Integrations.CloudDrive.AnyShare

爱数 AnyShare 企业内容管理平台服务实现，面向私有化部署场景提供标准接入结构。

功能特性

• 基于爱数 AnyShare RESTful API，提供标准接入结构
• Bearer Token 认证：通过 API 访问令牌接入
• 私有化部署友好：BaseUrl 由企业按实际部署地址配置，无公共默认值
• 核心文件能力：文件上传、下载与列表查询已实现
• 可扩展：搜索、分享、权限等接口可按企业部署版本继续扩展

安装

.NET CLI

dotnet add package Bitzsoft.Integrations.CloudDrive.AnyShare

PackageReference

<PackageReference Include="Bitzsoft.Integrations.CloudDrive.AnyShare" Version="1.0.0" />

配置

appsettings.json

{
  "CloudDrive": {
    "AnyShare": {
      "ApiToken": "你的 API 令牌",
      "BaseUrl": "https://your-anyshare-instance.example.com",
      "HttpClientName": "AnyShareCloudDrive"
    }
  }
}

注册服务

从 IConfiguration 绑定（推荐）

using Bitzsoft.Integrations.CloudDrive.AnyShare;

builder.Services.AddBitzsoftAnyShareCloudDrive(
    builder.Configuration.GetSection("CloudDrive:AnyShare"));

委托配置

builder.Services.AddBitzsoftAnyShareCloudDrive(options =>
{
    options.ApiToken = "your_api_token";
    options.BaseUrl = "https://your-anyshare-instance.example.com";
});

使用示例

using Bitzsoft.Integrations.CloudDrive.Interfaces;
using Bitzsoft.Integrations.CloudDrive.Models;

public class MyService
{
    private readonly ICloudDriveProvider _drive;

    public MyService(ICloudDriveProvider drive) => _drive = drive;

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

        // 列出文件列表
        var files = await _drive.ListFilesAsync("space_id_or_path");
        foreach (var file in files.Items)
        {
            Console.WriteLine($"{file.Name} ({file.Size} bytes)");
        }

        // 下载文件
        var download = await _drive.DownloadAsync(upload.FileInfo.Id);
    }
}

核心类型一览

实现状态

请求审计

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

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

// ② 持久化：宿主注册 IRequestLogStore 实现后，所有出站请求自动落库
services.AddRequestLogging<MyRequestLogStore>(opts =>
{
    opts.MaxInMemoryBodyBytes = 64 * 1024; // 仅控制内存/加密临时文件切换，不截断正文
    opts.SensitiveFields.Add("mySecret"); // 额外脱敏字段
});
services.AddBitzsoftAnyShareCloudDrive(options => { /* ... */ });

注意事项

• AnyShare 为私有化部署产品，不同企业版本的接口路径和权限模型可能存在差异
• 当前实现覆盖文件上传、下载、列表三项基础能力，其余接口按企业部署版本扩展
• 建议以企业授权文档确认接口路径、返回字段和权限范围

依赖

相关包

• Bitzsoft.Integrations.CloudDrive -- 抽象层
• Bitzsoft.Integrations.CloudDrive.All -- 聚合包（一键注册全部供应商）
• Bitzsoft.Integrations.CloudDrive.Nutstore -- 坚果云
• Bitzsoft.Integrations.CloudDrive.Microsoft365 -- Microsoft 365 / OneDrive
• Bitzsoft.Integrations.CloudDrive.Gokuai -- 够快云库
• Bitzsoft.Integrations.CloudDrive.Baidu -- 百度网盘
• Bitzsoft.Integrations.CloudDrive.Aliyun -- 阿里云网盘 PDS
• Bitzsoft.Integrations.Compatibility -- 基础工具库