C#操作MongoDB數據庫方法


    本文利用MongoDB官方發布的C#驅動,封閉了對MongoDB數據庫的增刪改查訪問方法。

    1、引用MongoDB for C# Driver

    從網上下載C#訪問MongoDB的驅動,得到兩個DLL:

  • MongoDB.Driver.dll
  • MongoDB.Bson.dll

    將它們引用到項目中。

    2、編寫數據庫訪問幫助類

    編寫MongoDB訪問幫助類MongoDbHelper:

  1 using System;
  2 using System.Collections.Generic;
  3 using System.Linq;
  4 using MongoDB.Bson;
  5 using MongoDB.Driver;
  6 using MongoDB.Driver.Builders;
  7 using MongoDbTest.Models;
  8 
  9 namespace MongoDbTest
 10 {
 11     /// <summary>
 12     /// MongoDB幫助類
 13     /// </summary>
 14     internal static class MongoDbHepler
 15     {
 16         /// <summary>
 17         /// 獲取數據庫實例對象
 18         /// </summary>
 19         /// <param name="connectionString">數據庫連接串</param>
 20         /// <param name="dbName">數據庫名稱</param>
 21         /// <returns>數據庫實例對象</returns>
 22         private static MongoDatabase GetDatabase(string connectionString, string dbName)
 23         {
 24             var server = MongoServer.Create(connectionString);
 25             return server.GetDatabase(dbName);
 26         }
 27 
 28         #region 新增
 29 
 30         /// <summary>
 31         /// 插入一條記錄
 32         /// </summary>
 33         /// <typeparam name="T">數據類型</typeparam>
 34         /// <param name="connectionString">數據庫連接串</param>
 35         /// <param name="dbName">數據名稱</param>
 36         /// <param name="collectionName">集合名稱</param>
 37         /// <param name="model">數據對象</param>
 38         public static void Insert<T>(string connectionString, string dbName, string collectionName, T model) where T : EntityBase
 39         {
 40             if (model == null)
 41             {
 42                 throw new ArgumentNullException("model", "待插入數據不能為空");
 43             }
 44             var db = GetDatabase(connectionString, dbName);
 45             var collection = db.GetCollection<T>(collectionName);
 46             collection.Insert(model);
 47         }
 48 
 49         #endregion
 50 
 51         #region 更新
 52 
 53         /// <summary>
 54         /// 更新數據
 55         /// </summary>
 56         /// <param name="connectionString">數據庫連接串</param>
 57         /// <param name="dbName">數據庫名稱</param>
 58         /// <param name="collectionName">集合名稱</param>
 59         /// <param name="query">查詢條件</param>
 60         /// <param name="dictUpdate">更新字段</param>
 61         public static void Update(string connectionString, string dbName, string collectionName, IMongoQuery query, Dictionary<string, BsonValue> dictUpdate)
 62         {
 63             var db = GetDatabase(connectionString, dbName);
 64             var collection = db.GetCollection(collectionName);
 65             var update = new UpdateBuilder();
 66             if (dictUpdate != null && dictUpdate.Count > 0)
 67             {
 68                 foreach (var item in dictUpdate)
 69                 {
 70                     update.Set(item.Key, item.Value);
 71                 }
 72             }
 73             var d = collection.Update(query, update, UpdateFlags.Multi);
 74         }
 75 
 76         #endregion
 77 
 78         #region 查詢
 79 
 80         /// <summary>
 81         /// 根據ID獲取數據對象
 82         /// </summary>
 83         /// <typeparam name="T">數據類型</typeparam>
 84         /// <param name="connectionString">數據庫連接串</param>
 85         /// <param name="dbName">數據庫名稱</param>
 86         /// <param name="collectionName">集合名稱</param>
 87         /// <param name="id">ID</param>
 88         /// <returns>數據對象</returns>
 89         public static T GetById<T>(string connectionString, string dbName, string collectionName, ObjectId id)
 90             where T : EntityBase
 91         {
 92             var db = GetDatabase(connectionString, dbName);
 93             var collection = db.GetCollection<T>(collectionName);
 94             return collection.FindOneById(id);
 95         }
 96 
 97         /// <summary>
 98         /// 根據查詢條件獲取一條數據
 99         /// </summary>
100         /// <typeparam name="T">數據類型</typeparam>
101         /// <param name="connectionString">數據庫連接串</param>
102         /// <param name="dbName">數據庫名稱</param>
103         /// <param name="collectionName">集合名稱</param>
104         /// <param name="query">查詢條件</param>
105         /// <returns>數據對象</returns>
106         public static T GetOneByCondition<T>(string connectionString, string dbName, string collectionName, IMongoQuery query)
107             where T : EntityBase
108         {
109             var db = GetDatabase(connectionString, dbName);
110             var collection = db.GetCollection<T>(collectionName);
111             return collection.FindOne(query);
112         }
113 
114         /// <summary>
115         /// 根據查詢條件獲取多條數據
116         /// </summary>
117         /// <typeparam name="T">數據類型</typeparam>
118         /// <param name="connectionString">數據庫連接串</param>
119         /// <param name="dbName">數據庫名稱</param>
120         /// <param name="collectionName">集合名稱</param>
121         /// <param name="query">查詢條件</param>
122         /// <returns>數據對象集合</returns>
123         public static List<T> GetManyByCondition<T>(string connectionString, string dbName, string collectionName, IMongoQuery query)
124             where T : EntityBase
125         {
126             var db = GetDatabase(connectionString, dbName);
127             var collection = db.GetCollection<T>(collectionName);
128             return collection.Find(query).ToList();
129         }
130 
131         /// <summary>
132         /// 根據集合中的所有數據
133         /// </summary>
134         /// <typeparam name="T">數據類型</typeparam>
135         /// <param name="connectionString">數據庫連接串</param>
136         /// <param name="dbName">數據庫名稱</param>
137         /// <param name="collectionName">集合名稱</param>
138         /// <returns>數據對象集合</returns>
139         public static List<T> GetAll<T>(string connectionString, string dbName, string collectionName)
140             where T : EntityBase
141         {
142             var db = GetDatabase(connectionString, dbName);
143             var collection = db.GetCollection<T>(collectionName);
144             return collection.FindAll().ToList();
145         }
146 
147         #endregion
148 
149         #region 刪除
150 
151         /// <summary>
152         /// 刪除集合中符合條件的數據
153         /// </summary>
154         /// <param name="connectionString">數據庫連接串</param>
155         /// <param name="dbName">數據庫名稱</param>
156         /// <param name="collectionName">集合名稱</param>
157         /// <param name="query">查詢條件</param>
158         public static void DeleteByCondition(string connectionString, string dbName, string collectionName, IMongoQuery query)
159         {
160             var db = GetDatabase(connectionString, dbName);
161             var collection = db.GetCollection(collectionName);
162             collection.Remove(query);
163         }
164 
165         /// <summary>
166         /// 刪除集合中的所有數據
167         /// </summary>
168         /// <param name="connectionString">數據庫連接串</param>
169         /// <param name="dbName">數據庫名稱</param>
170         /// <param name="collectionName">集合名稱</param>
171         public static void DeleteAll(string connectionString, string dbName, string collectionName)
172         {
173             var db = GetDatabase(connectionString, dbName);
174             var collection = db.GetCollection(collectionName);
175             collection.RemoveAll();
176         }
177 
178         #endregion
179 
180     }
181 }
View Code

    3、編寫測試類

    (1)配置數據庫參數

    在配置文件中編寫數據庫連接串和數據庫名稱。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <!--MongoDB數據庫連接串-->
    <add key="MongoDBConn" value="mongodb://127.0.0.1:27017"/>
    <!--MongoDB數據庫名稱-->
    <add key="MongoDBName" value="mydb"/>
  </appSettings> 
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
</configuration>
View Code

    將其寫入C#代碼中:

