MongoDB3.0版本后,.NET的驱动更新了2.0版本,全面100%从底层支持异步(Not only is the API async on the surface, the driver is 100% async down to the lowest level.)。
新的API基于最上层的三个接口:IMongoClient, IMongoDatabase, IMongoCollection。新的应用模式是先 创建一个MongoClient实例,调用GetDatabase得到IMongoDatabase实例,然后调用GetCollection得到IMongoCollection实例。大多数操作会用IMongoCollection实例,少数操作用IMongoClient 或者IMongoDatabase层的接口。
新的IMongoCollection接口比原来的MongoCollection 类的方法少很多,更方便使用.一方面这通过利用Options类来可选参数,这样我们不必要重载多个方法只为了提供不同参数的方法。另一方面,通过引进fluent API 来实现最常用的查找和聚合。
初始代码:
var client = new MongoClient("mongodb://localhost");
var database = client.GetDatabase("foo");
var collection = database.GetCollection<BsonDocument>("bar");
插入:
var document = new BsonDocument { { "_id", 1 }, { "x", 2 } };
await collection.InsertOneAsync(document);
InsertOneAsync返回一个没有值的Task,插入完成后Task要么完成,要么错误状态。
查询:
var filter = new BsonDocument("x", new BsonDocument("$gte", 100));
var documents = await collection.Find(filter).ToListAsync();
如果查询返回很多文档,应该在流中处理他们而不是把他们转成一张大表。
var filter = new BsonDocument("x", new BsonDocument("$gte", 100));
await collection.Find(filter).ForEachAsync(async document =>
{
await ProcessDocumentAsync(document);
});
正如驱动是100%异步的,你的程序也应该100%异步,在上面的例子文档是异步处理的。