Asp.Net Core Web Api图片上传(一)集成MongoDB存储实例教程

本文涉及的产品
云数据库 MongoDB,通用型 2核4GB
简介: Asp.Net Core Web Api图片上传及MongoDB存储实例教程(一)图片或者文件上传相信大家在开发中应该都会用到吧,有的时候还要对图片生成缩略图。那么如何在Asp.Net Core Web Api实现图片上传存储以及生成缩略图呢?今天我就使用MongoDB作为图片存储,然后使用SixLabors作为图片处理,通过一个Asp.

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
作者:yilezhu

写在前面

阅读本文章,需要你具备asp.net core的基础知识,至少能够创建一个Asp.Net Core Web Api项目吧!其次,我不会跟你说MongoDB是什么以及为什么选择MongoDB作为文件存储这样的问题,因为百度百科已经给你说了, MongoDB 是一个基于分布式文件存储的数据库。实在不清楚的话自己去看百度百科吧!

MongoDB在Windows下的下载安装以及配置

你可以从MongoDB官网下载安装。下载地址:https://www.mongodb.com/download-center#community 。如下图所示:

MongoDB下载

下载之后一路next基本就能完成。当然还是给新手朋友一些图文操作吧。已经会安装的朋友可以跳过这一节往下看。

MongoDB安装

MongoDB服务配置

一路next,然后安装出现最后安装成功的界面,点击Finish即可。

MongoDB安装完成

然后,Win+R 运行,输入services.msc 然后输入Enter键。打开如下的服务窗口

MongoDB服务
双击上面圈起来的MongoDB服务,可以看到如下参数命令

MongoDB启动参数

"C:\Program Files\MongoDB\Server\4.0\bin\mongod.exe" --config "C:\Program Files\MongoDB\Server\4.0\bin\mongod.cfg" --service

上面表示,MongoDB作为服务的方式进行启动,并且按照 --Config后面的路径里面的配置文件里的配置进行启动。

我们找到这个配置文件,并打开看下吧!

MongoDB配置

你可以重新设置参数后,然后重新启动服务即可生效!
最后,让我们浏览器打开上面设置的IP以及端口号查看一下,如下图所示,表示MongoDB安装成功!

MongoDB安装成功

Asp.Net Core Web Api图片上传的代码实现

  1. 新建Asp.Net Core Web Api项目
    这里我不会教你怎么创建一个Asp.Net Core Web Api项目了。创建好后会出现如下图所示的结构

目录结构

  1. 安装MongoDB的nuget包以及SixLabors图片处理的包

    Install-Package MongoDB.Bson -Version 2.7.0
    Install-Package MongoDB.Driver -Version 2.7.0
    Install-Package SixLabors.ImageSharp -Version 1.0.0-beta0004
    Install-Package SixLabors.ImageSharp.Drawing -Version 1.0.0-beta0004
  2. 在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/"
      }
    }
    
  3. 既然有了配置,肯定要创建对应的Options了。MongodbHostOptions以及PictureOptions的代码如下所示:

   public class MongodbHostOptions
    {
        /// <summary>
        /// 连接字符串
        /// </summary>
        public string Connection { get; set; }
        /// <summary>
        /// 库
        /// </summary>
        public string DataBase { get; set; }
        /// <summary>
        /// 表
        /// </summary>
        public string Table { get; set; }
    }

    public class PictureOptions
    {
        /// <summary>
        /// 允许的文件类型
        /// </summary>
        public string FileTypes { get; set; }
        /// <summary>
        /// 最大文件大小
        /// </summary>
        public int MaxSize { get; set; }
        /// <summary>
        /// 缩略图宽度
        /// </summary>
        public int ThumsizeW { get; set; }
        /// <summary>
        /// 缩略图高度
        /// </summary>
        public int ThumsizeH { get; set; }
        /// <summary>
        /// 是否缩略图
        /// </summary>
        public bool MakeThumbnail { get; set; }
        /// <summary>
        /// 图片的基地址
        /// </summary>
        public string ImageBaseUrl { get; set; }
    }
  1. 服务注册中进行注入
