Toisc gur forbraíodh Django i dtimpeallacht seomra nuachta luas tapa, ceapadh é chun tascanna forbartha gréasáin coitianta a dhéanamh go tapa agus éasca. Seo forbhreathnú neamhfhoirmiúil ar conas aip gréasáin bunaithe ar bhunachar sonraí a scríobh le Django.
\nIs é sprioc an doiciméid seo go leor sonraí teicniúla a thabhairt duit chun tuiscint a fháil ar an gcaoi a n-oibríonn Django, ach níl sé i gceist gur teagasc nó tagairt a bheadh ann -- ach tá an dá cheann againn! Nuair atá tú réidh le tionscadal a thosú, is féidir leat tosú leis an rang teagaisc nó :doc: tumadh díreach isteach i gcáipéisíocht níos mionsonraithe </topics/index>.
\nCé gur féidir leat Django a úsáid gan bunachar sonraí, tagann sé le object-relational mapper ina ndéanann tú cur síos ar leagan amach do bhunachar sonraí i gcód Python.
\nThe data-model syntax offers many rich ways of\nrepresenting your models -- so far, it's been solving many years' worth of\ndatabase-schema problems. Here's a quick example:
\nnews/models.pyfrom django.db import models\n\n\nclass Reporter(models.Model):\n full_name = models.CharField(max_length=70)\n\n def __str__(self):\n return self.full_name\n\n\nclass Article(models.Model):\n pub_date = models.DateField()\n headline = models.CharField(max_length=200)\n content = models.TextField()\n reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)\n\n def __str__(self):\n return self.headline\nAnsin, reáchtáil na fóntais ordú-líne Django a chruthú ar na táblaí bunachar sonraí go huathoibríoch:
\nLinux / macOS
$ python manage.py makemigrations\n$ python manage.py migrate\nWindows
...\\> py manage.py makemigrations\n...\\> py manage.py migrate\nBreathnaíonn an t-ordú :d jadmin: makemigrations ar do chuid samhlacha go léir atá ar fáil agus cruthaíonn sé imirce do cibé táblaí nach bhfuil ann cheana féin. :d JADMIN: Ritheann 'imirce' na himirce agus cruthaíonn sé táblaí i do bhunachar sonraí, chomh maith le :d OC: `Rialú scéimre i bhfad níos saibhre </topics/migrations>Migrations a sholáthar go roghnach `.
\nLeis sin, tá tú saor in aisce, agus saibhir, :d oc:Python API </topics/db/queries> chun rochtain a fháil ar do shonraí. Cruthaítear an API ar an eitilt, gan aon ghiniúint cód riachtanach:
\n# Import the models we created from our "news" app\n>>> from news.models import Article, Reporter\n\n# No reporters are in the system yet.\n>>> Reporter.objects.all()\n<QuerySet []>\n\n# Create a new Reporter.\n>>> r = Reporter(full_name="John Smith")\n\n# Save the object into the database. You have to call save() explicitly.\n>>> r.save()\n\n# Now it has an ID.\n>>> r.id\n1\n\n# Now the new reporter is in the database.\n>>> Reporter.objects.all()\n<QuerySet [<Reporter: John Smith>]>\n\n# Fields are represented as attributes on the Python object.\n>>> r.full_name\n'John Smith'\n\n# Django provides a rich database lookup API.\n>>> Reporter.objects.get(id=1)\n<Reporter: John Smith>\n>>> Reporter.objects.get(full_name__startswith="John")\n<Reporter: John Smith>\n>>> Reporter.objects.get(full_name__contains="mith")\n<Reporter: John Smith>\n>>> Reporter.objects.get(id=2)\nTraceback (most recent call last):\n ...\nDoesNotExist: Reporter matching query does not exist.\n\n# Create an article.\n>>> from datetime import date\n>>> a = Article(\n... pub_date=date.today(), headline="Django is cool", content="Yeah.", reporter=r\n... )\n>>> a.save()\n\n# Now the article is in the database.\n>>> Article.objects.all()\n<QuerySet [<Article: Django is cool>]>\n\n# Article objects get API access to related Reporter objects.\n>>> r = a.reporter\n>>> r.full_name\n'John Smith'\n\n# And vice versa: Reporter objects get API access to Article objects.\n>>> r.article_set.all()\n<QuerySet [<Article: Django is cool>]>\n\n# The API follows relationships as far as you need, performing efficient\n# JOINs for you behind the scenes.\n# This finds all articles by a reporter whose name starts with "John".\n>>> Article.objects.filter(reporter__full_name__startswith="John")\n<QuerySet [<Article: Django is cool>]>\n\n# Change an object by altering its attributes and calling save().\n>>> r.full_name = "Billy Goat"\n>>> r.save()\n\n# Delete an object with delete().\n>>> r.delete()\nNuair a shainmhínítear do mhúnlaí, is féidir le Django a chruthú go huathoibríoch gairmiúil, táirgeadh réidh :d oc: comhéadan riaracháin </ref/contrib/admin/index> - suíomh gréasáin a ligeann d'úsáideoirí fíordheimhnithe rudaí a chur leis, a athrú agus a scriosadh. Is é an t-aon chéim atá ag teastáil ná do mhúnla a chlárú ar an suíomh riaracháin:
\nnews/models.pyfrom django.db import models\n\n\nclass Article(models.Model):\n pub_date = models.DateField()\n headline = models.CharField(max_length=200)\n content = models.TextField()\n reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)\nnews/admin.pyfrom django.contrib import admin\n\nfrom . import models\n\nadmin.site.register(models.Article)\nIs é an fhealsúnacht anseo go bhfuil do shuíomh curtha in eagar ag foireann, nó cliant, nó b'fhéidir díreach tú - agus níl tú ag iarraidh déileáil le comhéadain inneall a chruthú ach amháin chun ábhar a bhainistiú.
\nSreabhadh oibre tipiciúil amháin chun apps Django a chruthú ná samhlacha a chruthú agus na suíomhanna riaracháin a chur ar bun chomh tapa agus is féidir, ionas gur féidir le d'fhoireann (nó do chliaint) tús a chur le sonraí daonra. Ansin, forbairt a dhéanamh ar an mbealach a chuirtear sonraí i láthair an phobail.
\nIs mionsonra tábhachtach é scéim URL glan galánta i bhfeidhmchlár gréasáin ardchaighdeáin. Spreagann Django dearadh URL álainn agus ní chuireann sé aon chrústa in URLanna, cosúil le .php nó .asp.
Chun URLanna a dhearadh le haghaidh aip, cruthaíonn tú modúl Python ar a dtugtar URLconf. Clár ábhar do d’aip, tá mapáil ann idir patrúin URL agus feidhmeanna aisghlaoite Python. Freastalaíonn URLconfs freisin chun URLanna a dhíchúpláil ó chód Python.
\nSeo an chuma a bheadh ar URLconf don sampla Tuairisceoir/Airteagal thuas:
news/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("articles/<int:year>/", views.year_archive),\n path("articles/<int:year>/<int:month>/", views.month_archive),\n path("articles/<int:year>/<int:month>/<int:pk>/", views.article_detail),\n]\nLéarscáilíonn an cód thuas cosáin URL chuig feidhmeanna aisghlao Python ("amhairc"). Úsáideann teaghráin na gcosán clibeanna paraiméadar chun luachanna a "ghabháil" ó na URLanna. Nuair a iarrann úsáideoir leathanach, ritheann Django trí gach cosán, in ord, agus stopann sé ag an gcéad cheann a mheaitseálann an URL iarrtha. (Mura n-oireann aon cheann acu, glaonn Django radharc cás speisialta 404.) Tá sé seo blazingly tapa, toisc go bhfuil na cosáin le chéile i nathanna rialta ag am ualach.
\nNuair a mheaitseálann ceann de na patrúin URL, glaonn Django ar an radharc a thugtar, arb é feidhm Python é. Rachaidh gach radharc ar aghaidh réad iarratais -- ina bhfuil meiteashonraí iarratais -- agus na luachanna a gabhadh sa phatrún.
\nMar shampla, dá n-iarrfadh úsáideoir an URL "/articles/2005/05/39323/", thabharfadh Django an fheidhm news.views.article_detail(iarratas, year=2005, month=5, pk=39323).
Tá gach amharc freagrach as ceann amháin de dhá rud a dhéanamh: Ag filleadh ar rud Http404. Fútsa atá an chuid eile.
Go ginearálta, aisghabhann radharc sonraí de réir na bparaiméadar, lódálann sé teimpléad agus cuireann sé an teimpléad leis na sonraí a aisghabháil. Seo radharc samplach do year_archive thuas:
news/views.pyfrom django.shortcuts import render\n\nfrom .models import Article\n\n\ndef year_archive(request, year):\n a_list = Article.objects.filter(pub_date__year=year)\n context = {"year": year, "article_list": a_list}\n return render(request, "news/year_archive.html", context)\nÚsáideann an sampla seo córas teimpléid Django, a bhfuil roinnt gnéithe cumhachtacha aige ach a dhéanann iarracht fanacht simplí go leor le húsáid gan ríomhchláraitheoirí.
\nLuchtaíonn an cód thuas an teimpléad news/year_archive.html.
Tá cosán cuardaigh teimpléad ag Django, a ligeann duit iomarcaíocht a íoslaghdú i measc teimpléid. I do shocruithe Django, sonraíonn tú liosta eolairí le seiceáil le haghaidh teimpléid le:setting:'DIRS<TEMPLATES-DIRS>'. Mura bhfuil teimpléad ann sa chéad eolaire, seiceálann sé an dara ceann, agus mar sin de.
\nAbraimis gur aimsíodh an teimpléad news/year_archive.html. Seo an chuma a d'fhéadfadh a bheith air sin:
news/templates/news/year_archive.html{% extends "base.html" %}\n\n{% block title %}Articles for {{ year }}{% endblock %}\n\n{% block content %}\n<h1>Articles for {{ year }}</h1>\n\n{% for article in article_list %}\n <p>{{ article.headline }}</p>\n <p>By {{ article.reporter.full_name }}</p>\n <p>Published {{ article.pub_date|date:"F j, Y" }}</p>\n{% endfor %}\n{% endblock %}\nTá athróga timpeallaithe ag braces dúbailte-curly. Ciallaíonn {{ article.headline }} "Aschur luach phríomhthréith an ailt." Ach ní úsáidtear poncanna ach amháin le haghaidh lookup tréith. Is féidir leo cuardach foclóra-eochair, cuardach innéacs agus glaonna feidhme a dhéanamh freisin.
Nóta {{ article.pub_date|date:"F j, Y" }} úsáideann "píopa" stíl Unix (an carachtar "|"). Tugtar scagaire teimpléid air seo, agus is bealach é chun luach athróg a scagadh. Sa chás seo, formáidí an scagaire dáta réad datetime Python san fhormáid a thugtar (mar atá le fáil i bhfeidhm dáta PHP).
Is féidir leat an oiread scagairí agus is mian leat a shlabhra le chéile. Is féidir leat scríobh: ref: 'custom template <howto-writing-custom-template-filters>filters'. Is féidir leat scríobh :d oc: 'custom template tags </howto/custom-template-tags>', a ritheann cód saincheaptha Python taobh thiar de na radhairc.
\nAr deireadh, úsáideann Django coincheap "oidhreacht teimpléid". Sin a dhéanann an {% extends "base.html" %} . Ciallaíonn sé "An chéad luchtú an teimpléad ar a dtugtar 'bonn', a bhfuil sainithe a bunch de bloic, agus líon na bloic leis na bloic seo a leanas." I mbeagán focal, ligeann sé sin duit gearradh síos go mór ar iomarcaíocht i dteimpléid: ní mór do gach teimpléad ach an méid atá uathúil don teimpléad sin a shainiú.
Seo an méid a d'fhéadfadh an teimpléad "base.html", lena n-áirítear úsáid a bhaint as :d oc: 'comhaid statacha < / howto / static-files / index>, cuma mhaith:
\ntemplates/base.html{% load static %}\n<html lang="en">\n<head>\n <title>{% block title %}{% endblock %}</title>\n</head>\n<body>\n <img src="{% static 'images/sitelogo.png' %}" alt="Logo">\n {% block content %}{% endblock %}\n</body>\n</html>\nGo simplí, sainmhíníonn sé cuma agus mothú an tsuímh (le lógó an tsuímh), agus soláthraíonn sé "poill" le haghaidh teimpléid leanaí a líonadh. Ciallaíonn sé seo gur féidir athdhearadh láithreáin a dhéanamh trí chomhad amháin a athrú - an teimpléad bonn.
\nLigeann sé duit leaganacha éagsúla de shuíomh a chruthú freisin, le teimpléid bhunúsacha éagsúla, agus teimpléid leanaí á n-athúsáid. D'úsáid cruthaitheoirí Django an teicníc seo chun leaganacha soghluaiste éagsúla de shuíomhanna a chruthú trí theimpléad bonn nua a chruthú.
\nNote that you don't have to use Django's template system if you prefer another\nsystem. While Django's template system is particularly well-integrated with\nDjango's model layer, nothing forces you to use it. For that matter, you don't\nhave to use Django's database API, either. You can use another database\nabstraction layer, you can read XML files, you can read files off disk, or\nanything you want. Each piece of Django -- models, views, templates -- is\ndecoupled from the next.
\nNí raibh anseo ach forbhreathnú tapa ar fheidhmiúlacht Django. Roinnt gnéithe níos úsáidí:
\nA :d oc:caching framework </topics/cache> a chomhtháthaíonn le memcached nó le cúil eile.
A :d oc:syndication framework </ref/contrib/syndication> a ligeann duit fothaí RSS agus Adamh a chruthú trí rang beag Python a scríobh.
Gnéithe riaracháin níos tarraingtí a ghintear go huathoibríoch - is ar éigean a scríob an forbhreathnú seo an dromchla.
Is iad na chéad chéimeanna eile ná íoslódáil Django, léigh :d oc:the tutorial </intro/tutorial01> agus páirt a ghlacadh i the community. Go raibh maith agat as do spéis!
\n