Sebuah manager adalah antarmuka melalui mana tindakan permintaan basisdata disediakan pada model Django. Setidaknya satu Manager ada untuk setiap model dalam sebuah apliaksi Django.
Cara kelas-kelas Manager bekerja didokumentasikan dalam Membuat query; dokumen ini secara khusus menyentuh pada pilihan model yang menyesuaikan perilaku Manager.
Secara awalan, Django menambah sebuah Manager dengan nama objects pada setiap kelas model Django. Bagaimanapun, jika anda ingin menggunakan objects sebagai sebuah nama bidang, atau jika anda ingin menggunakan sebuah nama selain dari objects untuk Manager, anda dapat menamai kembali itu pada berdasarkan per-model. Untuk menamai kembali Manager untuk kelas diberikan, tentukan sebuah atribut kelas dari jenis models.Manager() pada model itu. Sebagai contoh:
from django.db import models\n\n\nclass Person(models.Model):\n # ...\n people = models.Manager()\nMenggunakan model contoh ini, Person.objects akanmembangkitkan sebuah pengecualian AttributeError, tetapi Person.people.all() akan menyediakan daftar dari semua obyek Person.
Anda dapat menggunakan sebuah penyesuaian Manager dalam model tertentu dengan memperpanjang kelas Manager dasar dan menginstansiasi penyesuaian Manager anda dalam model anda.
Ada dua alasan anda mungkin ingin menyesuaikan sebuah Manager: untuk menambah metode Manager tambahan, dan/atau merubah QuerySet awal kembalian Manager.
Menambahkan metode Manager tambahan adalah cara disukai untuk menambah fungsionalitas "table-level" pada model anda. (Untuk fungsionalitas "row-level" -- yaitu yang bertindak pada sebuah instance tunggal dari sebuah obyek model -- gunakan Model methods, bukan penyesuaian metode Manager.)
Sebagai contoh,``Manager`` penyesuaian ini menambahkan sebuah metode 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 # ...\nWith this example, you'd use OpinionPoll.objects.with_counts() to get a\nQuerySet of OpinionPoll objects with the extra num_responses\nattribute attached.
Sebuah metode Manager penyesuaian dapat mengembalikan apapun anda inginkan. Itu tidak harus mengembalikan sebuah QuerySet.
Another thing to note is that Manager methods can access self.model to\nget the model class to which they're attached.
QuerySet awal pengelolaanLink to this heading#Dasar Manager QuerySet mengembalikan semua obyek-obyek di sistem. Sebagai contoh, menggunakan model ini:
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...pernyataan Book.objects.all() akan mengembalikan semua buku-buku di basisdata.
Anda dapat menimpa QuerySet dasar Manager dengan menimpa metode Manager.get_queryset(). get_queryset() harus mengembalikan sebuah QuerySet dengan sifat-sifat anda butuhkan.
Sebagai contoh, model berikut mempunyai dua Manager -- satu yang mengembalikan semua obyek, dan satu yang mengembalikan hanya buku-buku oleh Roald Dahl:
# 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.\nDengan model contoh ini, Book.objects.all() akan mengembalikan semua buku-buku di basisdata, tetapi Book.dahl_objects.all() akan hanya mengembalikan satu yang ditulis oleh Roald Dahl.
Because get_queryset() returns a QuerySet object, you can use\nfilter(), exclude() and all the other QuerySet methods on it. So\nthese statements are all legal:
Book.dahl_objects.all()\nBook.dahl_objects.filter(title="Matilda")\nBook.dahl_objects.count()\nThis example also pointed out another interesting technique: using multiple\nmanagers on the same model. You can attach as many Manager() instances to\na model as you'd like. This is a non-repetitive way to define common "filters"\nfor your models.
Sebagai contoh:
\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()\nContoh ini mengizinkan anda meminta Person.authors.all()`, Person.editors.all(), dan Person.people.all(), menghasilkan hasil dapat diramalkan.
Jika anda menggunakan obyek Manager penyesuaian, ambil catatan bahwa Manager Django pertama hadapi (dalam urutan dimana mereka ditentukan dalam model) mempunyai sebuah keadaan khusus. Django menafsirkan Manager pertama ditentukan dalam sebuah kelas sebagai Manager "default", dan beberapa bagian dari Django (termasuk dumpdata) akan menggunakan yang Manager khusus untuk model itu. Sebagai sebuah hasil, itu adalah ide bagus untuk hati-hati dalam pilihan anda dari pengelola awalan untuk menghindari keadan dimana menimpa hasil get_queryset() dalam sebuah ketidakmampuan mengambil obyek-obyek anda sukai bekerja dengannya.
Anda dapat menentukan sebuah penyesuaian pengelolaan awalan menggunakan Meta.default_manager_name.
Jika anda sedang menulis beberapa kode yang harus menangani sebuah model tidak dikenal, sebagai contoh, dalam sebuah aplikasi pihak-ketiga yang menerapkan sebuah tampilan umum, gunakan pengelola ini (atau _base_manager) daripada beranggapan model mempunyai sebuah pengelola objects.
Pengelola ini digunakan untuk mengakses obyek yang terkait pada dari beberapa model lain. Dalam keadaan tersebut, Django harus dapat melihat semua obyek untuk model itu sedang diambil, sehingga apapun yang mengacu dapat diambil.
\nTherefore, you should not override get_queryset() to filter out any rows.\nIf you do so, Django will return incomplete results.
QuerySet penyesuaian dari pengelolaLink to this heading#Selagi kebanyakan metode dari QuerySet standar dapat diakses langsung dari Manager, ini hanya kasus untuk metode tambahan ditentukan pada sebuah penyesuaian QuerySet jika anda juga menerapkan mereka pada Manager:
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()\nContoh ini mengizinkan anda memanggil kedua authors() dan editors() secara langsung dari pengelola Person.people.
QuerySetLink to this heading#Sebagai pengganti dari pendekatan diatas yang membutuhkan metode penggandaan pada kedua QuerySet dan Manager, QuerySet.as_manager() dapat digunakan untuk membuat sebuah instance dari Manager dengan salinan dari sebuah metode QuerySet penyesuaian:
class Person(models.Model):\n ...\n people = PersonQuerySet.as_manager()\nInstance Manager dibuat oleh QuerySet.as_manager() akan secara virtual mirip pada PersonManager dari contoh sebelumnya.
Tidak setiap metode QuerySet masuk akal pada tingkat Manager; sebagai contoh kami sengaja mencegah metode QuerySet.delete() dari menjadi disalin ke atas kelas Manager.
Cara disalin berdasarkan aturan berikut:
\nCara umum disalin secara awal.
Metode pribadi (mulai dengan sebuah garis bawah) tidak disalin secara awalan.
Metode dengan atribut queryset_only disetel menjadi False adalah selalu disalin.
Metode dengan atribut queryset_only disetel menjadi True adalah tidak pernah disalin.
Sebagai contoh:
\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\nfrom_queryset()Link to this heading#Untuk penggunaan lanjutan anda mungkin ingin kedua penyesuaian Manager dan penyesuaian QuerySet. Anda dapat melakukan itu dengan memanggil Manager.from_queryset() yang mengembalikan sebuah subkelas dari dasar Manager anda dengan salinan dari metode QuerySet penyesuaian:
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)()\nAnda mungkin juga menyimpan kelas dibangkitkan kedalam sebuah variabel:
\nMyManager = CustomManager.from_queryset(CustomQuerySet)\n\n\nclass MyModel(models.Model):\n objects = MyManager()\nIni adalah bagaimana Django menangani pengelolaan penyesuaian dan model inheritance:
\nPengelola dari kelas-kelas dasar selalu diwarisi oleh anak kelas, menggunakan urutan resolusi nama biasa Python (nama pada kelas anan menimpa semua lainnya; kemudian datang nama pada kelas induk pertama, dan seterusnya).
Jika tidak ada pengelola dinyatakan pada model dan/atau induknya, Django secara otomatis membuat pengelola objects.
Pengelola awalan pada sebuah kelas adalah antara satu dipilih dengan Meta.default_manager_name, atau pengelola pertama dinyatakan pada model, atau pengelola awalan dari model induk pertama.
Aturan-aturan ini menyediakan keluwesan yang dibutuhkan jika anda ingin memasang sebuah kumpulan dari penyesuaian pengelola pada sekelompok model, melalui sebuah kelas dasar, tetapi masih menyesuaikan pengelola awalan. Sebagai contoh, misalkan anda mempunyai kelas dasar ini:
\nclass AbstractBase(models.Model):\n # ...\n objects = CustomManager()\n\n class Meta:\n abstract = True\nIf you use this directly in a child class, objects will be the default\nmanager if you declare no managers in the child class:
class ChildA(AbstractBase):\n # ...\n # This class has CustomManager as the default manager.\n pass\nJika anda ingin mewarisi dari AbstractBase, tetapi menyediakan pengelola awalan berbeda, anda dapat menyediakan pengelola awalan pada kelas anak:
class ChildB(AbstractBase):\n # ...\n # An explicit default manager.\n default_manager = OtherManager()\nHere, default_manager is the default. The objects manager is\nstill available, since it's inherited, but isn't used as the default.
Akhirnya untuk contoh ini, misalkan anda ingin menambah pengelola tambahan pada kelas anak, tetapi masih menggunakan awalan dari AbstractBase. Anda tidak dapat menambah pengelola baru langsung dalam kelas anak, seperti itu akan menimpa awalan dan anda akan juga jelas menyertakan semua pengelola dari kelas dasar abstrak. Pemecahannya adalah menaruh pengelola tambahan dalam kelas dasar lain dan memperkenalkan itu kedalam hirarki warisan setelah awalan:
class 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\nCatat bahwa selagi anda dapat menentukan pengelolaan penyesuaian pada model abstrak, anda tidak dapat meminta metode apapun menggunakan model abstrak. Yaitu:
\nClassA.objects.do_something()\nlegal, tetapi:
\nAbstractBase.objects.do_something()\nakan memunculkan sebuah pengecualian. Ini karena pengelola bermaksud untuk mengenkapsulasi logika untuk mengelola kumpulan dari obyek. Sejak anda tidak dapat mempunyai sebuah kumpulan dari obyek-obyek abstrak, itu tidak masuk akal untuk mengelola mereka. Jika anda mempunyai fungsionalitas yang berlaku pada model abstrak, anda harus menaruh fungsionalitas itu dalam sebuah staticmethod atau classmethod pada model abstrak.
Whatever features you add to your custom Manager, it must be\npossible to make a shallow copy of a Manager instance; i.e., the\nfollowing code must work:
>>> import copy\n>>> manager = MyManager()\n>>> my_copy = copy.copy(manager)\nDjango membuat salinan dangkal dari obyek-obyek pengelola selama permintaan tertentu; jika Manager anda tidak dapat disalin, permintaan itu akan gagal.
\nIni tidak akan menjadi sebuah masalah untuk kebanyakan pengelola penyesuaian. Jika anda hanya menambahkan metode sederhana ke Manager anda, itu tidak mungkin bahwa anda akan secara tidak sengaja membuat instance-instance dari tidak dapat disalin Manager anda. Bagaimanapun, jika anda menimpa __getattr__ atau beberapa metode pribadi lain dari obyek Manager anda yang mengendalikan keadaan obyek, anda harus memastikan bahwa anda tidak mempengaruhi kemampuan dari Manager anda untuk disalin.