//MongodbHost信息
services.Configure<MongodbHostOptions>(Configuration.GetSection("MongodbHost"));
//图片选项
services.Configure<PictureOptions>(Configuration.GetSection("PictureOptions"));
  1. 新建一个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)
                {
                    #region  验证通过
                    //首先根据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;//数据为null
                            return result;
                        }
    
                    }
                    else
                    {
                        result.Errcode = ResultCodeAddMsgKeys.HttpFileNotFoundCode;
                        result.Errmsg = ResultCodeAddMsgKeys.HttpFileNotFoundMsg;
                        result.Data = null;
                        return result;
                    }
                    #endregion
                }
                else
                {
                    #region 验证不通过
                    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;
                    #endregion
                }
            }
    
            /// <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;
                }
    
            }
        }
    }
    1. 下面我们先连接下MongoDB看下里面内容如下:

      win7系统MongoDB操作软件显示有点问题,将就将就吧!

      MongoDB数据库

  2. 打开Postman进行图片上传操作,方法选择“Post”,参数格式选择json,然后输入对应的参数格式,如下图所示,都有标注,相信你都能看懂:

    PostMan测试

  3. 参数输入完毕之后,最后点击右侧的“Send”按钮进行测试,看到如下所示的返回结果:

Postman测试结果

  1. 我们接下来利用工具查询下MongoDB,看看有没有生成对应的数据库以及Collections如下图所示,可以看到生成了我们定义的File_Server数据库以及Images_Mes集合

    执行后的MongoDB数据库

  2. 查询下看看里面的数据可以看到里面的数据正是结果返回的数据,说明我们的结果是正确的,如下所示:

    MongoDB查询结果

  3. 最后应该打开浏览器,然后输入图片地址,浏览器就会自动下载图片了,效果如下所示:

    浏览器打开图片

    示例代码

    [点我下载][https://github.com/yilezhu/ImageUploadApiDemo]

总结

教程已经写完了,细心地朋友应该能够看到,大部分代码都是昨天晚上写的,今天晚上又稍加修改完成的!一篇文章足足消耗了两个晚上,希望大家能多多支持!
总结中说了一句废话!莫怪啊!本篇文章首先介绍了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实现服务发现以及故障的邮件发送等等功能就不在此项目代码中应用了!

如果您认为这篇文章还不错或者有所收获,您可以点击右下角的【推荐】按钮精神支持,因为这种支持是我继续写作,分享的最大动力!
作者:yilezhu(依乐祝).NET Core实战项目交流群:637326624
声明:原创博客请在转载时保留原文链接或者在文章开头加上本人博客地址,如发现错误,欢迎批评指正。凡是转载于本人的文章,不能设置打赏功能,如有特殊需求请与本人联系!另如需修改文章内容请与本人联系。微信账号:jkingzhu
相关实践学习
MongoDB数据库入门
MongoDB数据库入门实验。
快速掌握 MongoDB 数据库
本课程主要讲解MongoDB数据库的基本知识,包括MongoDB数据库的安装、配置、服务的启动、数据的CRUD操作函数使用、MongoDB索引的使用(唯一索引、地理索引、过期索引、全文索引等)、MapReduce操作实现、用户管理、Java对MongoDB的操作支持(基于2.x驱动与3.x驱动的完全讲解)。 通过学习此课程,读者将具备MongoDB数据库的开发能力,并且能够使用MongoDB进行项目开发。 &nbsp; 相关的阿里云产品:云数据库 MongoDB版 云数据库MongoDB版支持ReplicaSet和Sharding两种部署架构,具备安全审计,时间点备份等多项企业能力。在互联网、物联网、游戏、金融等领域被广泛采用。 云数据库MongoDB版(ApsaraDB for MongoDB)完全兼容MongoDB协议,基于飞天分布式系统和高可靠存储引擎,提供多节点高可用架构、弹性扩容、容灾、备份回滚、性能优化等解决方案。 产品详情: https://www.aliyun.com/product/mongodb
目录
相关文章
|
5天前
|
开发框架 监控 .NET
Visual Basic的Web服务和REST API开发指南
【4月更文挑战第27天】本文探讨了使用Visual Basic(VB.NET)构建Web服务和RESTful API的方法。首先介绍了Web服务的基础和REST API的概念,然后阐述了.NET Framework与.NET Core/.NET 5+对VB.NET的支持,以及ASP.NET Core在Web开发中的作用。接着,详细讲解了创建RESTful API的步骤,包括控制器与路由设置、模型绑定与验证,以及返回响应。此外,还讨论了安全措施、测试方法、部署选项和监控策略。最后强调,VB.NET开发者可以通过ASP.NET Core涉足现代Web服务开发,拓宽技术领域。
|
5天前
|
IDE Java API
使用Java Web技术构建RESTful API的实践指南
使用Java Web技术构建RESTful API的实践指南
|
5天前
|
弹性计算 JSON Shell
基于Web API的自动化信息收集和整理
【4月更文挑战第30天】
20 0
|
2天前
|
缓存 监控 API
利用Python构建高性能的Web API后端服务
随着微服务架构的普及和RESTful API的广泛应用,构建高性能、可扩展的Web API后端服务变得尤为重要。本文将探讨如何利用Python这一强大且灵活的语言,结合现代Web框架和工具,构建高效、可靠的Web API后端服务。我们将分析Python在Web开发中的优势,介绍常用的Web框架,并通过实际案例展示如何设计并实现高性能的API服务。
|
5天前
|
JSON 安全 API
【专栏】四种REST API身份验证方法:基本认证、OAuth、JSON Web Token(JWT)和API密钥
【4月更文挑战第28天】本文探讨了四种REST API身份验证方法:基本认证、OAuth、JSON Web Token(JWT)和API密钥。基本认证简单但不安全;OAuth适用于授权第三方应用;JWT提供安全的身份验证信息传递;API密钥适合内部使用。选择方法时需平衡安全性、用户体验和开发复杂性。
|
5天前
|
缓存 前端开发 API
toapi,一个强大的 Python Web API库!
toapi,一个强大的 Python Web API库!
29 5
|
5天前
|
开发框架 前端开发 JavaScript
JavaScript云LIS系统源码ASP.NET CORE 3.1 MVC + SQLserver + Redis医院实验室信息系统源码 医院云LIS系统源码
实验室信息系统(Laboratory Information System,缩写LIS)是一类用来处理实验室过程信息的软件,云LIS系统围绕临床,云LIS系统将与云HIS系统建立起高度的业务整合,以体现“以病人为中心”的设计理念,优化就诊流程,方便患者就医。
23 0
|
5天前
|
JSON API 数据库
解释如何在 Python 中实现 Web 服务(RESTful API)。
在Python中实现Web服务(RESTful API)涉及选择框架(如Flask、Django、FastAPI),定义路由及处理函数(对应HTTP请求方法),处理请求,构建响应和启动服务器。以下是一个使用Flask的简单示例:定义用户列表,通过`@app.route`装饰器设置GET和POST请求处理函数,返回JSON响应,并用`app.run()`启动服务器。实际API会包含更复杂的逻辑和错误处理。
17 1
|
5天前
|
XML JSON API
通过Flask框架创建灵活的、可扩展的Web Restful API服务
通过Flask框架创建灵活的、可扩展的Web Restful API服务
|
5天前
|
缓存 监控 API
Python Web框架FastAPI——一个比Flask和Tornada更高性能的API框架
Python Web框架FastAPI——一个比Flask和Tornada更高性能的API框架
63 0