树实体

树实体

TypeORM支持用于存储树结构的Adjacency列表和Closure表模式。要了解有关层次结构表的更多信息，请查看this awesome presentation by Bill Karwin。

邻接清单

邻接列表是一个具有自引用的简单模型。这种方法的好处是简单，缺点是由于连接限制，您无法一次性加载整个树结构。要了解有关邻接列表的好处和用途的更多信息，请参阅 this article by Matthew Schinckel.

例如：:

import {Entity, Column, PrimaryGeneratedColumn, ManyToOne, OneToMany} from "typeorm";
@Entity()
export class Category {
    @PrimaryGeneratedColumn()
    id: number;
    @Column()
    name: string;
    @Column()
    description: string;
    @ManyToOne(type => Category, category => category.children)
    parent: Category;
    @OneToMany(type => Category, category => category.parent)
    children: Category[];
}

嵌套集

嵌套集是在数据库中存储树结构的另一种模式。它对读取非常有效，但对写入不利。且不能在嵌套集中有多个根。例如：

import {Entity, Tree, Column, PrimaryGeneratedColumn, TreeChildren, TreeParent, TreeLevelColumn} from "typeorm";
@Entity()
@Tree("nested-set")
export class Category {
    @PrimaryGeneratedColumn()
    id: number;
    @Column()
    name: string;
    @TreeChildren()
    children: Category[];
    @TreeParent()
    parent: Category;
}

物化路径(又名路径枚举)

物化路径（也称为路径枚举）是在数据库中存储树结构的另一种模式。它简单有效。例如：

import {Entity, Tree, Column, PrimaryGeneratedColumn, TreeChildren, TreeParent, TreeLevelColumn} from "typeorm";
@Entity()
@Tree("materialized-path")
export class Category {
    @PrimaryGeneratedColumn()
    id: number;
    @Column()
    name: string;
    @TreeChildren()
    children: Category[];
    @TreeParent()
    parent: Category;
}

闭合表

闭合表以特殊方式在单独的表中存储父和子之间的关系。它在读取和写入方面都很有效。例如：

import {Entity, Tree, Column, PrimaryGeneratedColumn, TreeChildren, TreeParent, TreeLevelColumn} from "typeorm";
@Entity()
@Tree("closure-table")
export class Category {
    @PrimaryGeneratedColumn()
    id: number;
    @Column()
    name: string;
    @TreeChildren()
    children: Category[];
    @TreeParent()
    parent: Category;
}

使用树实体

要使绑定树实体彼此关系，将其父项设置为子实体并保存它们很重要例如：

const manager = getManager();
const a1 = new Category("a1");
a1.name = "a1";
await manager.save(a1);
const a11 = new Category();
a11.name = "a11";
a11.parent = a1;
await manager.save(a11);
const a12 = new Category();
a12.name = "a12";
a12.parent = a1;
await manager.save(a12);
const a111 = new Category();
a111.name = "a111";
a111.parent = a11;
await manager.save(a111);
const a112 = new Category();
a112.name = "a112";
a112.parent = a11;
await manager.save(a112);

加载树时使用TreeRepository:

const manager = getManager();
const trees = await manager.getTreeRepository(Category).findTrees();

trees 如下:

[{
    "id": 1,
    "name": "a1",
    "children": [{
        "id": 2,
        "name": "a11",
        "children": [{
            "id": 4,
            "name": "a111"
        }, {
            "id": 5,
            "name": "a112"
        }]
    }, {
        "id": 3,
        "name": "a12"
    }]
}]

还有其他一些特殊的方法可以处理树形实体，比如TreeRepository：

findTrees - 返回数据库中所有树，包括所有子项，子项的子项等。

const treeCategories = await repository.findTrees();
// 返回包含子类别的根类别

findRoots - 根节点是没有祖先的实体。找到所有根节点但不加载子节点。

const rootCategories = await repository.findRoots();
// 返回没有子类别的根类别

findDescendants - 获取给定实体的所有子项（后代）。将它们全部返回到数组中。

const childrens = await repository.findDescendants(parentCategory);
// 返回parentCategory的所有直接子类别（没有其嵌套类别）

findDescendantsTree - 获取给定实体的所有子项（后代）。

const childrensTree = await repository.findDescendantsTree(parentCategory);
// 返回parentCategory的所有直接子类别（及其嵌套类别）

createDescendantsQueryBuilder - 创建用于获取树中实体的后代的查询构建器。

const childrens = await repository
    .createDescendantsQueryBuilder("category", "categoryClosure", parentCategory)
    .andWhere("category.type = 'secondary'")
    .getMany();

countDescendants - 获取实体的后代数。

const childrenCount = await repository.countDescendants(parentCategory);

findAncestors - 获取给定实体的所有父（祖先）。将它们全部返回到数组中。

const parents = await repository.findAncestors(childCategory);
// 返回所有直接childCategory的父类别（和"parent 的 parents"）

findAncestorsTree - Gets all parent (ancestors) of the given entity. Returns them in a tree - nested into each other.

const parentsTree = await repository.findAncestorsTree(childCategory);
// 返回所有直接childCategory的父类别 (和 "parent 的 parents")

createAncestorsQueryBuilder - 创建用于获取树中实体的祖先的查询构建器。

const parents = await repository
    .createAncestorsQueryBuilder("category", "categoryClosure", childCategory)
    .andWhere("category.type = 'secondary'")
    .getMany();

countAncestors - 获取实体的祖先数。

const parentsCount = await repository.countAncestors(childCategory);