# 关系
* [什么是关系](#什么是关系)
* [关系选项](#关系选项)
* [级联](#级联)
* [`@JoinColumn`选项](#`@JoinColumn`选项)
* [`@JoinTable`选项](#`@JoinTable`选项)
## 什么是关系
关系可以帮助你轻松地与相关实体合作。
有几种类型的关系:
* [一对一](./one-to-one-relations.md) 使用 `@OneToOne`
* [多对一](./many-to-one-one-to-many-relations.md) 使用 `@ManyToOne`
* [一对多](./many-to-one-one-to-many-relations.md) 使用 `@OneToMany`
* [多对多](./many-to-many-relations.md) 使用 `@ManyToMany`
## 关系选项
你可以为关系指定几个选项:
- `eager: boolean` - 如果设置为 true,则在此实体上使用`find *` 或`QueryBuilder`时,将始终使用主实体加载关系
- `cascade: boolean` - 如果设置为 true,则将插入相关对象并在数据库中更新。
- `onDelete: "RESTRICT"|"CASCADE"|"SET NULL"` - 指定删除引用对象时外键的行为方式
- `primary: boolean` - 指示此关系的列是否为主列。
- `nullable: boolean` -指示此关系的列是否可为空。 默认情况下是可空。
## 级联
级联例子:
```typescript
import { Entity, PrimaryGeneratedColumn, Column, ManyToMany } from "typeorm";
import { Question } from "./Question";
@Entity()
export class Category {
@PrimaryGeneratedColumn()
id: number;
@Column()
name: string;
@ManyToMany(type => Question, question => question.categories)
questions: Question[];
}
```
```typescript
import { Entity, PrimaryGeneratedColumn, Column, ManyToMany, JoinTable } from "typeorm";
import { Category } from "./Category";
@Entity()
export class Question {
@PrimaryGeneratedColumn()
id: number;
@Column()
title: string;
@Column()
text: string;
@ManyToMany(type => Category, category => category.questions, {
cascade: true
})
@JoinTable()
categories: Category[];
}
```
```typescript
const category1 = new Category();
category1.name = "animals";
const category2 = new Category();
category2.name = "zoo";
const question = new Question();
question.categories = [category1, category2];
await connection.manager.save(question);
```
正如您在本示例中所看到的,我们没有为`category1`和`category2`调用`save`。
由于我们将`cascade`设置为 true,因此它们将自动插入数据库。
请记住,能力越大,责任越大。
级联可能看起来像是一种处理关系的好方法,
但是当一些不需要的对象被保存到数据库中时,它们也可能带来错误和安全问题。
此外,它们提供了一种将新对象保存到数据库中的不太明确的方法。
## `@JoinColumn`选项
`@ JoinColumn`不仅定义了关系的哪一侧包含带有外键的连接列,还允许自定义连接列名和引用的列名。
当我们设置`@ JoinColumn`时,它会自动在数据库中创建一个名为`propertyName + referencedColumnName`的列。
例如:
```typescript
@ManyToOne(type => Category)
@JoinColumn() // 这个装饰器对于@ManyToOne是可选的,但@OneToOne是必需的
category: Category;
```
此代码将在数据库中创建`categoryId`列。
如果要在数据库中更改此名称,可以指定自定义连接列名称:
```typescript
@ManyToOne(type => Category)
@JoinColumn({ name: "cat_id" })
category: Category;
```
Join 列始终是对其他一些列的引用(使用外键)。
默认情况下,关系始终引用相关实体的主列。
如果要与相关实体的其他列创建关系 - 你也可以在`@ JoinColumn`中指定它们:
```typescript
@ManyToOne(type => Category)
@JoinColumn({ referencedColumnName: "name" })
category: Category;
```
该关系现在引用`Category`实体的`name`,而不是`id`。
该关系的列名将变为`categoryName`
## `@JoinTable`选项
`@ JoinTable`用于“多对多”关系,并描述"junction"表的连接列。
联结表是由 TypeORM 自动创建的一个特殊的单独表,其中的列引用相关实体。
你可以使用`@ JoinColumn`更改联结表及其引用列中的列名:
你还可以更改生成的"junction"表的名称。
```typescript
@ManyToMany(type => Category)
@JoinTable({
name: "question_categories" // 此关系的联结表的表名
joinColumn: {
name: "question",
referencedColumnName: "id"
},
inverseJoinColumn: {
name: "category",
referencedColumnName: "id"
}
})
categories: Category[];
```
如果目标表具有复合主键,
则必须将一组属性发送到`@ JoinTable`。
- 快速开始
- 连接
- 使用 ormconfig
- Connection 选项
- 多个 Connection
- Connection API
- 实体
- 嵌入式实体
- 实体继承
- 树实体
- 视图实体
- 分离实体定义
- 关系
- 一对一
- 多对一/一对多的关系
- 多对多的关系
- Eager 和 Lazy 关系
- 关系常见问题
- Entity Manager 和 Repository
- Find 选项
- 自定义存储库
- EntityManager API
- Repository API
- Query Builder
- 使用 Query Builder 插入
- 使用 Query Builder 更新
- 使用 Query Builder 删除
- 与 Relations 结合
- 缓存查询
- 高级主题
- 迁移
- 事务
- 索引
- 实体监听器和订阅者
- 日志
- 使用 CLI
- 故障排除
- 指南
- Active Record 与 Data Mapper
- MongoDB
- 使用 Validation
- 使用 TypeORM 和 Express 的示例
- 使用 JavaScript
- 从 Sequelize 迁移到 TypeORM
- 帮助
- FAQ
- 支持的平台
- 装饰器参考
- 产品路线图
- 支持