基于Django OneToOneField和ForeignKey的区别详解

(编辑：jimmy 日期: 2024/11/19 浏览：3 次 )

根据Django官方文档介绍：

A one-to-one relationship. Conceptually, this is similar to a ForeignKey with unique=True, but the “reverse” side of the relation will directly return a single object.

OneToOneField与ForeignKey加上unique=True效果基本一样，但是用OneToOneField反向关联会直接返回对象。

相反地，使用ForeignKey, 反向关联后会返回QuerySet。

例子：

from django.db import models

class Engine(models.Model):
 name = models.CharField(max_length=25)

 def __unicode__(self):
 return self.name

class Car(models.Model):
 name = models.CharField(max_length=25)
 engine = models.OneToOneField(Engine)

 def __unicode__(self):
 return self.name

class Engine2(models.Model):
 name = models.CharField(max_length=25)

 def __unicode__(self):
 return self.name

class Car2(models.Model):
 name = models.CharField(max_length=25)
 engine = models.ForeignKey(Engine2, unique=True)

 def __unicode__(self):
 return self.name

在python manage.py shell里输入:

> from testapp.models import Car, Engine
> c = Car.objects.get(name='Audi')
> e = Engine.objects.get(name='Diesel')
> e.car # OneToOneField的反向关联属性如果没有写relate_name, 则是对方类名的小写
<Car: Audi>

> from testapp.models import Car2, Engine2
> c2 = Car2.objects.get(name='Mazda')
> e2 = Engine2.objects.get(name='Wankel')
> e2.car2_set.all() # OneToOneField的反向关联属性如果没有写relate_name, 则是对方类名的小写_set
[<Car2: Mazda>]

补充知识：Django ForeignKey，ManyToManyField和OneToOneField的辨析

导引

模型（Models）是对网站所需信息种类的定义，其包含了网站存储数据中的重要字段和数据行为。一般来说，一个模型对于数据库中的一个表单。

字段（Fields）是模型的重要和唯一组成部分，他们由类别的属性值所指定。

Field分类

由官方文档Model field reference | Django Documentation定义：

Field一共分为AutoField、BinaryField、BooleanField、CharField、DateField、DecimalField、EmailField、FileField、FloatField、IntegerField、TextField、TimeField、URLField等类别，丰富的类别选项为数据库存储方式提供了完善的支持，而本文主要是针对如下三个关系型字段（Relationship fields）：

关系型字段对应关系 ForeignKey 多对一 ManyToManyField 多对多 OneToOneField 一对一

分析

ForeignKey

首先查看源码，在类的开头有如下参数：

many_to_many = False
many_to_one = True
one_to_many = False
one_to_one = False

由此可见，ForeignKey是many_to_one类型的，即“一对多”，我们引用官方文档给出的示例：

from django.db import models

class Car(models.Model):
 manufacturer = models.ForeignKey(
 'Manufacturer',
 on_delete=models.CASCADE,
 )
 # ...

class Manufacturer(models.Model):
 # ...
 pass

由此我们可以看到，Car类型中有manufacturer字段，其类型是对应Manufacturer类的ForeignKey。我们可以根据生活常识理解这种定义，由于一部汽车对应一个生产商，而一个生产商可以对应许多部汽车，所以两者具有“一对多”的关系，在此种情况我们使用ForeignKey。

对于每个ForeignKey，我们需要给出关联的模型和on_delete响应的选项，即

 manufacturer = models.ForeignKey(
 'Manufacturer',
 on_delete=models.CASCADE,
 )

on_delete函数的作用是在此字段被删除的时候做出的响应，其可选项如下：

选项功能 CASCADE 级联删除，此类选项模仿SQL语句ON DELETE CASCADE，再删除此字段信息的时候同时删除包含ForeignKey字段的目标（object） PROTECT 通过django.db.IntegrityError中的ProtectedError来保护此字段不被删除，若进行删除操作则抛出错误 SET_NULL 将ForeignKey置为空，这只在null选项为True的时候产生作用 SET_DEFAULT 设为默认值（default value），此默认值已预先对ForeignKey设置 SET() 对ForeignKey设置对SET()函数传递的数值 DO_NOTHING 不进行任何操作。若数据库提高了引用完整性，则此种设置会抛出一个IntegrityError，除非对这一数据字段手动添加了SQL语句中的ON DELETE字段

还可以通过设置abstract属性来定义一个抽象类：

from django.db import models

class AbstractCar(models.Model):
 manufacturer = models.ForeignKey('Manufacturer', on_delete=models.CASCADE)

 class Meta:
 abstract = True

