Rafy 领域实体框架 - 树型实体功能（自关联表）

在 Rafy 领域实体框架中，对自关联的实体结构做了特殊的处理，下面对这一功能进行讲解。

场景

在开发数据库应用程序时，往往会遇到自关联表的场景。例如，分类信息、组织架构中的部门、文件夹信息等，都是不限制层级的。如下图中操作系统的文件夹：

image

在开发这类程序时，往往是设计一张表，表中的一个可空的外键直接引用这张表本身。对应的实体如下图：

image

而针对这样的场景，许多ORM框架都不做默认的处理，开发者往往每次都要做重复的工作：建立类似结构的表，编写关系处理代码，编写查询代码……而这种场景经常会出现，所以 Rafy 实体框架中，默认就支持了树型实体的一系列功能，来降低重复劳动。

功能及使用说明

在 Rafy 中的树型实体功能，只需开发者使用一行代码为指定的实体打开这个功能，框架会自动完成以下工作：

• 自动添加实体的自引用关系。自动生成数据库自关联表。
• 自动维护树节点的 TreeIndex 索引。
• 自带多个查询，用于查询树节点。
• 查询结果自动转变为树的结构。
• 支持树节点的按需加载。

下面，将逐一进行讲解。

打开树型实体功能

开发者只需使用一行代码即可让指定的实体转变为树型实体。在指定实体的配置代码中，添加下面这行代码即可：

image

自动添加实体的自引用关系

实体基类上已经默认带有以下几个属性，来表达树节点之间的关系。

image

当某个实体类型被配置为树型实体时，这几个属性才会有意义。 SupportTree：指示该实体是否为树型实体。 TreeIndex：树节点的编码、索引。此属性会映射为数据库中的字段。 TreePId：该树节点的父节点的 Id。此属性会映射为数据库中的字段。 TreeParent：该树节点的父节点实体。 TreeChildren：该树节点的所有子节点集合。

自动生成数据库自关联表

运行程序后，该实体对应的表将会自动添加两个字段：TreeIndex、TreePId，如下图：

image

自动维护树节点的 TreeIndex 索引

TreeIndex 是树结点的系统编号，由框架自动维护。下图显示了一个正在使用的树的 TreeIndex 的格式：

image

这个属性不但可以用于显示，更重要的是它是树型实体大量功能的结构基础。例如，当查询某个节点下的所有节点时，就是通过 TreeIndex 来进行模糊匹配的。所以这个属性的值非常重要，只能由框架来自行维护，而不能由开发者来设置。

开发者可以通过 TreeParent、TreeChildren、TreePId 等属性来变更节点与节点之间的父子关系，这时，对应的节点的 TreeIndex 则会同时自动变更。

树结构的表示

树的结构非常重要，我手画了张草图来表示：

image

主要由三个类型构成整个树：EntityList、Entity、EntityTreeChildren。这个结构可以表示完整的一棵树，也可以表示部分树。其中，EntityList 用于存储树的根节点（如果是部分树，则表示最上层节点）；Entity 表示树中的每一个节点；EntityTreeChildren 集合则表示某个节点下的子节点。

另外，EntityTreeChildren 集合可以按需加载。当它还没有进行加载时，遍历整个树只能遍历到当前已经在内存中的树节点。例如，上图中，Root3的子节点没有被加载，1.2.2 的子节点也没有被加载。

那么，如何加载还没有加载到内存中的节点呢？这需要使用到 ITreeComponent 接口中的 LoadAllNodes 方法。EntityList、Entity、EntityTreeChildren 这三个类型都实现了 ITreeComponent 接口，下面是这个接口的定义：

image

另外，可以使用其中的 EachNode 方法来以深度优先的算法遍历整棵树。

自带多个查询，用于查询树节点

实体仓库中带有许多查询方法，其中一些是专门为树型实体设计的：

• GetTreeRoots：查询所有的根节点。
• GetByTreePId：查找指定树节点的直接子节点。
• GetByTreeParentIndex：递归查找指定父索引号的节点下的所有子节点。
• LoadAllTreeParents：递归加载某个节点的所有父节点。使用此方法后，指定节点的父节点将被赋值到它的 TreeParent 属性上。
• GetAllTreeParents：获取指定索引对应的树节点的所有父节点。 查询出的父节点同样以一个部分树的形式返回。

另外，一些非树实体的查询方法，对于树型实体也是可用的。如 GetAll、GetByParentId 等。但是也会有所区别，例如 GetAll 方法在查询非树实体时，查询出的实体列表中包含所有的实体；但是在查询树型实体时，结果会按照树的结构来进行加载，即列表中只会有根节点，其它节点则分别在根节点的下级节点中。

同时，这些查询往往支持是否使用贪婪加载的参数。以 GetTreeRoots 方法举例，它的接口是这样的：public EntityList GetTreeRoots(EagerLoadOptions eagerLoad = null); 。它在默认情况下只返回根节点，而根节点中的子节点是没有被加载的。但是，我们可以通过参数中的 eagerLoad 来指定，在加载根节点的同时，把所有的子节点都加载上。

以上只是对一些接口做一些必要的解释，具体的使用方法及其它的接口，请参照注释及源码中的单元测试。

image

限制

说了上面这么多自带的功能，但是 Rafy 中树型实体的设计也有这的限制：一个树型实体类型对应的数据表中，只能存储一棵树。树中的所有节点的 TreeIndex 都必须是唯一的。

好了，鉴于篇幅，这篇文章只是简单地讲解了树型实体中的重点概念及功能，并没有深入说明。这是因为，在使用的过程中你会发现，一般情况下用起来非常容易，只需要打开树型实体功能，并调用想要的查询就可以了，用不到特别复杂的 API。如果确实需要深入了解，那么在理解了整个树的结构设计后，再结合帮助、注释以及源码中的单元测试，相信也会比较简单。