一、前言及MongoDB的介绍
最近在整合自己的框架,顺便把MongoDBD的最简单CRUD重构一下作为组件化集成到asp.net core项目中,当然此篇文章中没有讲解mongodb的集群部署,等有机会分享一下。
本文来自zvvq
首先,我们在MongoDB的官方文档中看到,MongoDb的2.4以上的For .Net的驱动是支持.Net Core 2.0的。 zvvq.cn
内容来自samhan
针对MongoDB,我想大家应该不陌生,没有用过也有听过。
1、mongodb是什么?
内容来自samhan
MongoDB是一个基于分布式文件存储的数据库,为web应用提供可扩展的高性能数据存储解决方案,介于关系型数据库和非关系型数据库的产品,是非关系型数据库中功能最丰富的。针对于数据处理是一把利器。 内容来自samhan666
2、什么是关系型数据库和非关系型数据库? 内容来自zvvq,别采集哟
关系型数据库:在我们所用过的sqlserver、mysql等,这些都是关系型数据库,并且关系型数据库是遵循ACID原则的,严格的一致性。
非关系型数据库:也叫作NoSQL,用与超大规模数据的存储,这些类型的数据存储不需要固定的模式,无需多余的操作就可以横向扩展。
3、RDBMS VS NoSQL
内容来自zvvq,别采集哟
RDBMS: 内容来自zvvq
高度组织结构化数据 zvvq好,好zvvq
结构化查询语言
内容来自zvvq,别采集哟
数据和关系都存储在单独的表中 内容来自samhan666
严格一致性
基础事务 内容来自samhan
NoSQL: zvvq
没有声明性查询语言 内容来自zvvq,别采集哟
键-值对存储,列存储、文档存储等 zvvq好,好zvvq
最终一致性 内容来自zvvq,别采集哟
非结构化和不可预知数据 内容来自zvvq
CAP定理、高可用、高性能、高扩展 zvvq好,好zvvq
我相信讲到这里,眼尖的同学应该有注意到 CAP定理和最终一致性,肯定会联想到 分布式系统,在这里给你大大的一个赞。在分布式系统中可以完美的结合nosql,提高我们的性能。
4、介绍一下RDBMS与Mongodb的一些概念,有助于帮助大家理解 zvvq.cn
zvvq好,好zvvq
翻译一下,即如下:
本文来自zvvq
二、asp.net core集成mongoDB 本文来自zvvq
1、为了演示方便我下载了 windows版本的mongodb server 内容来自samhan
大家可以自行去官网下载,然后针对于可视化界面,我采用了 Robo 3T 这个工具。很简洁美观的可视化工具。推荐大家使用。 内容来自samhan
安装结束后会在windows服务中看到mongodb server
内容来自zvvq,别采集哟
然后我们打开一下Robo 3T,连接我们的mongodb。 zvvq.cn
zvvq好,好zvvq
2、开始在项目中配置一下我们的mongodb吧 zvvq.cn
第一步:我新建一个Core2.0类库 zvvq好,好zvvq
引入了 “MongoDB.Driver” 这个nuget包。 内容来自samhan666
然后扩展了 Startup.cs 中的Services的扩展方法 copyright zvvq
1
2 内容来自zvvq,别采集哟
3
4
zvvq好,好zvvq
5 本文来自zvvq
6
7
8 zvvq
9 zvvq好,好zvvq
10
11
zvvq.cn
//扩展方法public static class ServiceCollectionExtensions
zvvq
{ 内容来自zvvq,别采集哟
public static void AddMongoDB(this IServiceCollection services, IConfiguration configuration) 本文来自zvvq
{ zvvq好,好zvvq
services.Configure<Settings>(options =>
内容来自zvvq
{
options.ConnectionString = configuration.GetSection("MongoConnection:ConnectionString").Value; 内容来自zvvq,别采集哟
options.Database = configuration.GetSection("MongoConnection:Database").Value;
zvvq
}); zvvq.cn
}
}
内容来自samhan666
第二步:重构封装了mongodb的CRUD类,此处大家可以自行封装,只展示了查找和新增。 本文来自zvvq
1 内容来自zvvq
2
3 zvvq
4
copyright zvvq
5 zvvq好,好zvvq
6 zvvq
7
8
copyright zvvq
9
zvvq好,好zvvq
10 内容来自zvvq
11
12
13
14 copyright zvvq
15
zvvq
16 zvvq好,好zvvq
17
18 本文来自zvvq
19
本文来自zvvq
20 zvvq
21
内容来自samhan666
22
内容来自zvvq,别采集哟
23 zvvq好,好zvvq
24 zvvq好,好zvvq
25
内容来自samhan666
26
27
28 内容来自zvvq,别采集哟
29 zvvq.cn
30 zvvq好,好zvvq
31 内容来自samhan
32 zvvq
33 内容来自zvvq
34
zvvq
35
内容来自zvvq
36
37 copyright zvvq
38
内容来自samhan666
39 本文来自zvvq
40
41
42 zvvq
43 内容来自zvvq
public class MongoDBBase 本文来自zvvq
{
copyright zvvq
private readonly IMongoDatabase _database = null;
public MongoDBBase(string connectionString, string databaseName) 内容来自samhan
{
var client = new MongoClient(connectionString); zvvq
if (client != null) 内容来自zvvq
{
zvvq好,好zvvq
_database = client.GetDatabase(databaseName);
}
copyright zvvq
} 内容来自zvvq,别采集哟
region SELECT
/// <summary> copyright zvvq
/// 根据查询条件,获取数据 内容来自samhan
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="id"></param>
内容来自samhan666
/// <returns></returns> 内容来自samhan666
public List<T> GetList<T>(Expression<Func<T, bool>> conditions = null)
内容来自samhan
{ zvvq
var collection = _database.GetCollection<T>(typeof(T).Name);
zvvq好,好zvvq
if (conditions != null) 内容来自zvvq
{ zvvq
return collection.Find(conditions).ToList(); copyright zvvq
}
return collection.Find(_ => true).ToList(); zvvq
}endregion 内容来自zvvq
region INSERT/// <summary>
zvvq.cn
/// 插入多条数据,数据用list表示
内容来自zvvq
/// </summary> 内容来自samhan
/// <typeparam name="T"></typeparam> 本文来自zvvq
/// <param name="list"></param>
/// <returns></returns> 内容来自samhan666
public List<T> InsertMany<T>(List<T> list)
内容来自samhan
{
copyright zvvq
var collection = _database.GetCollection<T>(typeof(T).Name); 内容来自zvvq
collection.InsertMany(list);
return list;
zvvq
} 内容来自zvvq
endregion
zvvq好,好zvvq
} 内容来自zvvq,别采集哟
第三步:新建一个asp.net core webapi 项目,引用此类库进行演示 内容来自zvvq,别采集哟
在项目中的 appsetting.json 添加 mongodb的连接字符串:我在这边使用自定义的一个数据名称 testdb,在插入mongodb的时候会会自动在创建数据库和集合以及文档。接着往下看
1 本文来自zvvq
2
内容来自samhan666
3
内容来自zvvq,别采集哟
4 内容来自samhan
5 zvvq好,好zvvq
"MongoConnection": { //mongodb数据库连接
"ConnectionString": "mongodb://127.0.0.1:27017", zvvq
"Database": "testdb", copyright zvvq
"IsSSL": true zvvq好,好zvvq
},
copyright zvvq
第四步:新建一个mongodb测试控制器,展示了插入单条和多条以及查询的接口。
1 zvvq.cn
2 内容来自samhan666
3
4 内容来自samhan666
5 本文来自zvvq
6
7
8
内容来自zvvq
9 内容来自samhan
10 内容来自zvvq,别采集哟
11 内容来自zvvq,别采集哟
12 copyright zvvq
13 zvvq好,好zvvq
14
15 copyright zvvq
16
17 zvvq
18
19
zvvq.cn
20
21
22
23
内容来自zvvq
24
copyright zvvq
25 内容来自zvvq,别采集哟
26
27
copyright zvvq
28 本文来自zvvq
29 copyright zvvq
30 zvvq.cn
31
32
zvvq好,好zvvq
33
本文来自zvvq
34 zvvq.cn
35 内容来自samhan666
36 zvvq好,好zvvq
37
38
本文来自zvvq
39
40
41
内容来自zvvq,别采集哟
42
43
本文来自zvvq
44 本文来自zvvq
45
zvvq好,好zvvq
46
47 zvvq.cn
48 zvvq
49 zvvq
50
zvvq.cn
51 本文来自zvvq
52 zvvq好,好zvvq
53
54 内容来自samhan
55 zvvq好,好zvvq
56
57
内容来自zvvq
58
内容来自zvvq,别采集哟
59 copyright zvvq
60 zvvq
61
62
内容来自zvvq,别采集哟
63
64
zvvq好,好zvvq
65 内容来自zvvq
66
copyright zvvq
67
68
本文来自zvvq
69 copyright zvvq
70
71
72
73
74 内容来自zvvq,别采集哟
75
本文来自zvvq
76 zvvq
77
内容来自zvvq,别采集哟
[Produces("application/json")]
[Route("api/MongoDB/[action]")] 内容来自samhan
public class MongoDBController : Controller copyright zvvq
{ zvvq
private readonly MongoDBBase _context = null; 内容来自samhan
public MongoDBController(IOptions<Settings> settings)
{
_context = new MongoDBBase(settings.Value.ConnectionString, settings.Value.Database); 本文来自zvvq
}
[HttpGet] 内容来自samhan666
public IActionResult AddList()
{
zvvq好,好zvvq
List<MongoDBPostTest> list = new List<MongoDBPostTest>() 内容来自samhan666
{
new MongoDBPostTest() zvvq.cn
{ copyright zvvq
Id = "2", 本文来自zvvq
Body = "Test note 3",
UpdatedOn = DateTime.Now, 内容来自samhan
UserId = 1,
HeaderImage = new NoteImage
{ zvvq
ImageSize = 10, zvvq好,好zvvq
Url = "http://localhost/image1.png", zvvq
ThumbnailUrl = "http://localhost/image1_small.png" zvvq好,好zvvq
}
内容来自zvvq
}, copyright zvvq
new MongoDBPostTest() 内容来自samhan666
{ zvvq.cn
Id = "3", copyright zvvq
Body = "Test note 4",
zvvq.cn
UpdatedOn = DateTime.Now,
zvvq
UserId = 1,
copyright zvvq
HeaderImage = new NoteImage
{
ImageSize = 14,
Url = "http://localhost/image3.png",
内容来自samhan
ThumbnailUrl = "http://localhost/image3_small.png" 内容来自zvvq,别采集哟
}
} 内容来自zvvq
}; 内容来自samhan
try
内容来自zvvq
{
内容来自zvvq,别采集哟
_context.InsertMany(list);
本文来自zvvq
} 内容来自samhan666
catch (Exception ex) 内容来自zvvq
{
内容来自zvvq,别采集哟
throw; 内容来自zvvq,别采集哟
} 本文来自zvvq
return Ok("成功"); zvvq好,好zvvq
}
zvvq
[HttpGet]
public Result<List<MongoDBPostTest>> SelectSingle() zvvq
{ 本文来自zvvq
//无条件 内容来自zvvq,别采集哟
var list = _context.GetList<MongoDBPostTest>(); zvvq
//有条件 zvvq
//var list = _context.GetList<MongoDBPostTest>(a => a.Id == "1"); 内容来自samhan666
//得到单条数据,无条件
//var list = _context.GetSingle<MongoDBPostTest>();
内容来自zvvq
//得到单条数据,有条件 zvvq好,好zvvq
//var list = _context.GetSingle<MongoDBPostTest>(a => a.Id == "3");
ObjectId internalId = _context.GetInternalId("5bbf41651d3b66668cbb5bfc");
本文来自zvvq
var a = _context.GetSingle<MongoDBPostTest>(note => note.Id == "5bbf41651d3b66668cbb5bfc" || note.InternalId == internalId);
return ResHelper.Suc(1, list, "成功"); zvvq好,好zvvq
} 本文来自zvvq
} 本文来自zvvq
测试类 内容来自samhan666
1
copyright zvvq
2 本文来自zvvq
3 本文来自zvvq
4
5
内容来自zvvq
6 内容来自samhan666
7 zvvq好,好zvvq
8 内容来自samhan666
9 内容来自samhan
10 zvvq.cn
11 copyright zvvq
12 copyright zvvq
13
14 内容来自samhan666
15
16 内容来自zvvq,别采集哟
17
本文来自zvvq
18 内容来自zvvq
19
内容来自samhan666
20
zvvq.cn
21 zvvq
22
zvvq好,好zvvq
23
zvvq
public class MongoDBPostTest zvvq
{ 内容来自samhan666
[BsonId] 内容来自zvvq
// standard BSonId generated by MongoDb
内容来自zvvq
public ObjectId InternalId { get; set; }
zvvq.cn
public string Id { get; set; } 内容来自zvvq,别采集哟
public string Body { get; set; } = string.Empty; 内容来自samhan666
[BsonDateTimeOptions] zvvq
public DateTime UpdatedOn { get; set; } = DateTime.Now; zvvq
public NoteImage HeaderImage { get; set; } copyright zvvq
public int UserId { get; set; } = 0; 内容来自zvvq
} zvvq好,好zvvq
public class NoteImage zvvq好,好zvvq
{
zvvq.cn
public string Url { get; set; } = string.Empty;
public string ThumbnailUrl { get; set; } = string.Empty;
public long ImageSize { get; set; } = 0L;
zvvq.cn
}
zvvq
第五步:运行项目,执行一下。
我们执行一下插入多条的数据吧,执行成功。
内容来自samhan
内容来自samhan
然后我们看一下数据库,发现已经生成了一个 testdb 数据库,里面包含了我们的数据内容
zvvq
zvvq
然后我们执行以下查的操作:把我们刚才插入的数据返回回来了。 本文来自zvvq
zvvq好,好zvvq
注意:这边有一个坑有待解决,就是mongodb存储的时间是UTC,会跟我们的本地时间相差8个小时。因此这边需要特殊处理一下时间。
zvvq好,好zvvq
三、总结 内容来自zvvq
至此,mongodb的简单运用已演示完毕,后期大家根据官方文档可进行扩展,越扩展到后面,会觉得越来越有意思。感谢大家的支持。Thank you。
以上就是学习asp.net core集成MongoDB的完整步骤的详细内容,更多请关注其它相关文章! copyright zvvq