模型类参考 — Django 文档

模型类参考

本文档涵盖了 Model 类的功能。 有关模型的更多信息，请参阅 模型参考指南的完整列表 。

属性

DoesNotExist

exception Model.DoesNotExist

当未找到预期对象时，ORM 会引发此异常。 例如， QuerySet.get() 将在给定查找找不到对象时引发它。

Django 提供了一个 DoesNotExist 异常作为每个模型类的一个属性来标识找不到的对象的类，允许您捕获特定模型类的异常。 例外是 django.core.exceptions.ObjectDoesNotExist 的子类。

MultipleObjectsReturned

exception Model.MultipleObjectsReturned

当为给定查找找到多个对象时，此异常由 QuerySet.get() 引发。

Django 提供了一个 MultipleObjectsReturned 异常作为每个模型类的属性来标识找到多个对象的对象的类，允许您捕获特定模型类的异常。 例外是 django.core.exceptions.MultipleObjectsReturned 的子类。

objects

Model.objects

每个非抽象 Model 类都必须添加一个 Manager 实例。 Django 确保在您的模型类中至少指定了一个默认的 Manager。 如果您不添加自己的 Manager，Django 将添加一个属性 objects，其中包含默认的 Manager 实例。 如果添加自己的Manager实例属性，则不会出现默认的。 考虑以下示例：

from django.db import models

class Person(models.Model):
    # Add manager with another name
    people = models.Manager()

有关模型管理器的更多详细信息，请参阅 Managers 和 Retrieving objects。