README.md

Django ORM a QuerySety

V tejto kapitole sa naučíš, ako sa Django pripája k databáze a ukladá do nej údaje. Poďme na to!

Čo je QuerySet?

QuerySet je zoznam objektov daného modelu. QuerySet ti umožňuje čítať dáta z databázy, filtrovať a zoraďovať ich.

Najjednoduchšie bude ukázať si to na príklade. Vyskúšajme si to.

Django shell (konzola)

Otvor si lokálnu konzolu (nie na PythonAnywhere) a napíš tento príkaz:

{% filename %}command-line{% endfilename %}

(myvenv) ~/djangogirls$ python manage.py shell

Toto by sa ti malo zobraziť:

{% filename %}command-line{% endfilename %}

(InteractiveConsole)
>>>

Nachádzaš sa v interaktívnej Django konzole. Je to ako konzola Pythonu, ale s trochou Django mágie :). Môžeš v nej samozrejme použiť všetky Pythonovské príkazy.

Všetky objekty

Skúsme najskôr zobraziť všetky naše príspevky. To sa robí nasledovným príkazom:

{% filename %}command-line{% endfilename %}

>>> Post.objects.all()
Traceback (most recent call last):
      File "<console>", line 1, in <module>
NameError: name 'Post' is not defined

Ups! Objavila sa chybová hláška! Hovorí nám, že nič také ako Post (príspevok) neexistuje. To je správne - zabudli sme ho totiž najskôr naimportovať!

{% filename %}command-line{% endfilename %}

>>> from blog.models import Post

Naimportujeme model Post z blog.models. Skúsme teda znova zobraziť všetky príspevky:

{% filename %}command-line{% endfilename %}

>>> Post.objects.all()
<QuerySet [<Post: my post title>, <Post: another post title>]>

Je to zoznam príspevkov, ktoré sme už predtým vytvorili! Vytvorili sme ich pomocou Django administrátorského rozhrania. No radi by sme vytvorili nové príspevky pomocou Pythonu, tak ako na to?

Vytvorenie objektu

Takto vytvoríš nový Post objekt v databáze:

{% filename %}command-line{% endfilename %}

>>> Post.objects.create(author=me, title='Sample title', text='Test')

Chýba nám však jedna prísada: me. Ako autorku musíme vložiť inštanciu User modelu. Ako to urobiť?

Najskôr naimportujme User model:

{% filename %}command-line{% endfilename %}

>>> from django.contrib.auth.models import User

Akých užívateľov máme v našej databáze? Skús toto:

{% filename %}command-line{% endfilename %}

>>> User.objects.all()
<QuerySet [<User: ola>]>

To je superuser, ktorého sme už vytvorili predtým. Teraz získajme inštanciu tohto užívateľa:

{% filename %}command-line{% endfilename %}

>>> me = User.objects.get(username='ola')

Ako vidíš, teraz získame (angl. get) užívateľa (angl. User) s užívateľským meno (angl. username), ktoré sa rovná 'ola'. Aké elegantné! Samozrejme musíš si to zmeniť tak aby tam bolo tvoje meno.

Teraz už konečne môžeme vytvoriť náš prvý príspevok:

{% filename %}command-line{% endfilename %}

>>> Post.objects.create(author=me, title='Sample title', text='Test')

Hurá! Chceš si overiť, či to fungovalo?

{% filename %}command-line{% endfilename %}

>>> Post.objects.all()
<QuerySet [<Post: my post title>, <Post: another post title>, <Post: Sample title>]>

Je to tam, jeden príspevok v zozname pribudol!

Pridaj viac príspevkov

Teraz sa môžeš trochu pobaviť a pridať pár ďalších príspevkov, aby si si vyskúšala ako to funguje. Pridaj dva-tri ďalšie príspevky a potom poďme na ďalšiu časť.

Filtrovanie objektov

Dôležitou vlastnosťou QuerySetov je možnosť ich filtrovať. Povedzme, že chceme nájsť všetky príspevky, ktorých autorom je užívateľ (User) ola. Použijeme filter namiesto all v príkaze Post.objects.all(). V zátvorkách definujeme jednu alebo viac podmienok, ktoré majú byť splnené príspevkom, aby skončil v tvojom querysete. V našom prípade je to author, ktorý sa rovná me. V Djangu to napíšeš takto: author=me. Náš kúsok kódu bude teraz vyzerať takto:

{% filename %}command-line{% endfilename %}

>>> Post.objects.filter(author=ja)
[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]

Skúsme vyhľadať všetky príspevky, ktoré obsahujú slovo 'title' v políčku title?

{% filename %}command-line{% endfilename %}

>>> Post.objects.filter(title__contains='title')
[<Post: Sample title>, <Post: 4th title of post>]

Poznámka Medzi title a contains sú dva podčiarkovníky (_). Django ORM používa túto syntax, aby oddelil názvy polí ("title") a operácie či filtre ("contains"). Ak použiješ iba jeden podčiarkovník, dostaneš chybu "FieldError: Cannot resolve keyword title_contains".

Môžeš tiež získať zoznam všetkých publikovaných postov. To urobíme vyfiltrovaním príspevkov, ktoré majú nastavený published_date v minulosti:

{% filename %}command-line{% endfilename %}

>>> from django.utils import timezone
>>> Post.objects.filter(published_date__lte=timezone.now())
[]

Bohužiaľ, príspevok, ktorý sme pridali z konzoly Pythonu, ešte nie je publikovaný. To môžeme zmeniť! Najskôr získaj inštanciu postu, ktorý chceme publikovať:

{% filename %}command-line{% endfilename %}

>>> post = Post.objects.get(title="Sample title")

A potom ho zverejni pomocou našej metódy publish:

{% filename %}command-line{% endfilename %}

>>> post.publish()

Teraz skús získať zoznam publikovaných postov znova (stlač šípku hore trikrát a stlač enter):

{% filename %}command-line{% endfilename %}

>>> Post.objects.filter(published_date__lte=timezone.now())
[<Post: Sample title>]

Zoradenie objektov

QuerySety tiež umožňujú zoradiť zoznamy objektov. Skúsme ich zoradiť podľa dátumu vytvorenia (pole created_date):

{% filename %}command-line{% endfilename %}

>>> Post.objects.order_by('created_date')
[<Post: Sample title>, <Post: Post number 2>, <Post: My 3rd post!>, <Post: 4th title of post>]

Poradie môžeme vymeniť pridaním - na začiatok:

{% filename %}command-line{% endfilename %}

>>> Post.objects.order_by('-created_date')
[<Post: 4th title of post>,  <Post: My 3rd post!>, <Post: Post number 2>, <Post: Sample title>]

Reťazenie QuerySetov

QuerySety môžeš dokonca kombinovať pomocou reťazenia:

>>> Post.objects.filter(published_date__lte=timezone.now()).order_by('published_date')

To je skutočne silný nástroj, ktorým môžeš písať pomerne komplexné požiadavky (queries).

Super! Teraz si pripravená na ďalšiu časť! Shell zatvoríš príkazom:

{% filename %}command-line{% endfilename %}

>>> exit()
$