開源.NetCore通用工具庫Xmtool使用連載 - OSS文件上傳篇

【Github源碼】

《上一篇》 介紹了Xmtool工具庫中的圖像處理類庫，今天我們繼續為大家介紹其中的OSS文件上傳類庫。

將本地文件上傳到伺服器是軟體系統經常會遇到的需求，例如：設置用戶頭像，上傳Excel報表等等；涉及到網路訪問性能、存儲空間等因素的考慮，通常我們會選擇使用第三方的對象存儲服務，本類庫將比較常用的第三方對象存儲服務進行了封裝整合，讓用戶能夠使用一套API將文件上傳到不同的對象存儲服務上，方便了用戶使用。

目前，類庫支持了七牛、阿裡雲、騰訊3種對象存儲服務。

public enum OssProvider
{
    Unset,
    Qiniu,		// 七牛
    Alibaba,	// 阿裡雲
    Tencent		// 騰訊雲
}

在使用過程中，根據需要使用的OSS存儲服務獲取OSS對象，即可調用方法進行文件上傳，下麵將逐步說明。

一、獲取OSS對象

首先，根據我們準備使用的OSS存儲服務類型，獲取對應的OSS操作對象。

IOssProvider oss = Xmtool.Oss(OssProvider.Qiniu);
// TODO

二、初始化配置

OSS操作對象，必須進行初始化配置才能進行文件上傳操作，不同的存儲服務類型配置參數略有不同，下麵將一一說明。

1. 七牛存儲服務初始化配置

IOssProvider oss = Xmtool.Oss(OssProvider.Qiniu);
oss.Config("替換成自己的AppKey", "替換成自己的AppSecret", "替換成自己的功能變數名稱地址");
// TODO

2.阿裡雲存儲服務初始化配置

IOssProvider oss = Xmtool.Oss(OssProvider.Alibaba);
oss.Config("替換成自己的AppKey", "替換成自己的AppSecret", "替換成自己的功能變數名稱地址", "替換成存儲桶對應的EndPoint地址");
// TODO

3.騰訊雲存儲服務初始化配置

IOssProvider oss = Xmtool.Oss(OssProvider.Tencent);
oss.Config("替換成自己的AppId", "替換成自己的SecretId", "替換成自己的SecretKey", "替換成自己的功能變數名稱地址", "替換成存儲桶對應的Region簡稱");
// TODO

三、上傳本地文件

經過上一步的初始化配製後，就可以進行文件上傳操作了；類庫支持文件路徑和文件流兩種上傳方式。

通過文件路徑上傳，方法如下：

IOssProvider oss = Xmtool.Oss(OssProvider.Qiniu);
oss.Config("替換成自己的AppKey", "替換成自己的AppSecret", "替換成自己的功能變數名稱地址");
string url = oss.UploadFile("替換成自己的存儲桶名稱", "要上傳的本地文件路徑", "上傳到伺服器的文件key，如果不傳將隨機生成");
// 返回的url即是上傳成功後的文件訪問地址，是否可公開訪問根據存儲桶的訪問許可權設定。
// TODO 

四、上傳文件流

通過文件流上傳，方法如下：

IOssProvider oss = Xmtool.Oss(OssProvider.Qiniu);
oss.Config("替換成自己的AppKey", "替換成自己的AppSecret", "替換成自己的功能變數名稱地址");
using (FileStream stream = new FileStream("要上傳的本地文件路徑", FileMode.Open))
{
    string url = oss.UploadStream("替換成自己的存儲桶名稱", stream, "上傳到伺服器的文件key，如果不傳將隨機生成");
	// TODO
}

五、設置上傳文件ContentType

在上傳文件時，如果不指定ContentType，除七牛會自動判斷上傳文件類型外，阿裡雲和騰訊雲都會將文件預設成二進位流文件，這在後面的訪問過程中會影響文件的預覽等操作。因此，我們可以在上傳時明確指定文件的類型。

IOssProvider oss = Xmtool.Oss(OssProvider.Qiniu);
oss.Config("替換成自己的AppKey", "替換成自己的AppSecret", "替換成自己的功能變數名稱地址");
string url = oss.SetContentType("image/png")
    .UploadFile("替換成自己的存儲桶名稱", "要上傳的本地文件路徑", "上傳到伺服器的文件key，如果不傳將隨機生成");
// TODO 

六、是否使用HTTPS

IOssProvider oss = Xmtool.Oss(OssProvider.Qiniu);
oss.Config("替換成自己的AppKey", "替換成自己的AppSecret", "替換成自己的功能變數名稱地址");
oss.SetUseHttps(true);
// TODO