Asp.Net Core Web Api图片上传及MongoDB存储实例教程(一)
圖片或者文件上傳相信大家在開發中應該都會用到吧,有的時候還要對圖片生成縮略圖。那么如何在Asp.Net Core Web Api實現圖片上傳存儲以及生成縮略圖呢?今天我就使用MongoDB作為圖片存儲,然后使用SixLabors作為圖片處理,通過一個Asp.Net Core Web Api實例來給大家講解下!本文有點長,可以先收藏推薦然后再看!
本文地址:https://www.cnblogs.com/yilezhu/p/9297009.html
寫在前面
閱讀本文章,需要你具備asp.net core的基礎知識,至少能夠創建一個Asp.Net Core Web Api項目吧!其次,我不會跟你說MongoDB是什么以及為什么選擇MongoDB作為文件存儲這樣的問題,因為百度百科已經給你說了, MongoDB 是一個基于分布式文件存儲的數據庫。實在不清楚的話自己去看百度百科吧!
MongoDB在Windows下的下載安裝以及配置
你可以從MongoDB官網下載安裝。下載地址:https://www.mongodb.com/download-center#community?。如下圖所示:
下載之后一路next基本就能完成。當然還是給新手朋友一些圖文操作吧。已經會安裝的朋友可以跳過這一節往下看。
一路next,然后安裝出現最后安裝成功的界面,點擊Finish即可。
然后,Win+R 運行,輸入services.msc 然后輸入Enter鍵。打開如下的服務窗口
雙擊上面圈起來的MongoDB服務,可以看到如下參數命令
上面表示,MongoDB作為服務的方式進行啟動,并且按照 --Config后面的路徑里面的配置文件里的配置進行啟動。
我們找到這個配置文件,并打開看下吧!
你可以重新設置參數后,然后重新啟動服務即可生效!
最后,讓我們瀏覽器打開上面設置的IP以及端口號查看一下,如下圖所示,表示MongoDB安裝成功!
Asp.Net Core Web Api圖片上傳的代碼實現
新建Asp.Net Core Web Api項目
這里我不會教你怎么創建一個Asp.Net Core Web Api項目了。創建好后會出現如下圖所示的結構
安裝MongoDB的nuget包以及SixLabors圖片處理的包
Install-Package MongoDB.Bson -Version 2.7.0Install-Package MongoDB.Driver -Version 2.7.0Install-Package SixLabors.ImageSharp -Version 1.0.0-beta0004Install-Package SixLabors.ImageSharp.Drawing -Version 1.0.0-beta0004在appsettings.json中加入MongoDBHost的配置,如下所示,端口以及ip上面我們已經配置過了
{"Logging": {"LogLevel": {"Default": "Warning"}},"MongodbHost": {"Connection": "mongodb://127.0.0.1:27017","DataBase": "File_Server","Table": ""},"PictureOptions": {"FileTypes": ".gif,.jpg,.jpeg,.png,.bmp,.GIF,.JPG,.JPEG,.PNG,.BMP","MaxSize": 1048576,"ThumsizeW": 200,"ThumsizeH": 140,"MakeThumbnail": true,"ThumbnailGuidKeys": "yilezhu","ImageBaseUrl": "http://localhost:5002/api/Picture/Show/"} }既然有了配置,肯定要創建對應的Options了。MongodbHostOptions以及PictureOptions的代碼如下所示:
服務注冊中進行注入
新建一個PictureController用來作為圖片上傳的api,里面包含圖片上傳接口,刪除接口,以及顯示接口,上傳接受一個base64的圖片字符串,然后生成縮略圖,然后存儲到MongoDB數據庫中,全部代碼如下所示:
using System;using System.Collections.Generic;using System.IO;using System.Linq;using System.Text;using System.Threading.Tasks;using Microsoft.AspNetCore.Http;using Microsoft.AspNetCore.Mvc;using Microsoft.Extensions.Options;using MongoDBDemo.Dtos;using MongoDBDemo.Helper;using MongoDBDemo.Models;using MongoDBDemo.Options;using MongoDBDemo.Result;namespace MongoDBDemo.Controllers{ ? ?/// <summary>/// yilezhu/// 2018.7.10/// 圖片操作相關接口/// </summary>public class PictureController : BaseController{ ? ? ? ?// MongodbHost信息private readonly MongodbHostOptions _mongodbHostOptions; ? ? ? ?// 圖片選項private readonly PictureOptions _pictureOptions; ? ? ? ?/// <summary>/// 構造函數注入/// </summary>/// <param name="mongodbHostOptions">MongodbHost信息</param>/// <param name="pictureOptions">圖片選項</param>public PictureController(IOptions<MongodbHostOptions> mongodbHostOptions, IOptions<PictureOptions> pictureOptions) ? ? ? ?{_mongodbHostOptions = mongodbHostOptions.Value;_pictureOptions = pictureOptions.Value;} ? ? ? ?/// <summary>/// 接口上傳圖片方法/// </summary>/// <param name="fileDtos">文件傳輸對象,傳過來的json數據</param>/// <returns>上傳結果</returns>[HttpPost] ? ? ? ?public async Task<UploadResult> Post([FromBody] FileDtos fileDtos) ? ? ? ?{UploadResult result = new UploadResult(); ? ? ? ? ? ?if (ModelState.IsValid){ ? ? ? ? ? ? ? ?//首先根據api參數判斷是否為圖片類型,是則處理,不是則返回對應的結果if (!string.IsNullOrEmpty(fileDtos.Type) && fileDtos.Type.ToLower() == "image"){ ? ? ? ? ? ? ? ? ? ?//文件類型string FileEextension = Path.GetExtension(fileDtos.Filename).ToLower();//獲取文件的后綴//判斷文件類型是否是允許的類型if (_pictureOptions.FileTypes.Split(',').Contains(FileEextension)){ ? ? ? ? ? ? ? ? ? ? ? ?//圖片類型是允許的類型Images_Mes fmster = new Images_Mes();//圖片存儲信息類,跟MongoDB里面表名一致string fguid = Guid.NewGuid().ToString().Replace("-",""); //文件名稱fmster.AddTime = DateTimeOffset.Now;//添加時間為當前時間fmster.AddUser = "server";//具體根據你的業務來獲取if (Base64Helper.IsBase64String(fileDtos.Base64String, out byte[] fmsterByte)){ ? ? ? ? ? ? ? ? ? ? ? ? ? ?//判斷是否是base64字符串,如果是則轉換為字節數組,用來保存fmster.FileCon = fmsterByte;}fmster.FileName = Path.GetFileName(fileDtos.Filename);//文件名稱fmster.FileSize = fmster.FileCon.Length;//文件大小fmster.FileType = FileEextension;//文件擴展名fmster.GuidID = fguid;//唯一主鍵,通過此來獲取圖片數據await MongodbHelper<Images_Mes>.AddAsync(_mongodbHostOptions, fmster);//上傳文件到mongodb服務器//檢查是否需要生產縮略圖if (_pictureOptions.MakeThumbnail){ ? ? ? ? ? ? ? ? ? ? ? ? ? ?//生成縮略圖Images_Mes fthum = new Images_Mes();fthum.AddTime = DateTimeOffset.Now;fthum.AddUser = "server";//具體根據你的業務來獲取fthum.FileCon = ImageHelper.GetReducedImage(fmster.FileCon, _pictureOptions.ThumsizeW, _pictureOptions.ThumsizeH);fthum.FileName = Path.GetFileNameWithoutExtension(fileDtos.Filename) + "_thumbnail" + Path.GetExtension(fileDtos.Filename);//生成縮略圖的名稱fthum.FileSize = fthum.FileCon.Length;//縮略圖大小fthum.FileType = FileEextension;//縮略圖擴展名fthum.GuidID = fguid + _pictureOptions.ThumbnailGuidKeys;//為了方面,縮略圖的主鍵為主圖主鍵+一個字符yilezhu作為主鍵await MongodbHelper<Images_Mes>.AddAsync(_mongodbHostOptions, fthum);//上傳縮略圖到mongodb服務器}result.Errcode = ResultCodeAddMsgKeys.CommonObjectSuccessCode;result.Errmsg = ResultCodeAddMsgKeys.CommonObjectSuccessMsg;UploadEntity entity = new UploadEntity();entity.Picguid = fguid;entity.Originalurl = _pictureOptions.ImageBaseUrl + fguid;entity.Thumburl = _pictureOptions.ImageBaseUrl + fguid + _pictureOptions.ThumbnailGuidKeys;result.Data = entity; ? ? ? ? ? ? ? ? ? ? ? ?return result;} ? ? ? ? ? ? ? ? ? ?else{ ? ? ? ? ? ? ? ? ? ? ? ?//圖片類型不是允許的類型result.Errcode = ResultCodeAddMsgKeys.HttpFileInvalidCode;//對應的編碼result.Errmsg = ResultCodeAddMsgKeys.HttpFileInvalidMsg;//對應的錯誤信息result.Data = null;//數據為nullreturn result;}} ? ? ? ? ? ? ? ?else{result.Errcode = ResultCodeAddMsgKeys.HttpFileNotFoundCode;result.Errmsg = ResultCodeAddMsgKeys.HttpFileNotFoundMsg;result.Data = null; ? ? ? ? ? ? ? ? ? ?return result;} ? ? ? ? ? ? ? ?} ? ? ? ? ? ?else{ ? ? ? ? ? ? ? ?StringBuilder errinfo = new StringBuilder(); ? ? ? ? ? ? ? ?foreach (var s in ModelState.Values){ ? ? ? ? ? ? ? ? ? ?foreach (var p in s.Errors){errinfo.AppendFormat("{0}||", p.ErrorMessage);}}result.Errcode = ResultCodeAddMsgKeys.CommonModelStateInvalidCode;result.Errmsg = errinfo.ToString();result.Data = null; ? ? ? ? ? ? ? ?return result; ? ? ? ? ? ? ? ?}} ? ? ? ?/// <summary>/// 刪除圖片/// </summary>/// <param name="guid">原始圖片主鍵</param>/// <returns>執行結果</returns>[HttpDelete("{guid}")] ? ? ? ?public async Task<BaseResult> Delete(string guid) ? ? ? ?{ ? ? ? ? ? ?await MongodbHelper<Images_Mes>.DeleteAsync(_mongodbHostOptions, guid);//刪除mongodb服務器上對應的文件await MongodbHelper<Images_Mes>.DeleteAsync(_mongodbHostOptions, guid + _pictureOptions.ThumbnailGuidKeys);//刪除mongodb服務器上對應的文件return new BaseResult(ResultCodeAddMsgKeys.CommonObjectSuccessCode, ResultCodeAddMsgKeys.CommonObjectSuccessMsg);} ? ? ? ?/// <summary>/// 返回圖片對象/// </summary>/// <param name="guid">圖片的主鍵</param>/// <returns>圖片對象</returns>[Route("Show/{guid}")][HttpGet] ? ? ? ?public async Task<FileResult> ShowAsync(string guid) ? ? ? ?{ ? ? ? ? ? ?if (string.IsNullOrEmpty(guid)){ ? ? ? ? ? ? ? ?return null;}FilterDefinition<Images_Mes> filter = Builders<Images_Mes>.Filter.Eq("GuidID", guid); ? ? ? ? ? ?var result= await MongodbHelper<Images_Mes>.FindListAsync(_mongodbHostOptions, filter); ? ? ? ? ? ?if (result != null && result.Count > 0){ ? ? ? ? ? ? ? ?return File(result[0].FileCon, "image/jpeg", result[0].FileName);} ? ? ? ? ? ?else{ ? ? ? ? ? ? ? ?return null;}}} }下面我們先連接下MongoDB看下里面內容如下:
win7系統MongoDB操作軟件顯示有點問題,將就將就吧!
打開Postman進行圖片上傳操作,方法選擇“Post”,參數格式選擇json,然后輸入對應的參數格式,如下圖所示,都有標注,相信你都能看懂:
參數輸入完畢之后,最后點擊右側的“Send”按鈕進行測試,看到如下所示的返回結果:
我們接下來利用工具查詢下MongoDB,看看有沒有生成對應的數據庫以及Collections如下圖所示,可以看到生成了我們定義的File_Server數據庫以及Images_Mes集合
查詢下看看里面的數據可以看到里面的數據正是結果返回的數據,說明我們的結果是正確的,如下所示:
最后應該打開瀏覽器,然后輸入圖片地址,瀏覽器就會自動下載圖片了,效果如下所示:
總結
教程已經寫完了,細心地朋友應該能夠看到,大部分代碼都是昨天晚上寫的,今天晚上又稍加修改完成的!一篇文章足足消耗了兩個晚上,希望大家能多多支持!
總結中說了一句廢話!莫怪啊!本篇文章首先介紹了MongoDB的安裝,然后創建了一個新的Asp.Net Core Web Api項目,然后通過一個圖片上傳的實例來講述了Asp.Net Core中圖片上傳的操作,以及MongoDB作為圖片存儲的實現!當然中間用到了圖片縮略圖的生成,最后寫了一個簡單地圖片展示。希望本篇關于Asp.Net Core Web Api圖片上傳及MongoDB存儲的實例教程能對大家使用Asp.Net Core Web Api進行圖片上傳以及MongoDB的使用有多幫助!
最后,還是希望大家多多推薦,多多支持!下面我會繼續完善下代碼,加入IdentityServer認證,以及SwaggerUI實現接口文檔,但是Ocelot網關技術以及consul實現服務發現以及故障的郵件發送等等功能就不在此項目代碼中應用了!
原文地址:https://www.cnblogs.com/yilezhu/p/9297009.html
.NET社區新聞,深度好文,歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結
以上是生活随笔為你收集整理的Asp.Net Core Web Api图片上传及MongoDB存储实例教程(一)的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Identity Server 4 -
- 下一篇: System.IO.Pipelines: