asp.net core集成MongoDB

0、目录


 整体架构目录:ASP.NET Core分布式项目实战-目录

 

一、前言及MongoDB的介绍


 最近在整合自己的框架,顺便把MongoDBD的最简单CRUD重构一下作为组件化集成到asp.net core项目中,当然此篇文章中没有讲解mongodb的集群部署,等有机会分享一下。

针对MongoDB,我想大家应该不陌生,没有用过也有听过。

1、mongodb是什么?

MongoDB是一个基于分布式文件存储的数据库,为web应用提供可扩展的高性能数据存储解决方案,介于关系型数据库和非关系型数据库的产品,是非关系型数据库中功能最丰富的。针对于数据处理是一把利器。

2、什么是关系型数据库和非关系型数据库?

关系型数据库:在我们所用过的sqlserver、mysql等,这些都是关系型数据库,并且关系型数据库是遵循ACID原则的,严格的一致性。

非关系型数据库:也叫作NoSQL,用与超大规模数据的存储,这些类型的数据存储不需要固定的模式,无需多余的操作就可以横向扩展。

3、RDBMS VS NoSQL

RDBMS:

  高度组织结构化数据

  结构化查询语言

  数据和关系都存储在单独的表中

  严格一致性

  基础事务

 

NoSQL:

  没有声明性查询语言

  键-值对存储,列存储、文档存储等

  最终一致性

  非结构化和不可预知数据

  CAP定理、高可用、高性能、高扩展

 

我相信讲到这里,眼尖的同学应该有注意到 CAP定理和最终一致性,肯定会联想到 分布式系统,在这里给你大大的一个赞。在分布式系统中可以完美的结合nosql,提高我们的性能。

 

4、介绍一下RDBMS与Mongodb的一些概念,有助于帮助大家理解

 

翻译一下,即如下:

 

 

 

二、asp.net core集成mongoDB


 1、为了演示方便我下载了 windows版本的mongodb server

大家可以自行去官网下载,然后针对于可视化界面,我采用了 Robo 3T 这个工具。很简洁美观的可视化工具。推荐大家使用。

安装结束后会在windows服务中看到mongodb server

 

然后我们打开一下Robo 3T,连接我们的mongodb。

 

2、开始在项目中配置一下我们的mongodb吧

第一步:我新建一个Core2.0类库

引入了 “MongoDB.Driver” 这个nuget包。

然后扩展了 Startup.cs 中的Services的扩展方法

//扩展方法
public
static class ServiceCollectionExtensions { public static void AddMongoDB(this IServiceCollection services, IConfiguration configuration) { services.Configure<Settings>(options => { options.ConnectionString = configuration.GetSection("MongoConnection:ConnectionString").Value; options.Database = configuration.GetSection("MongoConnection:Database").Value; }); } }

 

第二步:重构封装了mongodb的CRUD类,此处大家可以自行封装,只展示了查找和新增。

public class MongoDBBase
    {
        private readonly IMongoDatabase _database = null;
        public MongoDBBase(string connectionString, string databaseName)
        {
            var client = new MongoClient(connectionString);
            if (client != null)
            {
                _database = client.GetDatabase(databaseName);
            }
        }

        #region SELECT
        /// <summary>
        /// 根据查询条件,获取数据
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="id"></param>
        /// <returns></returns>
        public List<T> GetList<T>(Expression<Func<T, bool>> conditions = null)
        {
            var collection = _database.GetCollection<T>(typeof(T).Name);
            if (conditions != null)
            {
                return collection.Find(conditions).ToList();
            }
            return collection.Find(_ => true).ToList();
        }#endregion

        #region INSERT/// <summary>
        /// 插入多条数据,数据用list表示
        /// </summary>
        /// <typeparam name="T"></typeparam>
        /// <param name="list"></param>
        /// <returns></returns>
        public List<T> InsertMany<T>(List<T> list)
        {
            var collection = _database.GetCollection<T>(typeof(T).Name);
            collection.InsertMany(list);
            return list;
        }
        #endregion
    }

 

第三步:新建一个asp.net core webapi 项目,引用此类库进行演示

在项目中的 appsetting.json 添加 mongodb的连接字符串:我在这边使用自定义的一个数据名称 testdb,在插入mongodb的时候会会自动在创建数据库和集合以及文档。接着往下看

  "MongoConnection": { //mongodb数据库连接
    "ConnectionString": "mongodb://127.0.0.1:27017",
    "Database": "testdb",
    "IsSSL": true
  },

 