ForeignKey还有如下的参数可以选择：

参数功能 limit_choices_to 通过一个限制对字段信息的某一可能选项进行约束，可以通过字典，函数或者查询值来设置 related_name 可以指定关联的类在本类中的名称，通过这一参数可以用两个字段名引用同一个类，通过这个名称父类可以取得子类的值，默认为字段名 related_query_name 用于filter函数过滤和values函数 to_field 关系关联的相关对象名称 db_constraint 控制在数据库中是否应该建立这一字段的约束 swappable 用于控制这一字段对于可交换类模型的行为

ManyToManyField

同样在源码中我们可以找到针对ManyToManyField的如下定义：

many_to_many = True
many_to_one = False
one_to_many = False
one_to_one = False

由此可以知道，ManyToManyField是针对“many-to-many”即多对多关系定义的，它需要知道它关联的类别。

官方文档给出的示例代码可以帮助理解：

from django.db import models

class Topping(models.Model):
 # ...
 pass

class Pizza(models.Model):
 # ...
 toppings = models.ManyToManyField(Topping)

在示例代码中，Pizza类的toppings字段由ManyToManyField与Toppings关联，我们可以由生活常识得出一片披萨上面会有很多种类的佐料，而一种佐料又可以用来制作多种披萨，两者满足“多对多”的关系。

ManyToManyField类有两个经常使用的参数：through和through_fields，通过这两个参数可以十分方便地建立中间项的关联，如示例代码所示：

from django.db import models

class Person(models.Model):
 name = models.CharField(max_length=50)

class Group(models.Model):
 name = models.CharField(max_length=128)
 members = models.ManyToManyField(
 Person,
 through='Membership',
 through_fields=('group', 'person'),
 )

class Membership(models.Model):
 group = models.ForeignKey(Group, on_delete=models.CASCADE)
 person = models.ForeignKey(Person, on_delete=models.CASCADE)
 inviter = models.ForeignKey(
 Person,
 on_delete=models.CASCADE,
 related_name="membership_invites",
 )
 invite_reason = models.CharField(max_length=64)

在Group类中有ManyToManyField类的字段members，这一字段通过through参数与membership联系起来，后者表示“成员资格”，即表示“团体”与“个人”之间关系的中间项，而“through_fields”字段即为中间项连接起来的两个类名，此处即group和person两个类。

ManyToManyField还有以下参数可以选择：

参数功能 related_name 同ForeignKey，可以指定关联的类在本类中的名称 related_query_name 同ForeignKey，应用于filter和values函数 limit_choices_to 同ForeignKey，但如果自己定义了如“Membership”之类的中间类，则不会起到作用 symmetrical 对于迭代定义的ManyToManyField，其为这一字段建立一个单独的属性，而是设定symmetrical属性为True，若期望使用此类迭代关系，可以手动设置其为False through 如上所示，用于设置中间项的名字，可以自己定义一个中间项，若不定义的话系统也会分配一个中间项 through_fields 通过元组来给出中间项关联的两个类名，可以查看上面的示例 db_table 可以通过这一属性来手动设定保存这一字段的数据表名称，若不设置则默认为字段的名称 db_contraint 是否在数据库中建立约束 swappable 设置是否指向一个可交换的模型

OneToOneField

源码中对OneToOneField的设置如下：

many_to_many = False
many_to_one = False
one_to_many = False
one_to_one = True

可知其是针对单对单的关系设定的字段。在概念上我们可以理解其为设置unique属性为True的一种类型，区别之处在于它“反向”的数值会返回一个目标值，这对于继承关系的表达十分有用，例如一下示例程序：

from django.conf import settings
from django.db import models

class MySpecialUser(models.Model):
 user = models.OneToOneField(
 settings.AUTH_USER_MODEL,
 on_delete=models.CASCADE,
 )
 supervisor = models.OneToOneField(
 settings.AUTH_USER_MODEL,
 on_delete=models.CASCADE,
 related_name='supervisor_of',
 )

OneToOneField既包含ForeignKey中的参数，又包含一个额外的参数parent_link，若定义了一个类，其继承了一个非抽象的类，而设置parent_link这个函数为True，则会将这个类视作继承的类的父类，而不是一个新的OneToOneField。

以上这篇基于Django OneToOneField和ForeignKey的区别详解就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持。

上一篇：Anconda环境下Vscode安装Python的方法详解
下一篇：配置python的编程环境之Anaconda + VSCode的教程