using System.Configuration;

namespace MongoDbTest
{
    /// <summary>
    /// 數據庫配置參數
    /// </summary>
    internal static class DbConfigParams
    {
        private static string _conntionString = ConfigurationManager.AppSettings["MongoDBConn"];

        /// <summary>
        /// 獲取 數據庫連接串
        /// </summary>
        public static string ConntionString
        {
            get { return _conntionString; }
        }

        private static string _dbName = ConfigurationManager.AppSettings["MongoDBName"];

        /// <summary>
        /// 獲取 數據庫名稱
        /// </summary>
        public static string DbName
        {
            get { return _dbName; }
        }
    }
}
View Code

    另外,將集合名稱寫到C#代碼中作為字符串常量:

namespace MongoDbTest
{
    public class CollectionNames
    {
        public const string User = "User";

        public const string Student = "Student";
    }
}
View Code

    (2)編寫實體類

    首先,編寫實體基類,其中含有默認的Id:

using MongoDB.Bson;
using MongoDB.Bson.Serialization.Attributes;

namespace MongoDbTest.Models
{
    /// <summary>
    /// 實體基類
    /// </summary>
    public class EntityBase
    {
        /// <summary>
        /// 主鍵
        /// </summary>
        [BsonId]
        public ObjectId Id { get; set; }
    }
}
View Code

    然后,編寫實體類:

