MongoDB for C#基礎入門

筆者這里采用的是mongoDB官網推薦使用.net驅動：

http://mongodb.github.io/mongo-csharp-driver/2.0/getting_started/quick_tour/

有關於MongoDB的安裝讀者可以參考其他的博客，對於基本的學習來說並不需要進行過多的配置。

 

創建連接

這一步驟跟ADO.NET連接到數據庫的步驟是一樣的，ADO.NET是利用SqlConnection連接數據庫，而MongoDB則使用MongoClient連接，並在構造函數中將連接字符傳遞進去，當然可以不傳遞，那么默認就是連接本地的計算機的默認端口（27017），比如下面的三種連接方式：

1 var client = new MongoClient();
2 
3 var client1 = new MongoClient("mongodb://localhost:27017");
4 
5 var client2 = new MongoClient("mongodb://localhost:27017,localhost:27018,localhost:27019");

 

 

獲取數據庫

為了獲取數據庫，只需要調用MongoClient對象的GetDatabase方法，並傳入數據庫名稱即可，如果數據庫存在則直接返回，否則就創建該數據庫並返回，比如下面的這段代碼將創建名為“foo”的數據庫：

var database = client.GetDatabase("foo");

現在database變量就指向了foo數據庫了。

 

獲取鏈表

雖然叫獲取鏈表，但是實際上就是獲取數據庫中的表，我們可以通過上面database的GetCollection<TDocument>方法獲取，比如下面的代碼我們將獲取一個名為“bar”的表：

var collection = database.GetCollection<BsonDocument>("bar");

我們傳入的泛型參數為BsonDocument，這個是自帶的，可以動態的容納各種格式的數據，當然這里還是建議讀者使用POCO。

 

插入一個文檔

利用collection對象，我們可以將文檔插入其中，比如下面的json格式數據：

{
     "name": "MongoDB",
     "type": "database",
     "count": 1,
     "info": {
         x: 203,
         y: 102
     }
}

下面我們利用BsonDocument對象組織上面的JSON格式的數據：

var document = new BsonDocument
{
    {"name","MongoDB"},
    {"type","Database"},
   {"count",1},
   {"info",new BsonDocument{
         {"x",203},
         {"y",102}
       }
   }
};

然后我們利用collection對象的InsertOneAsync將上面的數據插入其中：

collection.InsertOneAsync(doc);

我們都知道Async為后綴的方法都是支持異步的，但是筆者是在控制台項目中演示的所以沒有加上這個await，如果讀者實在其他的環境中測試的可以根據情況加上。

 

插入多個文檔

如果需要一次性插入多個文檔，我們可以通過InsertManyAsync方法，比如下面的示例我們將插入100條數據：

var documents = Enumerable.Range(0, 100).Select(x => new BsonDocument("counter", x));
collection.InsertManyAsync(documents);

 

 

統計文檔數量

通過上面的步驟我們已經插入了101條數據，如果在實際開發中我們需要統計數據的數量就可以通過調用CountAsync方法，比如下面的代碼：

var count = collection.CountAsync(new BsonDocument());
Console.WriteLine(count.Result);

 

 

查詢鏈表

利用Find方法我們可以對鏈表進行查詢，Find方法將返回給我們IFindFluent<TDocument,TProjection>對象，該接口屬於鏈式接口，所以能夠提供給我們類似jquery那樣的鏈式變成方式去控制查詢操作。

 

查詢鏈表首條數據

為了獲取第一條數據我們可以通過調用FirstOrDefaultAsync方法，該方法會返回第一條數據，如果不存在數據則會返回null，比如下面的代碼將會顯示鏈表中的第一條數據：

var firstDoc = collection.Find(new BsonDocument()).FirstOrDefaultAsync();
Console.WriteLine(firstDoc.Result.ToString());

如果讀者注意最后的輸出，會發現一個_id字段，但是我們並沒有插入這個字段，這個字段是mongoDB自動加入的，相信很多人都知道它的作用，這里就不詳細解釋額。

 

查詢鏈表中所有數據

如果想將鏈表中所有的數據都返回可以在Find操作之后調用ToListAsync方法就可以，將會直接返回List<T>類型的結果，比如下面的這段代碼：

