（翻译）在 Xamarin 应用中使用 MongoDB

原文地址：https://blog.xamarin.com/write-apps-using-mongodb-xamarin/

在设计应用时，最重要的决定之一就是要使用什么类型的数据库。

不久之前，这种选择仅限于像 SQL server 这样的关系型数据库。然而，现在 NoSql 数据库出现了，好处是允许应用程序同时处理大量结构和和非结构化数据，能够容易的将数据建模为对象和大规模跨服务器。

MongoDB 是一个 NoSQL 数据库，以二进制 JSON 格式存储文档，已经在 Node.js 社区流行了一段时间。Azure Cosmos DB 是一个完全管理的云数据库。只需点击几下就可以配置一个与 MongoDB 100% 兼容的数据库。

虽然 MongoDB 是因为 Node.js 解决方案而流行，但对于.NET 驱动也是一个完全支持和维护的。驱动程序是 .NET Standard 的实现，这意味着它与多个平台兼容，包括 Xamarin。

本文将向你展示如何使用 MongoDB 创建你的第一个 Xamarin 应用！我们会使用 LINQ 查询，插入和删除数据。在文章结束时，你会有需要创建 MongoDB 给力的 Xamarin 应用的信息。

你可以在这个 GitHub 仓库找到所有示例的代码。

设置环境

为了教学目的，我们的 MongoDB 将托管在 Azure Cosmos DB。

首先，获取 Azure Cosmos DB 实例设置和准备使用，跟着 Azure Cosmos DB 文档页的说明。如果你还没有设置，通过这个连接创建一个 Azure 免费账号。

MongoDB.NET 库允许 Xamarin 应用和 MongoDB 通信。通过 Visual Studio 或者 Visual Studio for Mac 的 NuGet 包管理搜索 MongoDB.NET 驱动并添加到你的你所有的项目。

连接 MongoDB

接下来，我们的应用需要连接到 MongoDB。使用 MongoClient 对象得到 IMongoDatabase 的引用。然后使用 IMongoDatabase 对象获得 IMongoCollection<T> 类的引用。（请参阅示例项目的连接代码的例子。）

了解连接过程，有助于理解 MongoDB 如何排列数据。

上面创建的 Azure Cosmos DB 账号时第一级组织。账号下面有一个或多个数据库（databases）。然后一个或更多的集合（collections）构成了数据库。最后一级，文档（documents）存在于集合中。

为了读写文档，我们的应用将使用 IMongoCollection<T> 类。其中泛型时我们的模型或者是文档的强类型表现。

查询数据

我们使用 IMongoCollection<T> 查询集合中的文档。在移动应用中，异步查询是非常重要的，可以避免阻塞 UI 线程并提供更好的用户体验。.NET的一个伟大的特性是 LINQ 查询。LINQ 帮助开发者以易于理解的语法编写复杂的查询语句，幸运的是，MongoDB 驱动完全支持 LINQ 查询。

返回集合中每个文档的代码如下所示：

public async Task<List<ToDoItem>> GetAllItems()
{
    var allItems = await ToDoItemsCollection
        .Find(new BsonDocument())
        .ToListAsync();

    return allItems;
}

上面要注意的是在 Find 函数中是 BsonDocument。指示一个空过滤器并需要返回任何文档。

AsQueryable() 扩展提供了支持 LINQ 扩展的接口，可以利用过滤器、skip 和 take 等语句。

写入数据

MongoDB.NET 库也提供了一个简单的异步数据修改 API。

像这样插入数据：

public async Task InsertItem(ToDoItem item)
{
    await ToDoItemsCollection.InsertOneAsync(item);
}

使用下面的代码更新整个文档：

public async Task UpdateItem(ToDoItem item)
{
    await ToDoItemsCollection.ReplaceOneAsync(tdi => tdi.Id == item.Id, item);
}

当用于装饰类和属性时 MongoDB 驱动定义了特性来提供附加信息。例如 [BsonId] 特性指定类中的哪个属性应该用做主键或者标识 instance/document。

总结

MongoDB 时一个众所周知并广泛使用的文档数据库。Azure Cosmos DB 和 .NET MongoDB 驱动的结合使 Xamarin 应用成为一个可行的解决方案，这对 .NET 移动开发者来说时比较熟悉的。

想了解更多 MongoDB 的内容，请参阅这里。阅读更多关于 Cosmos DB 上 MongoDB 的信息在这里。这里提供了示例程序的测试驱动。