代码改变世界

STSdb 4.0 入门说明文档(有部分删减)- NoSQL

2013-05-28 08:51  y-z-f  阅读(5101)  评论(13编辑  收藏  举报

STSdb 4.0 说明文档

 介于本人英语水平有限,如果有任何错误请留言,谢谢。

简单实例

  1. 打开数据库并且创建一个简单的表

      2.从表中读取

         

 

             存储引擎

                           STSdb 4.0 的存储引擎是基于瀑布树TM 实现的。存储引擎提供了两种数据结构—XIndexXFile。一个存储引擎可以包含多个 XIndex表和多个XFile文件。

 

             XIndex

                         XIndex是一个已经排序的键值存储映射(表)。我们可以在一个存储引擎中利用不同类型的键值打开不同属性的表。并且在每个表的行数上没有任何限制。

 

     提示:engine.Commit() 提交所有已经刷新的表的更改。在正式发布的每个表,Commit() 方法将会被忽略

 

  1. XIndex<TKey,TRecord> 支持的类型

         

            TKeyTRecord支持的类型有:

                     1.1. 基本类型—Boolean,Char,SByte,Byte,Int16,UInt16,Int32,UInt32,Int64,UInt64,Single,Double,Decimal,DateTime,String,byte[];

                     1.2. 拥有默认构造函数的类或结构体,并且特性的类型是公共的,类型是1.1.中指定的

                     1.3. 拥有默认构造函数的类或结构体,并且特性的类型是公共的,类型是1.1.和1.2.中指定的

                                如例子,如果我们拥有以下两种类型:

                                           

 

                               我们可以打开不同类型的表:

                                           

                                           

                                     乃至:

                                           

                            至于复合键,引擎比较子键,在排序已经声明的特性。

  

            2.XIndex<TKey,TRecord> 方法

                             XIndex<TKey,TRecord> 实现了 IIndex<TKey,TRecord> 接口。

              基本用户方法:

                        

                        

                           默认的XIndex枚举正序遍历表的行

                                      Forward() 方法正序遍历表的行 

                                      Backward() 方法反序遍历表的行

 

                                     FindNext() 返回大于或等于指定行的第一个(如果存在)

                                     FindAfter() 返回大于指定行的第一个(如果存在)

                                     FindPrev() 返回小于或等于指定行的第一个(如果存在)

                                     FindBefore() 返回小于指定行的第一个(如果存在)

 

                                    FirstRow 返回键最小的那一行

                                    LastRow 返回键最大的那一行

                         异步改变XIndex的内容的方法——他们会产生一定的操作在瀑布树中

                          -          This[TKey key] set;

                          -          Replace(TKey key, TRecord record);

                          -          Delete(TKey key);

                          -          Clear();

 

        3.XIndex<TKey,TRecord> 基础

                      正如我们所提到的,每个储存引擎可以处理不同类型的XIndex<TKey,TRecord> 表.每个TKeyTRecord可以是任何基本类型、结构体或者类。但是在所有的情况下,每个XIndex<TKey,TRecord> 使用一个指定的非通用 XIndex 表来存储它的数据。

                                      

                     当一个 XIndex<TKey,TRecord> 被创建后,它将利用.NET表达式自动生成并且编译转换代码以便将每个TKeyTRecord 对象转换成能够支持 IData 对象。因此,从一个数据库的观念来看,XIndex<TKey,TRecord> 经过应用数据层和内置数据层之间的转换层之后快速的呈现。即使开发者可能使用了自定义类型的应用数据,也保证了内置存储的独立性。

 

        4.XIndex 和IData 继承

                   XIndex 表和内部继承的IData一起工作。在STSdb 4.0 中被忽略

                 

            当前版本的TKeyTRcord最大可以支持64个位置。每个位置可以是任何基本类型。

 

            以下代码演示了直接使用非通用的XIndex的情况

                

 

               

         数据转换器将会尽力的将IData类型转换成应用类型。他们由XIndex<TKey,TRecord>XIndex表之间的转换层构成。所有转换器看起来像:

               

        每个XIndex<TKey,TRecord> 实例自动实现两种数据转换 - 一种是keys另一种是records。那么每个输入的TKey/TRecord对象会被转换成适当的IData对象。同样的,每个来自XIndexIData对象都已经被隐藏的转换成了TKey/TRecord.

        假设我们现在有以下类:

               

       如果我们有XIndex<long,Tick>

             

       然后XIndex表将会被以下两种类型的,keysrecords打开:

            

      我们可以同时打开后台的 XIndex

            

      最终 tabletable2 将会得到同样的数据

 

     如果我们决定扩展Tick类的property,改成非基本类型。

           

      然后后台XIndex将会采用以下类型被打开

         

     如果我们决定排除 Symbol Timestamp 并且采用他们作为复合键:

        

        

      然后后台XIndex将会采用以下类型打开:

         

XFile

      STSdb 4.0 通过使用XFile以支持稀疏的文件。我们可以跟使用.NET流一样使用XFile。

         

 

注:新版中部分方法已经与本教程有一定的出入