STSdb 4.0 入门说明文档（有部分删减） NoSQL yz

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.