C#开源轻量级对象数据库NDatabase介绍

今天向大家介绍一款.NET下的开源轻量级对象数据库NDatabase，花了1天时间看了一下文档和一些例子。觉得有必要把一些东西整理成中文文档，也方便大家。本来想把以前的一个小项目改造一下，做一个例子的。无奈，时间不是很充足，还要忙着找工作。所以大家自己看看，这个数据库在某些方面还是很有用的。下面的总计都是按照官方文档进行翻译的，稍微去掉和修改了一些，总结了一下该数据库的一些特点和特性。然后把重点写出来了。简单的增删查改在后门的例子中。翻译水平有限，敬请指点：

1.前言

NDatabase是一个易于使用的.NET对象数据库。为了避免关系数据库带来的开销，可以尝试用NDatabase。NDatabase是新一代的面向对象数据库：1个原生的.NET数据库持久层。它的主要特征有：

·简单：NDatabase非常简单，很容易学习上手使用；它API是简单，不需要学习任何数据库映射技术；不需要对象和存储持久层之间的映射；NDatabase以最简单的方式存储对象；不需要安装和管理。

·小：NDatabase 运行时小于300Kb，部署程序的时候，很容易集成到.NET应用程序中去。

·安全健壮：NDatabase支持ACID事务处理，保证数据的完整性。即使在硬件故障的情况下，所有的提交工作都会应用到数据库，在下一次启动的时候自动执行。

·单一数据库文件：NDatabase使用单一的文件存储所有的数据，包括元数据，对象，索引等。

·生产率：NDatabase使用很少的代码来进行数据持久化，不需要映射。因此，开发人员可以专注于业务逻辑的实现，而不是在数据持久层浪费时间。

2.NDatabase入门

2.1 基础设置

NDatabase中所有的数据库引擎设置都在OdbConfiguration类中。如BTree Validation，和BTree index degree的设置都在这个类里面，打开日志的设置也在这个类里面。NDatabase提供了默认的日志类实现：ConsoleLogger，可以使用OdbConfiguration类中的EnableConsoleLogger方法进行设置。实现好自定义的日志类后，还需要进行注册RegisterLogger方法，才能够使用。

 
 
 
    
  
  
  
  1. OdbConfiguration.RegisterLogger(new Log4NetLogger());
    2.

2.2 使用索引

使用IOdb接口的IndexManagerFor方法可以为指定类型添加索引，如：

 
 
 
    
  
  
  
  1. using (var odb = OdbFactory.Open("index1.ndb"))
    2. 
  
  
  
  2.  {
    3. 
  
  
  
  3.      var fields = new[] { "Name" };
    4. 
  
  
  
  4.      odb.IndexManagerFor().AddUniqueIndexOn("nameIndex", fields);
    5. 
  
  
  
  5.      odb.IndexManagerFor().AddIndexOn("nameIndex", new[] { "Result" });
    6. 
  
  
  
  6.  }
    7.

2.3 使用事务

NDatabase可以使用事务来保证数据的完整性(ACID：原子性,一致性,隔离性，持久性)。当一个NDatabase被打开后，将会自动创建一个会话，包含一个特殊的当前事务对象，这个事务对象实例管理当前所有的数据和数据操作行为。

2.4 内存数据库模式

NDatabase可以将数据库所有数据直接加载到内存中，直接使用OdbFactory方法的 OpenInMemory即可。

2.5 关于触发器

要增加一个触发器，首先要建立一个实现了Trigger 接口()的类，该接口有4种可用的类型(InsertTrigger,UpdateTrigger,SelectTrigger,DeleteTrigger)。如：

 
 
 
    
  
  
  
  1. public class MyTrigger : InsertTrigger
    2. 
  
  
  
  2.  {
    3. 
  
  
  
  3.      public override bool BeforeInsert(object obj)
    4. 
  
  
  
  4.      { return true; } 
    5. 
  
  
  
  5.      public override void AfterInsert(object obj, OID oid)
    6. 
  
  
  
  6.      { }
    7. 
  
  
  
  7.  }
    8.

在使用过程中，打开数据库后，要注册触发器，才能使用：

 
 
 
    
  
  
  
  1. var mage = new Mage("Merlin", 3.3, 3.4);
    2. 
  
  
  
  2.  var myTrigger = new MyTrigger(); 
    3. 
  
  
  
  3.  using (var odb = OdbFactory.Open("inserting_trigger.db"))
    4. 
  
  
  
  4.  {
    5. 
  
  
  
  5.      odb.TriggerManagerFor().AddInsertTrigger(myTrigger);
    6. 
  
  
  
  6.      odb.Store(mage);
    7. 
  
  
  
  7.  }
    8.

2.6 扩展数据库架构

在数据库的使用周期中，类型的定义可能会改变，NDatabase提供了重构管理接口，可以扩展数据库架构，使用IRefactorManager可以重命名类型名称和字段名称，以及增加和删除字段。如下列代码：

 
 
 
    
  
  
  
  1. using (var odb = OdbFactory.Open("Refactoring.odb"))
    2. 
  
  
  
  2.  {
    3. 
  
  
  
  3.      var refactorManager = odb.GetRefactorManager();
    4. 
  
  
  
  4.      refactorManager.RenameField(typeof(User), "age", "_age");
    5. 
  
  
  
  5.      refactorManager.RenameField(typeof(User), "name", "_name");
    6. 
  
  
  
  6.  }
    7.

2.7 自定义日志接口

2.1节中提到了日志的配置，可以自定义日志类，注册后使用，如下所示：

 
 
 
    
  
  
  
  1. public class Log4NetLogger : ILogger
    2. 
  
  
  
  2.  {
    3. 
  
  
  
  3.      private static readonly ILog Log = LogManager.GetLogger(typeof (ILogger)); 
    4. 
  
  
  
  4.      #region Implementation of ILogger 
    5. 
  
  
  
  5.      public void Warning(string message)
    6. 
  
  
  
  6.      {  Log.Warn(message); } 
    7. 
  
  
  
  7.      public void Debug(string message)
    8. 
  
  
  
  8.      {  Log.Debug(message);} 
    9. 
  
  
  
  9.      public void Info(string message)
    10. 
  
  
  
  10.      {  Log.Info(message); } 
    11. 
  
  
  
  11.      public void Error(string message)
    12. 
  
  
  
  12.      {  Log.Error(message);} 
    13. 
  
  
  
  13.      public void Error(string message, Exception t)
    14. 
  
  
  
  14.      {
    15. 
  
  
  
  15.          Log.Error(message);
    16. 
  
  
  
  16.          Log.ErrorFormat("Error: {0}, exception: {1}", t.Message, t);
    17. 
  
  
  
  17.      }
    18. 
  
  
  
  18.      #endregion
    19. 
  
  
  
  19.  }
    20.

2.8 异常处理

NDatabase使用内部的异常处理类型来处理错误，以下是NDatabase中的异常类型：

BTreeException

BTreeNodeValidationException

DuplicatedKeyException

CorruptedDatabaseException

LinqQueryException

2.9 非持久属性

如果有一些属性不想保存到数据库，可以使用[NonPersistent]属性。

3.实际使用的几个例子

使用之前当然要先有实体类，例子的实体类采用最简单的，这里有些地方就不写出来了。

3.1  2个保存对象的例子

先看简单的：

 
 
 
    
  
  
  
  1. var sport = new Sport("volley-ball");
    2. 
  
  
  
  2. using (var odb = OdbFactory.Open(TutorialDb5MinName))//打开数据库
    3. 
  
  
  
  3.     odb.Store(sport);
    4.

再看复杂的：

 
 
 
    
  
  
  
  1. View Code 
    2. 
  
  
  
  2.  var volleyball = new Sport("volley-ball");
    3. 
  
  
  
  3.  var player1 = new Player("julia", DateTime.Now, volleyball);
    4. 
  
  
  
  4.  var player2 = new Player("magdalena", DateTime.Now, volleyball);
    5. 
  
  
  
  5.  var player3 = new Player("jacek", DateTime.Now, volleyball);
    6. 
  
  
  
  6.  var player4 = new Player("michal", DateTime.Now, volleyball);
    7. 
  
  
  
  7.  var team1 = new Team("Krakow");
    8. 
  
  
  
  8.  var team2 = new Team("Skawina");
    9. 
  
  
  
  9.  team1.AddPlayer(player1);
    10. 
  
  
  
  10.  team1.AddPlayer(player2);
    11. 
  
  
  
  11.  team2.AddPlayer(player3);
    12. 
  
  
  
  12.  team2.AddPlayer(player4);
    13. 
  
  
  
  13.  var game = new Game(DateTime.Now, volleyball, team1, team2);
    14. 
  
  
  
  14.  using (var odb = OdbFactory.Open(TutorialDb5MinName))
    15. 
  
  
  
  15.      odb.Store(game);
    16.

3.2 再看看几个简单的查询例子

最简单的，注释就免了，都比较简单

 
 
 
    
  
  
  
  1. using (var odb = OdbFactory.Open(TutorialDb5MinName))
    2. 
  
  
  
  2.  {
    3. 
  
  
  
  3.      var query = odb.Query();
    4. 
  
  
  
  4.      query.Descend("Name").Constrain("julia").Equal();
    5. 
  
  
  
  5.      var players = query.Execute();
    6. 
  
  
  
  6.      Console.WriteLine("\nStep 3 (Soda): Players with name julia");
    7. 
  
  
  
  7.      foreach (var player in players)
    8. 
  
  
  
  8.          Console.WriteLine("\t{0}", player);
    9. 
  
  
  
  9.      Assert.That(players, Has.Count.EqualTo(1));
    10. 
  
  
  
  10.  }
    11.

看看这种，LINQ的查询方式：

 
 
 
    
  
  
  
  1. using (var odb = OdbFactory.Open(TutorialDb5MinName))
    2. 
  
  
  
  2. {
    3. 
  
  
  
  3.     var players = from player in odb.AsQueryable()
    4. 
  
  
  
  4.                   where player.Name.Equals("julia")
    5. 
  
  
  
  5.                   select player;
    6. 
  
  
  
  6.     Console.WriteLine("\nStep 3 (Linq): Players with name julia");
    7. 
  
  
  
  7.     foreach (var player in players)
    8. 
  
  
  
  8.         Console.WriteLine("\t{0}", player);
    9. 
  
  
  
  9.     Assert.That(players.Count(), Is.EqualTo(1));
    10. 
  
  
  
  10. }
    11.

简单的例子就写这么多吧。实际的还有很多灵活的操作，比如比较，查询，还对表直接的关系等等。如果有兴趣，适合你，可以看后面的资源链接。

4.NDatabase资源

1.开源网址：

https://ndatabase.codeplex.com/

http://ndatabase.wix.com/home#!overview/c18h9

http://ndatabase.net/

2.教程地址：

官方5分钟入门使用教程

官方1分钟入门使用教程

NDataBase教程及说明文档

官方数据库性能测试及对比

网页名称：C#开源轻量级对象数据库NDatabase介绍
本文来源：http://www.shufengxianlan.com/qtweb/news40/343490.html

网站建设、网络推广公司-创新互联，是专注品牌与效果的网站制作，网络营销seo公司；服务项目有等

广告

声明：本网站发布的内容（图片、视频和文字）以用户投稿、用户转载内容为主，如果涉及侵权请尽快告知，我们将会在第一时间删除。文章观点不代表本网站立场，如需处理请联系客服。电话：028-86922220；邮箱：631063699@qq.com。内容未经允许不得转载，或转载时需注明来源： 创新互联

猜你还喜欢下面的内容

域名注册知识

同城分类信息

网站推广　　 　绵竹做网站　　 　攀枝花网站设计　　 　营销网站建设　　 　网站建设公司　　 　青年旅行社　　 　成都网站设计　　 　雪茄烟　　 　网站seo优化　　 　成都花箱厂家　　 　高防服务器租用　　 　成都网站推广　　 　手提袋印刷制作　　 　成都网站设计　　 　成都画册制作　　 　资中网站建设　　 　成都机柜租用　　 　温江服务器租用　　 　西信中心　　 　贵州义龙电信机房