= Jednoduchý model a práca s ním =

Django umožňuje pracovať s relačnou databázou pomocou objektovo-relačného
modelu. Robí to pomocou techniky menom ''objektovo-relačné mapovanie'' (ORM).
Z praktického hľadiska táto technika slúži na izolovanie programátora aplikácie
od databázového servra, Je možné začať vyvíjať aplikáciu lokálne pod sqlite a
v reálnom nasadení potom použiť povedzme Oracle, pričom jediná zmena je v {{{settings.py}}}.
Programátor sa nemusí zaoberať {{{SQL}}}, stačí mu vedieť python.

Nevýhoda tejto techniky je v tom, že neumožňuje účinne používať mnohé techniky určené
pre zvýšenie výkonnosti databázového servra (triggery a pod.). Primárnym účelom
djanga je vytvárať dynamické webové stránky, ale napríklad veľká aplikácia
ako napríklad http://is.stuba.sk vyžaduje trochu zložitejší návrh databázovej schémy,
než to umožňuje django.

== Vytvorenie modelu ==

Vytvorme si nový projekt s názvom {{{skola}}} a v ňom aplikáciu s názvom {{{ziacka}}}.

Ideme implementovať dátový model žiackej knižky naivným (a pre tento účel nesprávnym) spôsobom:
ako jednu veľkú tabuľku s mnohými stĺpcami. Nesmieme zabudnúť doplniť aplikáciu v {{{settings.py}}}.

V adresári ziacka máme súbor {{{models.py}}}, ktorý vyzerá takto:

{{attachment:models.py}}

Napíšme teraz
{{{
$ ./manage.py syncdb
}}}
a všimnime si, že vo výpise máme takýto riadok
{{{
Creating table ziacka_znamka
}}}
Pre zaujímavosť sa môžeme pozrieť, aké SQL príkazy boli použité na vytvorenie tabuľky.
{{{
$ ./manage.py sqlall ziacka
BEGIN;
CREATE TABLE "ziacka_znamka" (
    "id" integer NOT NULL PRIMARY KEY,
    "meno_ziaka" varchar(30) NOT NULL,
    "priezvisko_ziaka" varchar(30) NOT NULL,
    "meno_ucitela" varchar(30) NOT NULL,
    "priezvisko_ucitela" varchar(30) NOT NULL,
    "predmet" varchar(50) NOT NULL,
    "znamka" integer unsigned NOT NULL
)
;
COMMIT;
}}}

=== Všimnite si ===

 * Vzniklo niečo, čo sme explicitne nepožadovali, a to stĺpec {{{id}}}.
 * Názov tabuľky má ako prefix názov aplikácie. Preto nás nemusí trápiť, ak máme rovnako pomenované modely v dvoch rôznych aplikáciách.

=== Upozornenie ===

<<Pozor>>
'''Ak by sme sa rozhodli teraz triedu {{{Znamka}}} zmeniť, {{{./manage.py syncdb}}} už žiadne zmeny v databázovej tabuľke neurobí. Vie iba tabuľku vytvoriť, nie modifikovať. Z praktického hľadiska to znamená, že ak počas vývoja zmeníme model, musíme databázu vymazať.
Preto je dobrý nápad mať malý pythonovský skript, ktorý naplní databázu vzorkou dát, aby sme to nemuseli opakovane robiť ručne.

Takže pre znovuvytvorenie databázy potom už iba spustíme'''
{{{
$ ./manage.py shell < data_script.py
}}}
'''a hotovo.'''
<<Pohov>>
<<Pozor>>
'''Do {{{models.py}}} môžeme pridať kedykoľvek novú triedu, vtedy mazať databázu nemusíme.'''
<<Pohov>>

== Základná práca s modelom ==

=== Zapisovanie dát ===

Najprv si dáme náš model do globálneho namespace.

