首页 > 代码库 > Rafy 领域实体框架 - 树型实体功能(自关联表)

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。如果确实需要深入了解,那么在理解了整个树的结构设计后,再结合帮助、注释以及源码中的单元测试,相信也会比较简单。

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