mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-02-22 07:24:59 +00:00
Code Issues 32 Releases Wiki Activity

Fixed #19222 -- Documented that default managers aren't used for related queries.

Browse Source
This commit is contained in:
Tim Graham 2016-08-16 13:12:55 -04:00 committed by GitHub
parent c969b17ad8
commit 8fb53c50ce
1 changed files with 7 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/topics/db/managers.txt
View File

@ -204,7 +204,7 @@ Using managers for related object access
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
By default, Django uses an instance of the ``Model._base_manager`` manager By default, Django uses an instance of the ``Model._base_manager`` manager
class when accessing related objects (i.e. ``choice.poll``), not the class when accessing related objects (i.e. ``choice.question``), not the
``_default_manager`` on the related object. This is because Django needs to be ``_default_manager`` on the related object. This is because Django needs to be
able to retrieve the related object, even if it would otherwise be filtered out able to retrieve the related object, even if it would otherwise be filtered out
(and hence be inaccessible) by the default manager. (and hence be inaccessible) by the default manager.
@ -214,6 +214,12 @@ appropriate for your circumstances, you can tell Django which class to use by
setting :attr:`Meta.base_manager_name setting :attr:`Meta.base_manager_name
<django.db.models.Options.base_manager_name>`. <django.db.models.Options.base_manager_name>`.
Manager's aren't used when querying on related models. For example, if the
``Question`` model :ref:`from the tutorial <creating-models>` had a ``deleted``
field and a base manager that filters out instances with ``deleted=True``, a
queryset like ``Choice.objects.filter(question__name__startswith='What')``
would include choices related to deleted questions.
Don't filter away any results in this type of manager subclass Don't filter away any results in this type of manager subclass
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~