您好,登錄后才能下訂單哦!
如何理解C#開源輕量級(jí)對(duì)象數(shù)據(jù)庫NDatabase,很多新手對(duì)此不是很清楚,為了幫助大家解決這個(gè)難題,下面小編將為大家詳細(xì)講解,有這方面需求的人可以來學(xué)習(xí)下,希望你能有所收獲。
今天向大家介紹一款.NET下的開源輕量級(jí)對(duì)象數(shù)據(jù)庫NDatabase,花了1天時(shí)間看了一下文檔和一些例子。覺得有必要把一些東西整理成中文文檔,也方便大家。本來想把以前的一個(gè)小項(xiàng)目改造一下,做一個(gè)例子的。無奈,時(shí)間不是很充足,還要忙著找工作。所以大家自己看看,這個(gè)數(shù)據(jù)庫在某些方面還是很有用的。下面的總計(jì)都是按照官方文檔進(jìn)行翻譯的,稍微去掉和修改了一些,總結(jié)了一下該數(shù)據(jù)庫的一些特點(diǎn)和特性。然后把重點(diǎn)寫出來了。簡(jiǎn)單的增刪查改在后門的例子中。翻譯水平有限,敬請(qǐng)指點(diǎn):
1.前言
NDatabase是一個(gè)易于使用的.NET對(duì)象數(shù)據(jù)庫。為了避免關(guān)系數(shù)據(jù)庫帶來的開銷,可以嘗試用NDatabase。NDatabase是新一代的面向?qū)ο髷?shù)據(jù)庫:1個(gè)原生的.NET數(shù)據(jù)庫持久層。它的主要特征有:
·簡(jiǎn)單:NDatabase非常簡(jiǎn)單,很容易學(xué)習(xí)上手使用;它API是簡(jiǎn)單,不需要學(xué)習(xí)任何數(shù)據(jù)庫映射技術(shù);不需要對(duì)象和存儲(chǔ)持久層之間的映射;NDatabase以最簡(jiǎn)單的方式存儲(chǔ)對(duì)象;不需要安裝和管理。
·?。篘Database 運(yùn)行時(shí)小于300Kb,部署程序的時(shí)候,很容易集成到.NET應(yīng)用程序中去。
·安全健壯:NDatabase支持ACID事務(wù)處理,保證數(shù)據(jù)的完整性。即使在硬件故障的情況下,所有的提交工作都會(huì)應(yīng)用到數(shù)據(jù)庫,在下一次啟動(dòng)的時(shí)候自動(dòng)執(zhí)行。
·單一數(shù)據(jù)庫文件:NDatabase使用單一的文件存儲(chǔ)所有的數(shù)據(jù),包括元數(shù)據(jù),對(duì)象,索引等。
·生產(chǎn)率:NDatabase使用很少的代碼來進(jìn)行數(shù)據(jù)持久化,不需要映射。因此,開發(fā)人員可以專注于業(yè)務(wù)邏輯的實(shí)現(xiàn),而不是在數(shù)據(jù)持久層浪費(fèi)時(shí)間。
2.NDatabase入門
2.1 基礎(chǔ)設(shè)置
NDatabase中所有的數(shù)據(jù)庫引擎設(shè)置都在OdbConfiguration類中。如BTree Validation,和BTree index degree的設(shè)置都在這個(gè)類里面,打開日志的設(shè)置也在這個(gè)類里面。NDatabase提供了默認(rèn)的日志類實(shí)現(xiàn):ConsoleLogger,可以使用OdbConfiguration類中的EnableConsoleLogger方法進(jìn)行設(shè)置。實(shí)現(xiàn)好自定義的日志類后,還需要進(jìn)行注冊(cè)RegisterLogger方法,才能夠使用。
OdbConfiguration.RegisterLogger(new Log4NetLogger());
2.2 使用索引
使用IOdb接口的IndexManagerFor方法可以為指定類型添加索引,如:
using (var odb = OdbFactory.Open("index1.ndb")) { var fields = new[] { "Name" }; odb.IndexManagerFor<Player>().AddUniqueIndexOn("nameIndex", fields); odb.IndexManagerFor<Game>().AddIndexOn("nameIndex", new[] { "Result" }); }
2.3 使用事務(wù)
NDatabase可以使用事務(wù)來保證數(shù)據(jù)的完整性(ACID:原子性,一致性,隔離性,持久性)。當(dāng)一個(gè)NDatabase被打開后,將會(huì)自動(dòng)創(chuàng)建一個(gè)會(huì)話,包含一個(gè)特殊的當(dāng)前事務(wù)對(duì)象,這個(gè)事務(wù)對(duì)象實(shí)例管理當(dāng)前所有的數(shù)據(jù)和數(shù)據(jù)操作行為。
2.4 內(nèi)存數(shù)據(jù)庫模式
NDatabase可以將數(shù)據(jù)庫所有數(shù)據(jù)直接加載到內(nèi)存中,直接使用OdbFactory方法的 OpenInMemory即可。
2.5 關(guān)于觸發(fā)器
要增加一個(gè)觸發(fā)器,首先要建立一個(gè)實(shí)現(xiàn)了Trigger 接口()的類,該接口有4種可用的類型(InsertTrigger,UpdateTrigger,SelectTrigger,DeleteTrigger)。如:
public class MyTrigger : InsertTrigger { public override bool BeforeInsert(object obj) { return true; } public override void AfterInsert(object obj, OID oid) { } }
在使用過程中,打開數(shù)據(jù)庫后,要注冊(cè)觸發(fā)器,才能使用:
var mage = new Mage("Merlin", 3.3, 3.4); var myTrigger = new MyTrigger(); using (var odb = OdbFactory.Open("inserting_trigger.db")) { odb.TriggerManagerFor<Mage>().AddInsertTrigger(myTrigger); odb.Store(mage); }
2.6 擴(kuò)展數(shù)據(jù)庫架構(gòu)
在數(shù)據(jù)庫的使用周期中,類型的定義可能會(huì)改變,NDatabase提供了重構(gòu)管理接口,可以擴(kuò)展數(shù)據(jù)庫架構(gòu),使用IRefactorManager可以重命名類型名稱和字段名稱,以及增加和刪除字段。如下列代碼:
using (var odb = OdbFactory.Open("Refactoring.odb")) { var refactorManager = odb.GetRefactorManager(); refactorManager.RenameField(typeof(User), "age", "_age"); refactorManager.RenameField(typeof(User), "name", "_name"); }
2.7 自定義日志接口
2.1節(jié)中提到了日志的配置,可以自定義日志類,注冊(cè)后使用,如下所示:
public class Log4NetLogger : ILogger { private static readonly ILog Log = LogManager.GetLogger(typeof (ILogger)); #region Implementation of ILogger public void Warning(string message) { Log.Warn(message); } public void Debug(string message) { Log.Debug(message);} public void Info(string message) { Log.Info(message); } public void Error(string message) { Log.Error(message);} public void Error(string message, Exception t) { Log.Error(message); Log.ErrorFormat("Error: {0}, exception: {1}", t.Message, t); } #endregion }
2.8 異常處理
NDatabase使用內(nèi)部的異常處理類型來處理錯(cuò)誤,以下是NDatabase中的異常類型:
BTreeException
BTreeNodeValidationException
DuplicatedKeyException
CorruptedDatabaseException
LinqQueryException
2.9 非持久屬性
如果有一些屬性不想保存到數(shù)據(jù)庫,可以使用[NonPersistent]屬性。
3.實(shí)際使用的幾個(gè)例子
使用之前當(dāng)然要先有實(shí)體類,例子的實(shí)體類采用最簡(jiǎn)單的,這里有些地方就不寫出來了。
3.1 2個(gè)保存對(duì)象的例子
先看簡(jiǎn)單的:
var sport = new Sport("volley-ball"); using (var odb = OdbFactory.Open(TutorialDb5MinName))//打開數(shù)據(jù)庫 odb.Store(sport);
再看復(fù)雜的:
View Code var volleyball = new Sport("volley-ball"); var player1 = new Player("julia", DateTime.Now, volleyball); var player2 = new Player("magdalena", DateTime.Now, volleyball); var player3 = new Player("jacek", DateTime.Now, volleyball); var player4 = new Player("michal", DateTime.Now, volleyball); var team1 = new Team("Krakow"); var team2 = new Team("Skawina"); team1.AddPlayer(player1); team1.AddPlayer(player2); team2.AddPlayer(player3); team2.AddPlayer(player4); var game = new Game(DateTime.Now, volleyball, team1, team2); using (var odb = OdbFactory.Open(TutorialDb5MinName)) odb.Store(game);
3.2 再看看幾個(gè)簡(jiǎn)單的查詢例子
最簡(jiǎn)單的,注釋就免了,都比較簡(jiǎn)單
using (var odb = OdbFactory.Open(TutorialDb5MinName)) { var query = odb.Query<Player>(); query.Descend("Name").Constrain("julia").Equal(); var players = query.Execute<Player>(); Console.WriteLine("\nStep 3 (Soda): Players with name julia"); foreach (var player in players) Console.WriteLine("\t{0}", player); Assert.That(players, Has.Count.EqualTo(1)); }
看看這種,LINQ的查詢方式:
using (var odb = OdbFactory.Open(TutorialDb5MinName)) { var players = from player in odb.AsQueryable<Player>() where player.Name.Equals("julia") select player; Console.WriteLine("\nStep 3 (Linq): Players with name julia"); foreach (var player in players) Console.WriteLine("\t{0}", player); Assert.That(players.Count(), Is.EqualTo(1)); }
簡(jiǎn)單的例子就寫這么多吧。
看完上述內(nèi)容是否對(duì)您有幫助呢?如果還想對(duì)相關(guān)知識(shí)有進(jìn)一步的了解或閱讀更多相關(guān)文章,請(qǐng)關(guān)注億速云行業(yè)資訊頻道,感謝您對(duì)億速云的支持。
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如果涉及侵權(quán)請(qǐng)聯(lián)系站長(zhǎng)郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。