第四步:新建一个mongodb测试控制器,展示了插入单条和多条以及查询的接口。


    [Produces("application/json")]
    [Route("api/MongoDB/[action]")]
    public class MongoDBController : Controller
    {
        private readonly MongoDBBase _context = null;
        public MongoDBController(IOptions<Settings> settings)
        {
            _context = new MongoDBBase(settings.Value.ConnectionString, settings.Value.Database);
        }
        [HttpGet]
        public IActionResult AddList()
        {
            List<MongoDBPostTest> list = new List<MongoDBPostTest>()
            {
                new MongoDBPostTest()
                {
                    Id = "2",
                    Body = "Test note 3",
                    UpdatedOn = DateTime.Now,
                    UserId = 1,
                    HeaderImage = new NoteImage
                    {
                        ImageSize = 10,
                        Url = "http://localhost/image1.png",
                        ThumbnailUrl = "http://localhost/image1_small.png"
                    }
                },
                new MongoDBPostTest()
                {
                    Id = "3",
                    Body = "Test note 4",
                    UpdatedOn = DateTime.Now,
                    UserId = 1,
                    HeaderImage = new NoteImage
                    {
                        ImageSize = 14,
                        Url = "http://localhost/image3.png",
                        ThumbnailUrl = "http://localhost/image3_small.png"
                    }
                }
            };

            try
            {
                _context.InsertMany(list);
            }
            catch (Exception ex)
            {

                throw;
            }

            return Ok("成功");
        }

        [HttpGet]
        public Result<List<MongoDBPostTest>> SelectSingle()
        {
            //无条件
            var list = _context.GetList<MongoDBPostTest>();

            //有条件
            //var list = _context.GetList<MongoDBPostTest>(a => a.Id == "1");

            //得到单条数据,无条件
            //var list = _context.GetSingle<MongoDBPostTest>();

            //得到单条数据,有条件
            //var list = _context.GetSingle<MongoDBPostTest>(a => a.Id == "3");

            ObjectId internalId = _context.GetInternalId("5bbf41651d3b66668cbb5bfc");

            var a = _context.GetSingle<MongoDBPostTest>(note => note.Id == "5bbf41651d3b66668cbb5bfc" || note.InternalId == internalId);

            return ResHelper.Suc(1, list, "成功");
        }
}

MongoDBController

 

测试类


public class MongoDBPostTest
    {
        [BsonId]
        // standard BSonId generated by MongoDb
        public ObjectId InternalId { get; set; }
        public string Id { get; set; }

        public string Body { get; set; } = string.Empty;

        [BsonDateTimeOptions]
        public DateTime UpdatedOn { get; set; } = DateTime.Now;

        public NoteImage HeaderImage { get; set; }

        public int UserId { get; set; } = 0;
    }

public class NoteImage
    {
        public string Url { get; set; } = string.Empty;
        public string ThumbnailUrl { get; set; } = string.Empty;
        public long ImageSize { get; set; } = 0L;
    }

MongoDBPostTest

 

第五步:运行项目,执行一下。

我们执行一下插入多条的数据吧,执行成功。

 

然后我们看一下数据库,发现已经生成了一个  testdb 数据库,里面包含了我们的数据内容

 

然后我们执行以下查的操作:把我们刚才插入的数据返回回来了。

 

注意:这边有一个坑有待解决,就是mongodb存储的时间是UTC,会跟我们的本地时间相差8个小时。因此这边需要特殊处理一下时间。

 

三、总结


至此,mongodb的简单运用已演示完毕,后期大家根据官方文档可进行扩展,越扩展到后面,会觉得越来越有意思。感谢大家的支持。Thank you。

 

参考文档:

mongodb教程:http://www.runoob.com/mongodb/mongodb-tutorial.html

mongodb中文手册:http://www.mongoing.com/docs/

 

asp.net Core 交流群:787464275 欢迎加群交流
如果您认为这篇文章还不错或者有所收获,您可以点击右下角的【推荐】按钮精神支持,因为这种支持是我继续写作,分享的最大动力!

作者:LouieGuo
声明:原创博客请在转载时保留原文链接或者在文章开头加上本人博客地址,如发现错误,欢迎批评指正。凡是转载于本人的文章,不能设置打赏功能,如有特殊需求请与本人联系!

微信公众号:欢迎关注                                                 QQ技术交流群: 欢迎加群