STSdb 4.0 说明文档
介于本人英语水平有限,如果有任何错误请留言,谢谢。
简单实例
- 打开数据库并且创建一个简单的表
2.从表中读取
存储引擎
STSdb 4.0 的存储引擎是基于瀑布树TM 实现的。存储引擎提供了两种数据结构—XIndex和XFile。一个存储引擎可以包含多个 XIndex表和多个XFile文件。
XIndex
XIndex是一个已经排序的键值存储映射(表)。我们可以在一个存储引擎中利用不同类型的键值打开不同属性的表。并且在每个表的行数上没有任何限制。
提示:engine.Commit() 提交所有已经刷新的表的更改。在正式发布的每个表,Commit() 方法将会被忽略
-
XIndex<TKey,TRecord> 支持的类型
TKey和TRecord支持的类型有:
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> 表.每个TKey和TRecord可以是任何基本类型、结构体或者类。但是在所有的情况下,每个XIndex<TKey,TRecord> 使用一个指定的非通用 XIndex 表来存储它的数据。
当一个 XIndex<TKey,TRecord> 被创建后,它将利用.NET表达式自动生成并且编译转换代码以便将每个TKey和TRecord 对象转换成能够支持 IData 对象。因此,从一个数据库的观念来看,XIndex<TKey,TRecord> 经过应用数据层和内置数据层之间的转换层之后快速的呈现。即使开发者可能使用了自定义类型的应用数据,也保证了内置存储的独立性。
4.XIndex 和IData 继承
XIndex 表和内部继承的IData一起工作。在STSdb 4.0 中被忽略
当前版本的TKey和TRcord最大可以支持64个位置。每个位置可以是任何基本类型。
以下代码演示了直接使用非通用的XIndex的情况
数据转换器将会尽力的将IData类型转换成应用类型。他们由XIndex<TKey,TRecord>和XIndex表之间的转换层构成。所有转换器看起来像:
每个XIndex<TKey,TRecord> 实例自动实现两种数据转换 - 一种是keys另一种是records。那么每个输入的TKey/TRecord对象会被转换成适当的IData对象。同样的,每个来自XIndex的IData对象都已经被隐藏的转换成了TKey/TRecord.
假设我们现在有以下类:
如果我们有XIndex<long,Tick>
然后XIndex表将会被以下两种类型的,keys和records打开:
我们可以同时打开后台的 XIndex表
最终 table 和 table2 将会得到同样的数据
如果我们决定扩展Tick类的property,改成非基本类型。
然后后台XIndex将会采用以下类型被打开
如果我们决定排除 Symbol 和 Timestamp 并且采用他们作为复合键:
然后后台XIndex将会采用以下类型打开:
XFile
STSdb 4.0 通过使用XFile以支持稀疏的文件。我们可以跟使用.NET流一样使用XFile。
注:新版中部分方法已经与本教程有一定的出入