操作阿里云OSS的基础类库

1、版本历史

• 5.0.3（2024-03-14），增加存储桶获取文件路径列表的方法，GetFilePathList
• 5.0.0（2024-03-12），重新上架

2、功能描述

提供了一个标准存储桶DataBucket和一个默认存储桶DefaultBucket

• 使用 DataBucket，需要在 DataBucket 定义其名称；
• 使用 DefaultBucket，需要在 DefaultBucket 定义其名称。

OssHelper.DefaultBucket 提供了阿里云OSS上传文件的标准处理方式：

• 上传普通文件 PutObject
• 上传超大文件 PutBigObject
• 检查文件是否存在 FileExist

OssHelper.DataBucket 是一个标准存储桶，针对这个存储桶，类库提供了按设定规则进行全局文件管理：

• 随机路径存放文件（指定文件名） SaveFile、SaveBigFile、
• 随机路径存放文件（随机文件名）SaveAnonymousFile、SaveBigAnonymousFile、SaveAnonymousFileUrlAsync
• 随机路径存放JSON对象 SaveJson
• 随机路径存放文本文件 SaveString、SaveTextString、SaveHtmlString、SaveJsonString
• 随机路径存放图片文件 SaveImageStream、SaveAvatarStream、SaveThumbStream、SaveBannerStream

随机路径转存网络图片 SaveImageFromUrlAsync、SaveAvatarFromUrlAsync、SaveThumbFromUrlAsync、SaveBannerFromUrlAsync

• 检查文件是否存在 FileExist

静态工具方法

• OssHelper.GetPictureVisitUrl 获取图片特性OSS样式的访问路径（通常和SaveAnonymousFile搭配使用）

3、配置信息

配置信息在 appsettings.json 中

{
  "Encrypt": "AES加密的密钥，必须为32位全小写字符或数字",
  "WingWell.Util.Aliyun.Oss": {
    "DataBucket": "标准存储桶的业务名称",
    "DefaultBucket": "默认储桶的业务名称",
    "Buckets": [
      {
        "Name": "存储桶业务名称",
        "KeyID": "有该存储桶权限的阿里云KeyId",
        "KeySecret": "AES加密的阿里云KeySecret",
        "EndPoint": 'https://oss-accelerate.aliyuncs.com',
        "BucketName" : "存储桶在阿里云上的名称"
        "BucketUrl" : "外网访问该存储桶的http或https根路径"
      },
      {
        "Name": "存储桶名称",
        "KeyID": "有该存储桶权限的阿里云KeyId",
        "KeySecret": "AES加密的阿里云KeySecret",
        "EndPoint": 'https://oss-accelerate.aliyuncs.com',
        "BucketName" : "存储桶在阿里云上的名称"
        "BucketUrl" : "外网访问该存储桶的http或https根路径"
      },
      {
        "Name": "存储桶名称",
        "KeyID": "有该存储桶权限的阿里云KeyId",
        "KeySecret": "AES加密的阿里云KeySecret",
        "EndPoint": 'https://oss-accelerate.aliyuncs.com',
        "BucketName" : "存储桶在阿里云上的名称"
        "BucketUrl" : "外网访问该存储桶的http或https根路径"
      }
    ]
  }
}