namespace MongoDbTest.Models
{
    /// <summary>
    /// 學生類
    /// </summary>
    public class Student : EntityBase
    {
        /// <summary>
        /// 獲取 姓名
        /// </summary>
        public string Name { get; set; }

        /// <summary>
        /// 獲取 年齡
        /// </summary>
        public int Age { get; set; }

        /// <summary>
        /// 獲取 狀態
        /// </summary>
        public State State { get; set; }
    }
}
View Code

    其中,State枚舉類定義如下:

namespace MongoDbTest.Models
{
    /// <summary>
    /// 狀態
    /// </summary>
    public enum State
    {
        /// <summary>
        /// 全部
        /// </summary>
        All = 0,

        /// <summary>
        /// 正常
        /// </summary>
        Normal = 1,

        /// <summary>
        /// 未使用
        /// </summary>
        Unused = 2,
    }
}
View Code

    (3)編寫測試代碼

    在主程序中編寫測試代碼:

  1 using System;
  2 using System.Collections.Generic;
  3 using MongoDB.Bson;
  4 using MongoDB.Driver.Builders;
  5 using MongoDbTest.Models;
  6 
  7 namespace MongoDbTest
  8 {
  9     class Program
 10     {
 11         static void Main(string[] args)
 12         {
 13             Console.Title = "Mongo DB Test";
 14             InsertTest();
 15             //QueryTest();
 16             //UpdateTest();
 17             DeleteTest();
 18 
 19             Console.WriteLine("Finish!");
 20 
 21             Console.ReadLine();
 22         }
 23 
 24         /// <summary>
 25         /// 插入數據測試
 26         /// </summary>
 27         static void InsertTest()
 28         {
 29             var random = new Random();
 30             for (var i = 1; i <= 10; i++)
 31             {
 32                 var item = new Student()
 33                 {
 34                     Name = "我的名字" + i,
 35                     Age = random.Next(25, 30),
 36                     State = i%2 == 0 ? State.Normal : State.Unused
 37                 };
 38                 MongoDbHepler.Insert(DbConfigParams.ConntionString, DbConfigParams.DbName, CollectionNames.Student, item);
 39             }
 40         }
 41 
 42         /// <summary>
 43         /// 查詢測試
 44         /// </summary>
 45         static void QueryTest()
 46         {
 47             var queryBuilder = new QueryBuilder<Student>();
 48             var query = queryBuilder.GTE(x => x.Age, 27);
 49             var ltModel = MongoDbHepler.GetManyByCondition<Student>(DbConfigParams.ConntionString, DbConfigParams.DbName,
 50                 CollectionNames.Student, query);
 51             if (ltModel != null && ltModel.Count > 0)
 52             {
 53                 foreach (var item in ltModel)
 54                 {
 55                     Console.WriteLine("姓名:{0},年齡:{1},狀態:{2}",
 56                         item.Name, item.Age, GetStateDesc(item.State));
 57                 }
 58             }
 59         }
 60 
 61         /// <summary>
 62         /// 更新測試
 63         /// </summary>
 64         static void UpdateTest()
 65         {
 66             var queryBuilder = new QueryBuilder<Student>();
 67             var query = queryBuilder.GTE(x => x.Age, 27);
 68             var dictUpdate = new Dictionary<string, BsonValue>();
 69             dictUpdate["State"] = State.Unused;
 70             MongoDbHepler.Update(DbConfigParams.ConntionString, DbConfigParams.DbName, CollectionNames.Student, query,
 71                 dictUpdate);
 72         }
 73 
 74         /// <summary>
 75         /// 刪除測試
 76         /// </summary>
 77         static void DeleteTest()
 78         {
 79             var queryBuilder = new QueryBuilder<Student>();
 80             var query = queryBuilder.GTE(x => x.Age, 28);
 81             MongoDbHepler.DeleteByCondition(DbConfigParams.ConntionString, DbConfigParams.DbName, CollectionNames.Student, query);
 82         }
 83 
 84         /// <summary>
 85         /// 獲取狀態描述
 86         /// </summary>
 87         /// <param name="state">狀態</param>
 88         /// <returns>狀態描述</returns>
 89         static string GetStateDesc(State state)
 90         {
 91             string result = string.Empty;
 92             switch (state)
 93             {
 94                 case State.All:
 95                     result = "全部";
 96                     break;
 97                 case State.Normal:
 98                     result = "正常";
 99                     break;
100                 case State.Unused:
101                     result = "未使用";
102                     break;
103                 default:
104                     throw new ArgumentOutOfRangeException("state");
105             }
106             return result;
107         }
108     }
109 }
View Code

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM