Is féidir le feidhmchláir gréasáin a scríobh a bheith aontónach, toisc go ndéanaimid patrúin áirithe a athdhéanamh Déanann Django iarracht cuid den aonfhoirmeacht sin a thógáil ar shiúl ag na sraitheanna samhail agus teimpléad, ach bíonn forbróirí gréasáin ag an leamh seo ag an leibhéal radhairc freisin.
\nForbraíodh tuairimí cineálacha Django chun an pian sin a mhaolú. Tógann siad nathanna agus patrúin choitianta áirithe a fhaightear i bhforbairt amharc agus déanann siad teibí orthu ionas gur féidir leat tuairimí coitianta ar shonraí a scríobh go tapa gan an iomarca cód a
\nIs féidir linn tascanna coitianta áirithe a aithint, cosúil le liosta rudaí a thaispeáint, agus cód a scríobh a thaispeánann liosta de*aon réad*. Ansin is féidir an tsamhail atá i gceist a chur ar aghaidh mar argóint bhreise chuig an URLConf.
\nSeolann Django le tuairimí cineálacha chun na nithe seo a leanas a dhéanamh:
\nTaispeáin liosta agus leathanaigh mionsonraithe le haghaidh réad amháin. Dá mbeimid ag cruthú feidhmchlár chun comhdhálacha a bhainistiú ansin bheadh TalkListView agus RegisteredUserListView ina samplaí de thuairimí liosta. Is sampla é leathanach cainte amháin den rud a thugaimid ar radharc “mionsonraí”.
Cuir rudaí dáta-bhunaithe i láthair i leathanaigh cartlainne blian/mí/lá, mionsonraí gaolmhara, agus leathanaigh “is déanaí”.
Lig d'úsáideoirí rudaí a chruthú, a nuashonrú agus a scriosadh - le húdarú nó gan údarú.
Le chéile, soláthraíonn na tuairimí seo comhéadain chun na tascanna is coitianta a thagann forbróirí a dhéanamh
\nNíl aon cheist ann gur féidir le tuairimí cineálacha a úsáid a bhrostú go suntasach. I bhformhór na dtionscadail, áfach, tagann nóiméad nuair nach leor na tuairimí cineálacha a thuilleadh. Go deimhin, is í an cheist is coitianta a chuireann forbróirí nua Django ná conas tuairimí cineálacha a láimhseáil le raon níos leithne cásanna.
\nSeo ceann de na cúiseanna a athdhearadh tuairimí cineálacha don scaoileadh 1.3 - roimhe seo, bhí feidhmeanna amharc acu le sraith roghanna mealltach; anois, seachas cuid mhór cumraíochta a chur isteach sa URLConf, is é an bealach molta chun tuairimí cineálacha a leathnú ná iad a fho-aicmiú, agus a gcuid tréithe nó modhanna a shárú.
\nÉ sin ráite, beidh teorainn ag tuairimí cineálacha. Má aimsíonn tú go bhfuil tú ag streachailt do dhearcadh a chur i bhfeidhm mar fho-aicme de radharc cineálach, ansin b'fhéidir go mbeidh sé níos éifeachtaí duit ach an cód a theastaíonn uait a scríobh, ag baint úsáide as do thuairimí rang-bhunaithe nó feidhmiúla féin.
\nTá níos mó samplaí de thuairimí cineálacha ar fáil i roinnt feidhmchlár tríú páirtí, nó d'fhéadfá do chuid féin a scríobh de réir mar is gá.
\nTemplateView certainly is useful, but\nDjango's generic views really shine when it comes to presenting views of your\ndatabase content. Because it's such a common task, Django comes with a handful\nof built-in generic views to help generate list and detail views of objects.
Tosaímid trí fhéachaint ar roinnt samplaí de liosta rudaí nó réad aonair a thaispeáint.
\nBeidh muid ag baint úsáide as na samhlacha seo:
\n# models.py\nfrom django.db import models\n\n\nclass Publisher(models.Model):\n name = models.CharField(max_length=30)\n address = models.CharField(max_length=50)\n city = models.CharField(max_length=60)\n state_province = models.CharField(max_length=30)\n country = models.CharField(max_length=50)\n website = models.URLField()\n\n class Meta:\n ordering = ["-name"]\n\n def __str__(self):\n return self.name\n\n\nclass Author(models.Model):\n salutation = models.CharField(max_length=10)\n name = models.CharField(max_length=200)\n email = models.EmailField()\n headshot = models.ImageField(upload_to="author_headshots")\n\n def __str__(self):\n return self.name\n\n\nclass Book(models.Model):\n title = models.CharField(max_length=100)\n authors = models.ManyToManyField("Author")\n publisher = models.ForeignKey(Publisher, on_delete=models.CASCADE)\n publication_date = models.DateField()\nAnois ní mór dúinn dearcadh a shainiú:
\n# views.py\nfrom django.views.generic import ListView\nfrom books.models import Publisher\n\n\nclass PublisherListView(ListView):\n model = Publisher\nAr deireadh, cuir an radharc sin isteach i do urls:
\n# urls.py\nfrom django.urls import path\nfrom books.views import PublisherListView\n\nurlpatterns = [\n path("publishers/", PublisherListView.as_view()),\n]\nSin an cód Python go léir a chaithfimid a scríobh. Ní mór dúinn teimpléad a scríobh fós, áfach. D'fhéadfaimis a insint go sainráite don radharc cén teimpléad atá le húsáid trí thréith template_name a chur leis an radharc, ach in éagmais teimpléad follasach tabharfaidh Django amach ceann ó ainm an réada. Sa chás seo, is é ” books/publisher_list.html “ an teimpléad intuartha - tagann an chuid “leabhair” ó ainm an aip a shainmhíníonn an tsamhail, agus is é an giotán “foilsitheora” an leagan íseal d'ainm an tsamhail.
Déanfar an teimpléad seo a léiriú i gcoinne comhthéacs ina bhfuil athróg ar a dtugtar object_list` ina bhfuil na rudaí foilsitheora go léir. D'fhéadfadh cuma seo a bheith ar theimpléad:
\n{% extends "base.html" %}\n\n{% block content %}\n <h2>Publishers</h2>\n <ul>\n {% for publisher in object_list %}\n <li>{{ publisher.name }}</li>\n {% endfor %}\n </ul>\n{% endblock %}\nSin go léir atá ann i ndáiríre. Tagann gnéithe fionnuar uile na tuairimí cineálacha ó na tréithe atá leagtha amach ar an radharc cineálach a athrú. Déan:doc: tagairt tuairimí cineálacha '</ref/class-based-views/index> doiciméadaíonn na tuairimí cineálacha go léir agus a roghanna go mion; breithneoidh an chuid eile den doiciméad seo cuid de na bealaí coitianta a d'fhéadfá tuairimí cineálacha a shaincheapadh agus a leathnú.
\nB'fhéidir gur thug tú faoi deara go stórálann ár dteimpléad liosta foilsitheoirí samplach na foilsitheoirí go léir in athróg darb ainm object_list`. Cé go n-oibríonn sé seo go breá, níl sé chomh “cairdiúil” sin d'údair teimpléid: caithfidh siad “a fhios” a bheith acu go bhfuil siad ag déileáil le foilsitheoirí anseo.
\nBhuel, má tá tú ag déileáil le réad samhail, déantar é seo duit cheana féin. Nuair a bhíonn tú ag déileáil le réad nó tacar fiosrúcháin, tá Django in ann an comhthéacs a líonadh ag baint úsáide as an leagan íseal d'ainm an ranga samhail. Cuirtear é seo ar fáil i dteannta leis an iontráil réamhshocraithe object_list, ach tá na sonraí céanna go díreach ann, ie publisher_list.
Mura meaitseáil mhaith é seo fós, is féidir leat ainm an athróg comhthéacs a shocrú de láimh. Sonraíonn an tréith context_object_name ar amharc cineálach an t-athróg comhthéacs atá le húsáid:
# views.py\nfrom django.views.generic import ListView\nfrom books.models import Publisher\n\n\nclass PublisherListView(ListView):\n model = Publisher\n context_object_name = "my_favorite_publishers"\nIs smaoineamh maith i gcónaí é context_object_name úsáideach a sholáthar. Gabhfaidh do chomhoibrithe a dhearann teimpléid buíochas leat.
Go minic ní mór duit roinnt faisnéise breise a chur i láthair seachas an rud a sholáthraíonn an dearcadh cineálach. Mar shampla, smaoinigh ar liosta de na leabhair go léir a thaispeáint ar leathanach mionsonraí gach foilsitheora. Soláthraíonn amharc cineálach: Class: ~django.views.generic.detail.detailView don fhoilsitheoir don chomhthéacs, ach conas a gheobhaidh muid faisnéis bhreise sa teimpléad sin?
\nIs é an freagra ar subclass:class: ~django.views.generic.detail.detailView agus cuir do chur i bhfeidhm féin ar an modh ``get_context_data ``a sholáthar. Cuireann an cur i bhfeidhm réamhshocraithe an réad atá á thaispeáint leis an teimpléad, ach is féidir leat é a shárú chun níos mó a sheoladh:
\nfrom django.views.generic import DetailView\nfrom books.models import Book, Publisher\n\n\nclass PublisherDetailView(DetailView):\n model = Publisher\n\n def get_context_data(self, **kwargs):\n # Call the base implementation first to get a context\n context = super().get_context_data(**kwargs)\n # Add in a QuerySet of all the books\n context["book_list"] = Book.objects.all()\n return context\nAnois déanaimis breathnú níos dlúithe ar an argóint samhail ``a bhí á úsáid againn ar fad. Tá an argóint ``samhail ``, a shonraíonn an tsamhail bunachar sonraí ar a oibreoidh an dearcadh air, ar fáil ar na tuairimí cineálacha go léir a oibríonn ar réad amháin nó ar bhailiúchán rudaí. Mar sin féin, ní hé an argóint ``samhail ``an t-aon bhealach chun na rudaí a oibreoidh an dearcadh orthu a shonrú - is féidir leat liosta na rudaí a shonrú ag baint úsáide as an argóint ``Queryset:
from django.views.generic import DetailView\nfrom books.models import Publisher\n\n\nclass PublisherDetailView(DetailView):\n context_object_name = "publisher"\n queryset = Publisher.objects.all()\nIs gearrthéacs é model = Foilsitheoir ``a shonrú chun ``queryset = Publisher.Objects.all () a rá. Mar sin féin, trí úsáid a bhaint as queryset chun liosta scagtha rudaí a shainiú is féidir leat a bheith níos sainiúla faoi na rudaí a bheidh le feiceáil sa radharc (féach: Doc: /topics/db/queries le haghaidh tuilleadh faisnéise fao:class: ~django.db.models.queryset rudaí, agus féach an tagair:doc: rang-bhunaithe tuairim le haghaidh na </ref/class-based-views/index> sonraí iomlána).
Chun sampla a roghnú, b'fhéidir gur mhaith linn liosta leabhair a ordú de réir dáta foilsithe, agus an chéad cheann is déanaí:
\nfrom django.views.generic import ListView\nfrom books.models import Book\n\n\nclass BookListView(ListView):\n queryset = Book.objects.order_by("-publication_date")\n context_object_name = "book_list"\nIs sampla beag go leor é sin, ach léiríonn sé an smaoineamh go deas. De ghnáth beidh tú ag iarraidh níos mó a dhéanamh ná rudaí a athordú amháin. Más mian leat liosta leabhair ag foilsitheoir áirithe a chur i láthair, is féidir leat an teicníc chéanna a úsáid:
\nfrom django.views.generic import ListView\nfrom books.models import Book\n\n\nclass AcmeBookListView(ListView):\n context_object_name = "book_list"\n queryset = Book.objects.filter(publisher__name="ACME Publishing")\n template_name = "books/acme_list.html"\nTabhair faoi deara go bhfuilimid ag úsáid ainm teimpléad saincheaptha in éineacht le ``queryset ``scagtha. Mura ndéanfaimis, úsáidfeadh an dearcadh cineálach an teimpléad céanna leis an liosta réada “vanilla”, rud b'fhéidir nach é an rud a theastaíonn uainn.
\nTabhair faoi deara freisin nach bealach an-galánta é seo chun leabhair a bhaineann go sonrach don fhoilsitheoir a dhéanamh. Más mian linn leathanach foilsitheora eile a chur leis, bheadh dornán línte eile ag teastáil uainn sa URLConf, agus bheadh níos mó ná cúpla foilsitheoir míréasúnach. Déileálfaimid leis an bhfadhb seo sa chéad chuid eile.
\n\nAnother common need is to filter down the objects given in a list page by some\nkey in the URL. Earlier we hardcoded the publisher's name in the URLconf, but\nwhat if we wanted to write a view that displayed all the books by some\narbitrary publisher?
\nGo háirithe, tá a: meth: ~django.views.generic.list.multipleObjectMixin.get_querySet modh is féidir linn a shárú. De réir réamhshocraithe, filleann sé luach an tréith ``queryset ``, ach is féidir linn é a úsáid chun níos mó loighic a chur leis.
\nIs é an phríomhchuid chun an obair seo a dhéanamh ná go stóráiltear rudaí úsáideacha éagsúla ar féin nuair a thugtar tuairimí rang-bhunaithe; chomh maith leis an iarratas (self.request`) san áireamh seo argóintí seasmhacha (self.args`) agus ainmbunaithe (self.kwargs`) a ghabhadh de réir an URLConf.
\nAnseo, tá URLConf againn le grúpa gabhadh amháin:
\n# urls.py\nfrom django.urls import path\nfrom books.views import PublisherBookListView\n\nurlpatterns = [\n path("books/<publisher>/", PublisherBookListView.as_view()),\n]\nAnsin, scríobhfaimid an radharc ``PublisherBookListView ``féin:
\n# views.py\nfrom django.shortcuts import get_object_or_404\nfrom django.views.generic import ListView\nfrom books.models import Book, Publisher\n\n\nclass PublisherBookListView(ListView):\n template_name = "books/books_by_publisher.html"\n\n def get_queryset(self):\n self.publisher = get_object_or_404(Publisher, name=self.kwargs["publisher"])\n return Book.objects.filter(publisher=self.publisher)\nTá úsáid a bhaint as get_queryset chun loighic a chur leis an roghnú cueryset chomh áisiúil agus atá sé cumhachtach. Mar shampla, dá dteastaíonn uainn, d'fhéadfaimis self.request.user a úsáid chun scagadh ag baint úsáide as an úsáideoir reatha, nó loighic níos casta eile.
Is féidir linn an foilsitheoir a chur isteach sa chomhthéacs ag an am céanna, ionas gur féidir linn é a úsáid sa teimpléad:
\n# ...\n\n\ndef get_context_data(self, **kwargs):\n # Call the base implementation first to get a context\n context = super().get_context_data(**kwargs)\n # Add in the publisher\n context["publisher"] = self.publisher\n return context\nIs éard atá i gceist leis an bpatrún coitianta deireanach a bhreathnóimid air roinnt oibre breise a dhéanamh roimh nó tar éis glaoch ar an dear
\nSamhlaigh go raibh réimse las_accessed againn ar ár samhail ``Author ``a bhí á úsáid againn chun súil a choinneáil ar an uair dheireanach a d'fhéach duine ar bith ar an údar sin:
# models.py\nfrom django.db import models\n\n\nclass Author(models.Model):\n salutation = models.CharField(max_length=10)\n name = models.CharField(max_length=200)\n email = models.EmailField()\n headshot = models.ImageField(upload_to="author_headshots")\n last_accessed = models.DateTimeField()\nNí bheadh aon rud ar eolas ag an rang cineálach ``DetailView ``faoin réimse seo, ach arís d'fhéadfaimis dearcadh saincheaptha a scríobh chun an réimse sin a choinneáil nuashonraithe.
\nAr dtús, bheadh orainn giotán mionsonraithe údair a chur leis sa URLConf chun dearcadh saincheaptha a chur in iúl:
\nfrom django.urls import path\nfrom books.views import AuthorDetailView\n\nurlpatterns = [\n # ...\n path("authors/<int:pk>/", AuthorDetailView.as_view(), name="author-detail"),\n]\nAnsin scríobhfaimis ár dtuairim nua - is é get_object an modh a aisghabhann an réad - mar sin déanaimid é a shárú agus fillteann muid an glao:
from django.utils import timezone\nfrom django.views.generic import DetailView\nfrom books.models import Author\n\n\nclass AuthorDetailView(DetailView):\n queryset = Author.objects.all()\n\n def get_object(self):\n obj = super().get_object()\n # Record the last accessed date\n obj.last_accessed = timezone.now()\n obj.save()\n return obj\n