Django笔记六之外键ForeignKey介绍

本文首发于微信公众号：Hunter后端

原文链接：Django笔记六之外键ForeignKey介绍

这一篇笔记介绍 Django 系统 model 的外键处理，ForeignKey 以及相应的处理方法。

这是一种一对多的字段类型，表示两张表之间的关联关系。

本篇笔记的目录如下：

1. on_delete
2. related_name
3. related_query_name
4. 外键字段的保存

1、on_delete

假设有两个 application，app1 和 app2

app1 下的 某个 model 为 App1

app2 下的 某个 model 为 App2

# app1/models.py
class App1(models.Model):
    app2 = models.ForeignKey("app2.App2", on_delete=models.CASCADE)

# app2/models.py
class App2(models.Model):
    pass

当我们设置 ForeignKey 的时候，有一个 on_delete 参数，主要用于当被关联的外键的数据被删除时，自身数据的处理。

在我们上面的两个 model 的例子便是，当 App2 的某个数据被删除时，关联了该条数据的 App1 的数据的处理方式。

处理方式主要有以下几种：

CASCADE
关联删除，App2 的数据被删除时，App1 关联的数据也被删除

PROTECT
保护处理，如果 App2 的数据被 App1 关联，那么关联了的 App2 的数据不会被删除

SET_NULL
置空处理，如果 App2 的数据被删除，App1 中关联了该条被删除的App2的数据这个字段都会被设置为 NULL

DO_NOTHING
不处理，原数据不会有任何操作，也就是说 App2 的某条数据被删除，App1 中的引用还在。

但其实这是一种不推荐的做法，因为如果访问到 App1 中的这条数据，用到了 app2 这个字段，就会报错。

2、related_name

ForeignKey 有一个属性，related_name，用于表示从相关对象到此对象的关系的名称，仅用于展示，但是如果 related_query_name 字段没有被赋值的话，那么 related_query_name 则会默认使用 related_name 这个值。

注意： related_name 还有一个用途，就是在同一个 class 下面，如果有两个字段都是另一个 model 的外键字段，这时候添加 related_name 用来区分两个字段是必须的。

示例如下：

class Entry(models.Model):
    blog_old = models.ForeignKey(Blog, related_name='old_entry')
    blog_new = models.ForeignKey(Blog, related_name='new_entry')

3、related_query_name

这个字段主要用于反向过滤器的搜索，这个字段如果没有单独赋值，则会默认使用 related_name 的值。

关于反向过滤器，我们可以来看下这个功能，以下是两个 model：

class Blog(models.Model):
    pass

class Entry(models.Model):
    blog = models.ForeignKey(Blog)

现在我们有一个 Blog 的数据，

blog_1 = Blog.objects.get(id=1)

如果我们想要获取所有 Entry 表里 blog 这个字段的值为 blog_1，怎么处理呢，一般来说是：

entry_list = Entry.objects.filter(blog=blog_1)

但是因为 blog 这个字段是 外键，所以我们使用 反向过滤器 来处理：

entry_list = blog_1.entry_set.all()

上面就是我们 反向过滤器 的用法，就是使用关联的model 的名称的小写 + '_set' 来操作，这是一个固定用法。

但是如果我们设置了 related_query_name 这个字段， model名称小写+'_set' 的用法就可以废弃了，可以直接使用 related_query_name 来操作，比如 Entry 如下：

class Entry(models.Model):
    blog = models.ForeignKey(Blog, related_name="entries")

这时候，我们没有设置 related_query_name 的值，所以会自动使用 related_name 的值，使用 反向过滤器 的方法如下：

entry_list = blog_1.entries.all()

4、外键字段的保存

首先我们先来介绍一下外键字段在数据库和 model 里的样子。

在 model 里，以 Entry 为例，我们可以看到，关键 blog 字段，直接命名为 'blog'，

但是在数据库的结构里，我们去查看的话，可以看到该字段为 blog_id。

当我们获取了一个 Entry 实例，为 entry_obj，

entry_obj = Entry.objects.get(id=1)

当我们输出 entry_obj.blog，返回的就是一个 Blog 的实例，是一个 object，

而输出 entry_obj.blog_id，返回的就是一个int 型的数据。

那么，我们如何为 Entry 实例保存 blog 字段呢，
如果我们有一个 blog 实例为 blog_1，那么可以直接使用：

entry_obj.blog = blod_1
entry_obj.save()

如果我们有某个 Blog 的主键 id 为 blog_id，那么我们可以这样操作：

entry_obj.blog_id = blod_id
entry_obj.save()

以上就是我们这篇介绍外键的全部内容，接下来的笔记我们将介绍 ManyToMany，OneToOne 的用法。

如果想获取更多相关文章，可扫码关注阅读：