var documents = collection.Find(new BsonDocument()).ToListAsync().Result;

針對數量較少的數據情況下，上面這種方式是沒有問題，但如果我們需要處理大量的數據，那么我們就不能使用上面的這種方式，就需要利用下面的方式，通過ForEachAsync來完成，因為這個方法會在每條數據返回的時候執行一個回調，從而達到並發處理的目的，比如下面這段代碼就演示了如何使用：

collection.Find(new BsonDocument()).ForEachAsync(x => Console.WriteLine(x));

 

 

通過條件查詢單條數據

我們可以在調用Find方法的時候傳入一個過濾條件，從而在鏈表中查詢我們希望的數據，比如下面這個例子我們將查詢字段“counter”的值為71的數據：

var filter = Builders<BsonDocument>.Filter.Eq("counter", 71);
var document = collection.Find(filter).FirstAsync().Result;
Console.WriteLine(document);

這里我們需要通過Builders的靜態對象Filter中的各種條件方法來構造條件，然后在調用Find方法的將其傳入即可。

 

通過條件查詢多條數據

我們也可以獲取多條數據，比如下面這個例子，我們將搜索出所有“counter”的值大於50的數據：

var filter = Builders<BsonDocument>.Filter.Gt("counter", 50);
var document = collection.Find(filter).ForEachAsync(x => Console.WriteLine(x));

 

當然我們也可以給定一個范圍，比如50到70之間：

var filterBuilder = Builders<BsonDocument>.Filter;
var filter = filterBuilder.Gt("counter", 50) & filterBuilder.Lt("counter", 70);
collection.Find(filter).ForEachAsync(x => Console.WriteLine(x));

 

 

對數據排序

下面我們將在查詢的基礎之上加上排序，排序只需要在在調用Sort方法時傳入對應的參數即可，比如下面的例子，我們將對鏈表先進行查詢，然后排序：

var filter = Builders<BsonDocument>.Filter.Exists("counter");
var sort = Builders<BsonDocument>.Sort.Descending("counter");
var documnt = collection.Find(filter).Sort(sort).FirstAsync().Result;

 

 

對字段投射

許多時候我們並不需要文檔中的所有數據，這就好比在SQL中我們都會只把我們需要的數據select出來，而不會把表中的所有字段的數據都拿出來，自然MongoDB也可以讓我這樣做，我們只需要跟過濾和排序一樣利用Projection構造器來構造然后傳遞給Project方法中就可以了，下面這個例子中我們將排除“_id”字段：

var projection = Builders<BsonDocument>.Projection.Exclude("_id");
var document = collection.Find(new BsonDocument()).Project(projection).FirstAsync().Result;
Console.WriteLine(document);

 

 

更新文檔

MongoDB擁有很多更新操作，下面我們將會介紹幾個簡單的並且常用的更新操作。

 

如果我們需要更新一個對象（如果條件不匹配那么可能是0條），可以使用UpdateOneAsync方法，並執行過濾條件和需要更新到的文檔，比如下面我們將“counter”為1的數據中的“counter”更新為110：

var filter = Builders<BsonDocument>.Filter.Eq("counter", 1);
var updated = Builders<BsonDocument>.Update.Set("counter", 110);
var result = collection.UpdateOneAsync(filter, updated).Result;

 

如果我們需要批量的更新，我們可以調用UpdateManyAsync即可。比如我們需要將“counter”小於10的數據中的“counter”累加100，那么我們就可以像下面這樣來寫：

var filter = Builders<BsonDocument>.Filter.Lt("counter", 10);
var updated = Builders<BsonDocument>.Update.Inc("counter", 100);
var result = collection.UpdateManyAsync(filter, updated).Result;

 

 

刪除文檔

作為基礎部分這也是最后一個部分了，利用上面的過濾，然后調用DeleteOneAsync或DeleteManyAsync方法就可以了，比如下面的列子就是刪除“counter”大於100的所有數據：

var filter = Builders<BsonDocument>.Filter.Gt("counter", 100);
var resut = collection.DeleteManyAsync(filter).Result;

 

 

 

到此為止，MongoDB的基礎部分就結束了。