{{{#!python
$ ./manage.py shell
Python 2.5.2 (r252:60911, Jan  4 2009, 17:40:26)
[GCC 4.3.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from skola.ziacka.models import *
>>>
}}}

Vytvoríme si inštanciu modelu, t.j. riadok tabuľky:
{{{#!python
>>> z=Znamka(meno_ziaka="Jan",
... priezvisko_ziaka="Prvy",
... meno_ucitela="Ivan",
... priezvisko_ucitela="Hrozny",
... predmet="Matematika"
... , znamka=3
... )
>>> print z
Znamka object
>>>
}}}
Objekt {{{z}}} ešte nie je uložený v databáze. Aby sme ho uložili, musíme urobiť toto:
{{{#!python
>>> z.save()
>>> 
}}}

Analogicky pridáme do databázy ešte zo dve známky. Potom môžeme ukončiť pythonovský
shell cez {{{CTRL-D}}}.

=== Čítanie dát ===

{{{#!python
$ ./manage.py shell
Python 2.5.2 (r252:60911, Jan  4 2009, 17:40:26)
[GCC 4.3.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from skola.ziacka.models import *
>>>
}}}

Skúsme si vypísať teraz všetky známky:
{{{#!python
>>> Znamka.objects.all()
[<Znamka: Znamka object>, <Znamka: Znamka object>, <Znamka: Znamka object>]
>>> 
}}}

To nie je veľmi informatívne, ak chceme vypisovať známky trochu lepšie, dodajme
do triedy Znamka metódu {{{__unicode__}}}:
{{{#!python
class Znamka(models.Model):

    # meno a priezvisko ziaka
    meno_ziaka=models.CharField(max_length=30)
    priezvisko_ziaka=models.CharField(max_length=30)
    # meno a priezvisko ucitela
    meno_ucitela=models.CharField(max_length=30)
    priezvisko_ucitela=models.CharField(max_length=30)
    # predmet, z ktoreho bola znamka udelena
    predmet=models.CharField(max_length=50)
    # znamka
    znamka=models.PositiveIntegerField()
    
    def __unicode__(self):
        return u"%s : %d z %s" % (self.meno_ziaka,self.znamka,self.predmet)
}}}

Všimnite si, že vraciame unicode reťazec.

Aby kódovanie unicode reťazca fungovalo korektne, musíme špecifikovať v akom kódovaní
pracujeme. Prvý riadok nášho modulu preto bude
{{{#!python
# -*- coding: UTF-8 -*-
}}}

Pozn. ak robíme v B206 resp. vo Windows, bude tam {{{iso-8859-2}}} resp. {{{cp-1250}}}.

Skúsme znovu:

{{{#!python
$ ./manage.py shell
Python 2.5.2 (r252:60911, Jan  4 2009, 17:40:26)
[GCC 4.3.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(InteractiveConsole)
>>> from skola.ziacka.models import *
>>> znamky=Znamka.objects.all()
>>> print znamky
[<Znamka: Jan : 3 z Matematika>, <Znamka: Jozef : 1 z Anglicky jazyk>, <Znamka: Anna : 1 z Telesna vychova>]
>>>                            
}}}

Teraz Janovi zmeníme známku na objektívnejšiu:
{{{#!python
>>> zn_jano=znamky[0]
>>> print zn_jano
Jan : 3 z Matematika
>>> zn_jano.znamka=2
>>> zn_jano.save()
}}}

A môžeme si znovu známky vypísať:
{{{#!python
>>> print znamky
[<Znamka: Jan : 2 z Matematika>, <Znamka: Jozef : 1 z Anglicky jazyk>, <Znamka: Anna : 1 z Telesna vychova>]
>>>  
}}}

Janovi sme zmenili známku na dvojku.

=== Filtrovanie dát ===

Začnime skúmaním djangovských typov, ktoré nám umožňujú horeuvedené hry.

Prvých dvoch hráčov poznáme, sú to 
 * modely, t.j. podtriedy {{{django.db.models.Model}}} a
 * inštancie modelov.

To ale nie je všetko:
{{{#!python
>>> type(Znamka.objects)
<class 'django.db.models.manager.Manager'>
>>> type(Znamka.objects.all())
<class 'django.db.models.query.QuerySet'>
}}}

{{{Manager}}} má v podstate za úlohu prekladať pythonovské
volania na SQL. V tejto chvíli je pre nás dôležité to, že z neho môžeme vymámiť pomocou
rôznych metód objekt typu {{{QuerySet}}}.

Každý {{{QuerySet}}} je iterovateľný a indexovateľný.

V tejto chvíli vás už odkážem na dokumentáciu, dodám už len pár sedení.

=== Filtrovanie so špecifikáciou atribútov ===

V princípe nám nič nebráni vziať {{{Znamka.objects.all()}}} a začať
cez neho iterovať normálne pomocou {{{for}}} a vyberať si pre ďalšie spracovanie
tie objekty, ktoré potrebujeme. 

Databázový server/knižnica to ale urobí rýchlejšie a spoľahlivejšie.

{{{#!python
>>> Znamka.objects.filter(meno_ziaka="Anna")
[<Znamka: Anna : 1 z Telesna vychova>]
>>> Znamka.objects.filter(meno_ziaka="Anna",priezvisko_ziaka="Nevyhnutna")
[<Znamka: Anna : 1 z Telesna vychova>]
>>> Znamka.objects.filter(priezvisko_ziaka="Nevyhnutna")
[<Znamka: Anna : 1 z Telesna vychova>]
}}}

Môže sa vrátiť prázdny zoznam:
{{{#!python
>>> Znamka.objects.filter(meno_ziaka="Anna",priezvisko_ziaka="Neexistujuca")
[]
>>>
}}}

Alebo zoznam viacerých známok:
{{{#!python
>>> Znamka.objects.filter(znamka=1)
[<Znamka: Jozef : 1 z Anglicky jazyk>, <Znamka: Anna : 1 z Telesna vychova>]
>>> 
}}}

Duálom k {{{filter}}} je {{{exclude}}}:
{{{#!python
>>> Znamka.objects.exclude(znamka=1)
[<Znamka: Jan : 2 z Matematika>]
}}}

==== Zložitejšie filtre ====

Rafinovaným spôsobom sa využívajú pomenované argumenty.

{{{#!python
>>> Znamka.objects.filter(predmet__contains="jazyk")
[<Znamka: Jozef : 1 z Anglicky jazyk>]
>>> Znamka.objects.filter(predmet__startswith="Telesna")
[<Znamka: Anna : 1 z Telesna vychova>]
>>>
}}}

Nikto nemá lepšiu známku ako 1 a je len jedna horšia známka
ako 1.
{{{#!python
>>> Znamka.objects.filter(znamka__lt=1)
[]
>>> Znamka.objects.filter(znamka__gt=1)
[<Znamka: Jan : 2 z Matematika>]
>>>
}}}

Ide aj vyberať podľa abecedného poradia:
{{{#!python
>>> Znamka.objects.filter(meno_ziaka__lte="Jan")
[<Znamka: Jan : 2 z Matematika>, <Znamka: Anna : 1 z Telesna vychova>]
>>>
}}}

=== Zreťazovanie filtrov ===

{{{QuerySet}}} sa dá ďalej filtrovať.

{{{#!python
>>> Znamka.objects.filter(meno_ziaka__lte="Jan").exclude(znamka=1)
[<Znamka: Jan : 2 z Matematika>]
>>>
}}}