Is é “Bainisteoir” an comhéadan trína gcuirtear oibríochtaí fiosrúcháin bunachar sonraí ar fáil do mhúnlaí Django. Tá ``Bainisteoir ``amháin ar a laghad ann do gach samhail i bhfeidhmchlár Django.
\nDéantar an bealach a oibríonn ranganna Bainiste doiciméadaithe in:doc: /topics/db/queries; baineann an doiciméad seo go sonrach le roghanna samhlacha a shaincheapann iompar Bainiste.
De réir réamhshocraithe, cuireann Django Bainiste leis an ainm ruda le gach rang samhail Django. Mar sin féin, más mian leat ruda a úsáid mar ainm réimse, nó más mian leat ainm seachas ruda a úsáid don Bainiste`, is féidir leat é a athainmniú ar bhonn in aghaidh an mhúnla. Chun an Bainiste a athainmniú do rang ar leith, sainmhínigh tréith aicme de chineál ``Models.manager () ``ar an tsamhail sin. Mar shampla:
from django.db import models\n\n\nclass Person(models.Model):\n # ...\n people = models.Manager()\nAg baint úsáide as an tsamhail samplach seo, ginfidh Person.Objects eisceacht AttributeError, ach soláthróidh Person.People.all () ``liosta de na rudaí ``Person go léir.
Is féidir leat Bainisteoir ``saincheaptha a úsáid i samhail áirithe tríd an rang bonn ``Bainiste a leathnú agus do Bainisteoir` saincheaptha a chur i do mhúnla.
Tá dhá chúis ann b'fhéidir gur mhaith leat Bainiste a shaincheapadh: modhanna Bainiste breise a chur leis, agus/nó an QuerySet` tosaigh Bainiste a mhodhnú.
Is é modhanna breise Bainiste a chur leis an mbealach is fearr chun feidhmiúlacht “leibhéal tábla” a chur le do mhúnlaí. (Maidir le feidhmiúlacht “leibhéal sraithe” - ie, feidhmeanna a ghníomhaíonn ar shampla amháin de réad samhail - bain úsáid as: ref: Modhanna samhlacha `, <model-methods>ní modhanna saincheaptha ``Bainiste`.)
Mar shampla, cuireann an Bainisteoir ``saincheaptha seo modh ``with_counts ():
from django.db import models\nfrom django.db.models.functions import Coalesce\n\n\nclass PollManager(models.Manager):\n def with_counts(self):\n return self.annotate(num_responses=Coalesce(models.Count("response"), 0))\n\n\nclass OpinionPoll(models.Model):\n question = models.CharField(max_length=200)\n objects = PollManager()\n\n\nclass Response(models.Model):\n poll = models.ForeignKey(OpinionPoll, on_delete=models.CASCADE)\n # ...\nLeis an sampla seo, úsáidfeá OpinionPoll.Objects.with_Counts () ``chun `QuerySet` de rudaí ``OpinionPoll a fháil leis an tréith breise num_responses ceangailte.
Is féidir le modh saincheaptha Bainiste aon rud a theastaíonn uait a thabhairt ar ais. Ní gá dó ``QuerySet ``a thabhairt ar ais.
Rud eile le tabhairt faoi deara ná gur féidir le modhanna Bainiste rochtain a fháil ar ``self.model ``chun an rang samhail lena bhfuil siad ceangailte a fháil.
Tugann bonn Bainiste QuerySet` gach rud sa chóras ar ais. Mar shampla, ag baint úsáide as an tsamhail seo:
from django.db import models\n\n\nclass Book(models.Model):\n title = models.CharField(max_length=100)\n author = models.CharField(max_length=50)\n... cuirfidh an ráiteas ``Book.Objects.all () ``gach leabhar sa bhunachar sonraí ar ais.
\nIs féidir leat bonn `Manager QuerySet` a shárú tríd an modh Manager.get_querySet () ``a shárú. Ba chóir go gcuirfeadh ``get_queryset () ``QuerySet` a thabhairt ar ais leis na hairíonna a theastaíonn uait.
Mar shampla, tá dha ``Bainisteoir ``s sa tsamhail seo a leanas - ceann a thugann gach rud ar ais, agus ceann nach dtugann ach na leabhair le Roald Dahl ar ais:
\n# First, define the Manager subclass.\nclass DahlBookManager(models.Manager):\n def get_queryset(self):\n return super().get_queryset().filter(author="Roald Dahl")\n\n\n# Then hook it into the Book model explicitly.\nclass Book(models.Model):\n title = models.CharField(max_length=100)\n author = models.CharField(max_length=50)\n\n objects = models.Manager() # The default manager.\n dahl_objects = DahlBookManager() # The Dahl-specific manager.\nLeis an tsamhail samplach seo, ní thabharfaidh Book.Objects.all () ``gach leabhar sa bhunachar sonraí ar ais, ach ní thabharfaidh `Book.dahl_objects.all ()` ach na cinn a scríobh Roald Dahl ar ais.
\nToisc go bhfilleann get_queryset () ``réad ``QuerySet, is féidir leat filter () ``,, () a úsáid agus na modhanna ``QuerySet eile air. Mar sin tá na ráitis seo go léir dlíthiúil:
Book.dahl_objects.all()\nBook.dahl_objects.filter(title="Matilda")\nBook.dahl_objects.count()\nChuir an sampla seo in iúl teicníc spéisiúil eile freisin: bainisteoirí iolracha a úsáid ar an tsamhail chéanna. Is féidir leat an oiread cásanna ``Bainisteoir () ``a cheangal le samhail agus is mian leat. Is bealach neamh-athchleachtach é seo chun “scagairí” coitianta do do mhúnlaí a shainiú.
\nMar shampla:
\nclass AuthorManager(models.Manager):\n def get_queryset(self):\n return super().get_queryset().filter(role="A")\n\n\nclass EditorManager(models.Manager):\n def get_queryset(self):\n return super().get_queryset().filter(role="E")\n\n\nclass Person(models.Model):\n first_name = models.CharField(max_length=50)\n last_name = models.CharField(max_length=50)\n role = models.CharField(max_length=1, choices={"A": _("Author"), "E": _("Editor")})\n people = models.Manager()\n authors = AuthorManager()\n editors = EditorManager()\nLigeann an sampla seo duit Person.Authors.all () ``, `Person.Editors.all (), agus ``Person.People.all () ``a iarraidh, ag tabhairt torthaí intuartha.
Má úsáideann tú rudaí saincheaptha Bainiste, tabhair faoi deara go bhfuil stádas speisialta ag an gcéad Bainisteoir ``Django (san ord ina sainmhínítear iad sa tsamhail). Léirmhíníonn Django an chéad ``Bainiste a shainmhínítear i rang mar an “réamhshocraithe” Bainiste, agus úsáidfidh roinnt codanna de Django (lena n-áirítear: djadmin: dumpdata) an `Bainisteoir ``sin go heisiach don tsamhail sin. Mar thoradh air sin, is smaoineamh maith é a bheith cúramach i do rogha bainisteora réamhshocraithe d'fhonn cás a sheachaint ina mbíonn neamhábaltacht rudaí ar mhaith leat oibriú leo mar thoradh ar 'get_queryset ()' a shárú.
<django.db.models.Options.default_manager_name>Is féidir leat bainisteoir réamhshocraithe saincheaptha a shonrú ag baint úsáidea:attr: `meta.default_manager_name `.
\nMá tá cód éigin á scríobh agat a chaithfidh samhail anaithnid a láimhseáil, mar shampla, in aip tríú páirtí a chuireann dearcadh cineálach i bhfeidhm, bain úsáid as an mbainisteoir seo (nó: attr: ~Model. _base_manager) seachas glacadh leis go bhfuil bainisteoir ruda ag an tsamhail.
Úsáidtear an bainisteoir seo chun rochtain a fháil ar rudaí a bhaineann leo ó mhúnla éigin eile. Sna cásanna sin, caithfidh Django a bheith in ann na rudaí go léir don tsamhail atá á fháil aige a fheiceáil, ionas gur féidir aon ruda a dtagraítear dó a aisghabháil.
\nDá bhrí sin, níor cheart duit ``get_queryset () ``a shárú chun aon sraitheanna a scagadh amach. Má dhéanann tú amhlaidh, cuirfidh Django torthaí neamhiomlán ar ais.
\nCé go bhfuil an chuid is mó de na modhanna ón gcaighdeán QuerySet` inrochtana go díreach ón ``Bainiste, is amhlaidh amháin maidir leis na modhanna breise atá sainmhínithe ar QuerySet saincheaptha má chuireann tú i bhfeidhm iad ar an Bainiste freisin:
class PersonQuerySet(models.QuerySet):\n def authors(self):\n return self.filter(role="A")\n\n def editors(self):\n return self.filter(role="E")\n\n\nclass PersonManager(models.Manager):\n def get_queryset(self):\n return PersonQuerySet(self.model, using=self._db)\n\n def authors(self):\n return self.get_queryset().authors()\n\n def editors(self):\n return self.get_queryset().editors()\n\n\nclass Person(models.Model):\n first_name = models.CharField(max_length=50)\n last_name = models.CharField(max_length=50)\n role = models.CharField(max_length=1, choices={"A": _("Author"), "E": _("Editor")})\n people = PersonManager()\nLigeann an sampla seo duit glaoch ar údair () ``agus `eagarthóirí () araon ón mbainisteoir Person.People.
<django.db.models.query.QuerySet.as_manager>In ionad an chur chuige thuas a éilíonn modhanna dúbailte ar an QuerySet agus an Bainiste` araon, is féidir :meth: QuerySet.as_Manager () `a úsáid chun sampla de `Bainisteoir ``a chruthú le cóip de mhodhanna saincheaptha ``QuerySet`:
class Person(models.Model):\n ...\n people = PersonQuerySet.as_manager()\n<django.db.models.query.QuerySet.as_manager>Beidh an t-áis Bainiste a chruthaí:meth: QuerySet.as_Manager () `beagnach comhionann leis an ``PersonManager` ón sampla roimhe seo.
<django.db.models.query.QuerySet.delete>Ní bhíonn ciall ar gach modh QuerySet` ag leibhéal ``Bainiste; mar shampla cuirimid cosc d'aon ghnó an modh:meth: QuerySet.delete () `ó chóipeáil chuig an rang ``Bainiste`.
Déantar modhanna a chóipeáil de réir na rialacha seo a leanas:
\nCóipeáltar modhanna poiblí de réir réamhshoc
Ní chóipeáiltear modhanna príobháideacha (ag tosú le béim) de réir réamhshocraithe.
Déantar modhanna a bhfuil tréith queryset_only socraithe go False cóipeáil i gcónaí.
Ní chóipeáiltear modhanna le tréith queryset_only atá socraithe go True riamh.
Mar shampla:
\nclass CustomQuerySet(models.QuerySet):\n # Available on both Manager and QuerySet.\n def public_method(self):\n return\n\n # Available only on QuerySet.\n def _private_method(self):\n return\n\n # Available only on QuerySet.\n def opted_out_public_method(self):\n return\n\n opted_out_public_method.queryset_only = True\n\n # Available on both Manager and QuerySet.\n def _opted_in_private_method(self):\n return\n\n _opted_in_private_method.queryset_only = False\nLe haghaidh ardúsáide b'fhéidir gur mhaith leat Bainiste saincheaptha agus QuerySet` saincheaptha araon. Is féidir leat é sin a dhéanamh trí ghlaoch ar `Manager.from_querySet () ``a thugann seach*fo-aicme* de do bhonn ``Bainiste le cóip de na modhanna saincheaptha QuerySet:
class CustomManager(models.Manager):\n def manager_only_method(self):\n return\n\n\nclass CustomQuerySet(models.QuerySet):\n def manager_and_queryset_method(self):\n return\n\n\nclass MyModel(models.Model):\n objects = CustomManager.from_queryset(CustomQuerySet)()\nFéadfaidh tú an rang a ghintear a stóráil in athróg freisin:
\nMyManager = CustomManager.from_queryset(CustomQuerySet)\n\n\nclass MyModel(models.Model):\n objects = MyManager()\n<model-inheritance>Seo mar a láimhseálann Django bainisteoirí saincheaptha agus:ref: `oidhreacht mhúnla `:
\nDéanann an rang leanaí oidhreacht bainisteoirí ó ranganna bonn i gcónaí, ag baint úsáide as gnáthordú réitigh ainmneacha Python (athraíonn ainmneacha ar an rang linbh gach duine eile; ansin tagann ainmneacha ar an gcéad rang tuismitheora, agus mar sin de).
Mura dhearbhaítear aon bhainisteoirí ar mhúnla agus/nó a thuismitheoirí, cruthaíonn Django an bainisteoir ``rudaí ``go huathoibríoch.
Is é an bainisteoir réamhshocraithe ar rang an ceann a roghnaíodh le:attr: meta.default_manager_name <django.db.models.Options.default_manager_name>, nó an chéad bhainisteoir a dhearbhaigh ar an tsamhail, nó bainisteoir réamhshocraithe an chéad mhúmhúnla tuismitheora.
Soláthraíonn na rialacha seo an tsolúbthacht riachtanach más mian leat bailiúchán bainisteoirí saincheaptha a shuiteáil ar ghrúpa samhlacha, trí rang bonn teibí, ach an bainisteoir réamhshocraithe a shaincheapadh fós. Mar shampla, cuir leis go bhfuil an bunaicme seo agat:
\nclass AbstractBase(models.Model):\n # ...\n objects = CustomManager()\n\n class Meta:\n abstract = True\nMá úsáideann tú é seo go díreach i rang leanaí, is é ``rudaí ``an bainisteoir réamhshocraithe mura ndearbhaíonn tú aon bhainisteoirí sa rang linbh:
\nclass ChildA(AbstractBase):\n # ...\n # This class has CustomManager as the default manager.\n pass\nMás mian leat oidhreacht a dhéanamh ó AbstractBase `, ach bainisteoir réamhshocraithe difriúil a sholáthar, is féidir leat an bainisteoir réamhshocraithe a sholáthar ar rang an linbh:
\nclass ChildB(AbstractBase):\n # ...\n # An explicit default manager.\n default_manager = OtherManager()\nAnseo, is é default_manager an réamhshocraithe. Tá an bainisteoir ruda ar fáil fós, ós rud é go bhfuil sé oidhreachta, ach ní úsáidtear é mar réamhshocraithe.
Faoi dheireadh don sampla seo, cuir i gcás gur mhaith leat bainisteoirí breise a chur le rang an linbh, ach bain úsáid as an réamhshocrú ó `AbstractBase ``fós. Ní féidir leat an bainisteoir nua a chur go díreach i rang an linbh, mar go ndéanfadh sé sin an réamhshocrú agus bheadh ort na bainisteoirí go léir ón rang bonn teibí a áireamh go sainráite freisin. Is é an réiteach ná na bainisteoirí breise a chur i mbunaicme eile agus iad a thabhairt isteach san ordlathas oidhreacht* tar éis * na réamhshocruithe:
\nclass ExtraManager(models.Model):\n extra_manager = OtherManager()\n\n class Meta:\n abstract = True\n\n\nclass ChildC(AbstractBase, ExtraManager):\n # ...\n # Default manager is CustomManager, but OtherManager is\n # also available via the "extra_manager" attribute.\n pass\nTabhair faoi deara cé gur féidir leat* bainisteoir saincheaptha a shainiú ar an tsamhail teibí, ní féidir leat* aon mhodhanna a úsáid ag baint úsáide as an tsamhail teibí. Is é sin:
\nClassA.objects.do_something()\ntá sé dlíthiúil, ach:
\nAbstractBase.objects.do_something()\nardóidh sé eisceacht. Tá sé seo toisc go bhfuil sé i gceist le bainisteoirí loighic a chumhdú chun bailiúcháin rudaí a bhainistiú. Ós rud é nach féidir leat bailiúchán rudaí teibí a bheith agat, níl sé ciall a bheith ag bainistiú iad. Má tá feidhmiúlacht agat a bhaineann leis an tsamhail teibí, ba cheart duit an fheidhmiúlacht sin a chur i “modh statach” nó i “modh ranga” ar an tsamhail teibí.
\nCibé gnéithe a chuireann tú le do “Bainisteoir” saincheaptha, caithfidh sé a bheith indéanta cóip éadrom a dhéanamh de shampla Bainiste; ie, caithfidh an cód seo a leanas oibriú:
>>> import copy\n>>> manager = MyManager()\n>>> my_copy = copy.copy(manager)\nDéanann Django cóipeanna éadmhara de rudaí bainisteora le linn fiosruithe áirithe; mura féidir do Bhainisteoir a chóipeáil, teipeann ar
\nNí cheist é seo don chuid is mó de na bainisteoirí saincheaptha. Mura bhfuil tú ach modhanna simplí ag cur le do Bainiste, ní dócha go ndéanfaidh tú cásanna de do Bainisteoir ``gan chóipeáil gan aon ghnó. Mar sin féin, má tá tú ag dul i bhfeidhm ar ``__getattr__` nó modh príobháideach éigin eile de do réad `Bainiste a rialaíonn staid réada, ba cheart duit a chinntiú nach ndéanann tú difear do chumas do ``Bainisteoir ``a chóipeáil.