MongoDB via C#

安装

  1. 首先需要安装 MongoDB.Driver 包 nuget
  2. 首先的首先,需要安装好 Mongo 数据库 下载Mongo
  3. 配置好数据库,构建好连接字符串就可以继续使用了 连接字符串

! mongodb 默认是没有用户名和密码的,而且IP和端口都是开放的,请自行做好安全防范的心里准备

数据

数据层次

DataBase

对应 SQL的 Database

Collection

对应 SQL的 Table

Document

对应 SQL的 Row

文档结构

BsonId

对于MongoDB中所有的Document都必须有一个_id字段。

在C#中对于这个”_id”字段可以使用一下的几种操作:

  1. ObjectId [Id|id|_id]
  2. [ValueType|string] [Id|id|_id]

如果吝啬使用Id这个属性名(字段名)的话,也可使用 [BsonId] 这个特性手动的指定映射的Id字段。
不论使用的是以上什么方法,在MongoDB中存储的永远会是 _id 。
当然,也可以不添加该字段,如果不想在查询的时候报错的话,还是需要进行一些额外的操作的。

对于ObjectId类型的_id,可是使用 ObjectId.GenerateNewId() 生成。

几个常用的特性

  1. [BsonId] : (prop) 指定_id字段
  2. [BsonIgnore] : (prop) 在MongoDB中忽略,参考[JsonIgnore]
  3. [BsonRequired] : (prop) 在MongoDB中强制要求
  4. [BsonElement()] : (prop) 指定数据库中的映射
  5. [BsonExtraElements] : (prop) 该字段为扩展字段
  6. [BsonIgnoreExtraElements] : (class) 忽略额外的字段

大部分的特性对于插入的影响不大,对于查询有较大的影响。其中忽略额外元素的特性可以进行丢弃_id的操作。

操作

MongoDB 中增删改都提供了One和Many两组,同步和异步两套,也就是4个操作。

Insert

_collection.InsertOne(new Document(){});
_collection.InsertMany(new List<Document>(){});
_collection.InsertOneAsync(new Document(){});
_collection.InsertManyAsync(new List<Document>(){});

Delete

_collection.DeleteOne(_=>_.id == id);
_collection.DeleteMany(_=>_.userid == userid);
_collection.DeleteOneAsync(_=>_.id == id);
_collection.DeleteManyAsync(_=>_.userid == userid);

Update

_collection.UpdateOne(_=>_.id == id,updateDefinition)
_collection.UpdateMany(_=>_.userid = userid,updateDefinition)
_collection.UpdateOneAsync(_=>_.id == id,updateDefinition)
_collection.UpdateManyAsync(_=>_.userid = userid,updateDefinition)

Query

_collection.Find(_=>_.id == id).First();
_collection.Find(_=>_.id == id).FirstOrDefault();
_collection.Find(_=>_.userid == userid).ToList();
_collection.Find(_=>_.id == id).FirstAsync();
_collection.Find(_=>_.id == id).FirstOrDefaultAsync();
_collection.Find(_=>_.userid == userid).ToListAsync();
await _collection.FindAsync(_=>_.userid == userid);

对于查询的结果还可以进行进一步的操作。

_collection.Find(filter)
            .SortBy(_=>_.CreateTime)
            .Skip(skip)
            .Limit(limt)
            .Project(_=>new ProjectDocument(_))
            .As<Document>()
            .ForEachAsync(func);

Count

_collection.Count(_=>_.userId == userid).Count();
_collection.Count(_=>_.userId == userid).CountAsync();

Query One And

_collection.FindOneAndDelete(_=>_.id == id);
_collection.FindOneAndReplace(_=>_.id == id, new Document());
_collection.FindOneAndUpdate(_=>_.id == id ,updateDefinition);
_collection.FindOneAndDeleteAsync(_=>_.id == id);
_collection.FindOneAndReplaceAsync(_=>_.id == id, new Document());
_collection.FindOneAndUpdateAsync(_=>_.id == id ,updateDefinition);

Definition

以上所有的操作中查找可以使用 filter definition 也可以使用 lambda 表达式,更改则需要使用 update definition .
所有的definition可以使用 Builders<T> 进行创建,也是自行实例化 DefinitionBuilder<T> 然后构建。以下默认习惯性使用Builders<T>进行构建。

Filter Definition

Filter Definition 相当于筛选条件,条件之间可是进行组合。

  1. 简单条件

    var filter = Builders<Document>.Filter.Eq(_=>_.userId,userId);
    _collection.Find(filter).ToList();
    <=>
    _collection.Find(_=>_.userId == userId).ToList();
    
  2. 条件组合

    var filter = Builders<Document>.Filter.Eq(_=>_.userId,userId)
                &Builders<Document>.Filter.Eq(_=>_.title,title);
    
    var filter1 = Builders<Document>.Filter.Eq(_=>_.userId,userId)
                | Builders<Document>.Filter.Eq(_=>_.title,title);
    
    var filter2 = !filter;
    
    <=>
    
    var filter = Builders<Document>.Filter.And(
                            Builders<Document>.Filter.Eq(_=>_.UserId,userid),
                            Builders<Document>.Filter.Eq(_=>_.Title,title)
                            );
    
    var filter1 = Builders<Document>.Filter.Or(
                            Builders<Document>.Filter.Eq(_=>_.UserId,userid),
                            Builders<Document>.Filter.Eq(_=>_.Title,title)
                            );
    var filter2 = Builders<Document>.Filter.Not(filter);
  3. 更多条件

    Builders<Document>.Filter.Lt
    Builders<Document>.Filter.Lte
    Builders<Document>.Filter.Ne
    Builders<Document>.Filter.Gt
    Builders<Document>.Filter.Gte
    Builders<Document>.Filter.Not
    Builders<Document>.Filter.In
    Builders<Document>.Filter.Nin
    Builders<Document>.Filter.Exists
    Builders<Document>.Filter.Regex
    Builders<Document>.Filter.All
    Builders<Document>.Filter.Any
    Builders<Document>.Filter.Size
    Builders<Document>.Filter.SizeGt
    Builders<Document>.Filter.SizeGte
    Builders<Document>.Filter.SizeLt
    Builders<Document>.Filter.SizeLte
    Builders<Document>.Filter.OfType
    
    and more ...

    以上只列举了部分的Filter,点击查看的Filter

Update Definition

Update Definition 是更新条目,相比Filter Definition,Update Definition 可是进行链式操作

Builders<Document>.Update.Set(_=>_.title,title)
                         .Set(_=>_.desc,desc);

相对于SQL来说,MongoDB中提供的Update操作丰富多彩。除了基本的Set,另外还有对于数组的AddToSet、UnSet等,对于时间有CurrentDate等。点击查看所有Update

Aggregate

MongoDB 中提供了聚合操作可是方便的对文档集合进行操作。其中常用的包括了 Group,Match,Project;

_collection.Aggregate().Match(_ => _.UserId==userid)
                       .Group(_ => new {
                            _.Type
                        }, g => new
                        {
                            Type = g.Key,
                            Count = g.Count()
                        })
                       .Project(_ => new
                        {
                            UserId = userid,
                            Type = _.Type,
                            Count = _.Count
                        })
                       .ToList();

需要注意的是,Group和Project中的表达式返回类型对应的都需要是一个对象,在进行映射的时候会转换成BsonDocument,如果直接使用 Group(_=>_.Type,...)这样的操作的话,会抛出 无法将 BsonValue 转化为 BsonDocument 的错误。

Tips

闲时更新

如有错误,多谢指正

    原文作者:xbotter
    原文地址: https://segmentfault.com/a/1190000011572390
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