Django中related_name详解

本文详细解析了Django ORM中ForeignKey字段的related_name属性如何用于反向查询,通过实例展示了如何从一对多关系的主表查询子表信息。

related_name是ForeignKey外键桥梁,用来反向查询

我先定义两个模型,一个是作者,一个是作者出版的书籍,算是一对多的类型。

class Person(models.Model);

name = models.CharField(verbose_name='作者姓名', max_length=10)

age = models.IntegerField(verbose_name='作者年龄')

class Book(models.Model):

person = models.ForeignKey(Person, related_name='person_book')

title = models.CharField(verbose_name='书籍名称', max_length=10)

pubtime = models.DateField(verbose_name='出版时间')

如果我们要查询一个作者出版了哪些书籍的话,那我们要怎么做呢?

即通过一查询出多的那方面 :

先查询到作者的信息 person = Person.objects.fiter(你的条件)

返回一个person对象 接下来就查询person关联的所有书籍对象,

我们在前面讲过的使用基于对象的查询方式,

反向查询按照表名 book = person.book_set.all() django 默认每个主表的对象都有一个是外键的属性,

可以通过它来查询到所有属于主表的子表的信息。

这个属性的名称默认是以子表的名称小写加上_set()来表示,

默认返回的是一个querydict对象,你可以继续的根据情况来查询等操作。

在实际项目中,我们使用最多的还是related_name 如果你觉得上面的定义比较麻烦的话,

你也可以在定义主表的外键的时候,给这个外键定义好一个名称。要用related_name比如在Book表中:

person = models.ForeignKey(Person, related_name=‘person_books’)

那么实现上面的需求,

可以使用person.book_set.all() 也可以使用person.person_books.all()

### Django 外键字段详解 #### `ForeignKey` 参数解析 在 Django 的 ORM 中,`ForeignKey` 是用于表示数据库中外键关系的一个字段类型。以下是几个常用参数的具体作用: --- #### 1. `on_delete` 该参数指定了当关联对象被删除时的行为。这是自 Django 2.0 起强制要求的参数。 - **常见选项**: - `CASCADE`: 当关联的对象被删除时,也会自动删除当前对象[^3]。 ```python models.ForeignKey(User, on_delete=models.CASCADE) ``` - `PROTECT`: 防止删除关联对象,除非手动处理依赖项。 ```python models.ForeignKey(User, on_delete=models.PROTECT) ``` - `SET_NULL`: 将外键设置为 NULL(前提是允许为空)。 ```python models.ForeignKey(User, on_delete=models.SET_NULL, null=True) ``` - `SET_DEFAULT`: 设置默认值(需指定默认值)。 ```python models.ForeignKey(User, on_delete=models.SET_DEFAULT, default=1) ``` --- #### 2. `related_name` `related_name` 定义了从目标模型反向访问源模型时使用的名称。如果没有显式定义,则会使用 `<source_model>_set` 形式的默认名称。 - **用途**: - 提供更直观的命名方式来实现反向查询。 - 解决多个外键指向同一模型时可能产生的冲突问题[^1]。 - **示例**: 假设有如下模型结构: ```python class Author(models.Model): name = models.CharField(max_length=100) class Book(models.Model): title = models.CharField(max_length=100) author = models.ForeignKey(Author, related_name="books", on_delete=models.CASCADE) ``` 反向查询可以通过以下方式进行: ```python some_author.books.all() # 获取某个作者的所有书籍 ``` 如果未定义 `related_name`,则需要通过默认的 `_set` 方法访问: ```python some_author.book_set.all() ``` --- #### 3. `verbose_name` `verbose_name` 用于提供更具可读性的字段名描述,通常显示在管理后台或其他用户界面中。 - **示例**: ```python class Order(models.Model): customer = models.ForeignKey( User, verbose_name="客户", on_delete=models.CASCADE ) ``` 在 Django Admin 页面中,“customer” 字段会被标记为 “客户”。 --- #### 4. 组合场景分析 假设我们有一个博客系统,涉及以下几个模型: ```python class BlogPost(models.Model): title = models.CharField(max_length=255) content = models.TextField() class Comment(models.Model): post = models.ForeignKey(BlogPost, related_name="comments", on_delete=models.CASCADE) text = models.TextField() ``` 在这种情况下: - `Comment.post` 表示每条评论属于某篇博文; - 使用 `post.comments.all()` 即可通过 `related_name` 实现反向查询,获取某篇文章下的所有评论[^4]。 --- #### 特殊情况:多对多关系中的外键 虽然 `ManyToManyField` 不直接使用 `ForeignKey`,但在某些复杂场景下仍需注意其内部机制。例如,`through` 参数可以用来定义中间表,而 `related_name` 和 `related_query_name` 则分别控制反向查询和过滤器行为[^5]。 --- ### 总结 以上是对 Django 模型中 `ForeignKey` 主要参数的详细介绍。其中,`on_delete` 控制级联操作;`related_name` 支持灵活的反向查询;`verbose_name` 提升用户体验。合理配置这些参数能够显著优化代码逻辑并减少潜在错误。 ---
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值