Django ORM e i QuerySet
In questo capitolo imparerai come Django si collega al database e archivia i dati al suo interno. Tuffiamoci!
Cos'è un QuerySet?
Un QuerySet, in sostanza, è una lista di oggetti di un determinato Modello. Il QuerySet ti permette di leggere il dato dal database, filtrarlo e ordinarlo.
È più facile impararlo con un esempio. Proviamo, ti va?
La shell di Django
Apri la tua console locale (non su Heroku) e digita questo comando:
command-line
L'effetto dovrebbe essere come questo:
command-line
Ora ti trovi nella console interattiva di Django. È come il prompt di Python ma con un po' di magia di Django in più :). Qui puoi anche utilizzare tutti i comandi Python, ovviamente.
Tutti gli oggetti
Proviamo a rendere visibili tutti i nostri post prima. Puoi farlo con il seguente comando:
command-line
Ops! È comparso un errore. Ci dice che non c'è nessun Post. È corretto - ci siamo dimenticati di importarlo!
command-line
È semplice: importiamo il modello Post da blog.models. Proviamo a vedere di nuovo tutti i post:
command-line
È una lista di post che abbiamo creato prima! Abbiamo creato questi post usando l'interfaccia di amministrazione di Django. Comunque sia, ora vogliamo creare nuovi post usando Python, quindi come lo facciamo?
Creare oggetti
Così è come crea un nuovo oggetto Post nel database:
command-line
Ma manca un ingrediente qui: me. Dobbiamo passare un'istanza del modello User come un autore. Come si fa?
Importiamo il modello User prima:
command-line
Quali utenti abbiamo nel nostro database? Prova questo:
command-line
È il superuser che abbiamo creato prima! Ora prendiamo un'istanza di User:
command-line
Come puoi vedere, ora prendiamo (con get) un User con un username che è uguale a 'ola'. Ben fatto, devi cambiarlo con il tuo username.
Adesso possiamo finalmente creare il nostro post:
command-line
Evviva! Vuoi controllare se funziona?
command-line
Eccolo, un altro post nell'elenco!
Aggiungi altri post
Ora puoi divertirti un po' ed aggiungere altri post per vedere come funziona. Aggiungene altri 2 o 3 e vai alla prossima parte.
Filtrare gli oggetti
Uno dei vantaggi dei QuerySet consiste nell'abilità di filtrarli. Diciamo che vogliamo trovare tutti i post che hanno come autore l'utente 'ola'. Possiamo usare filter invece di all in Post.objects.all(). Tra parentesi dichiariamo le condizioni che un post deve soddisfare per finire nel nostro QuerySet. Nella nostra situazione è autore che è uguale a me. Il modo di scriverlo in Django è autore=me. Ora il nostro pezzo di codice ha questo aspetto:
command-line
O magari vogliamo vedere tutti i post che contengono la parola 'titolo' nel campo titolo?
command-line
ci sono due underscore (
_) tratitoloecontains. L'ORM di Django usa questa sintassi per separare i nomi dei campi ("titolo") ed operazioni o filtri ("contiene"). Se usi solo un carattere di sottolineatura, otterrai un errore come "FieldError: non è possibile risolvere la parola chiave title_contains".
Puoi anche ottenere una lista di tutti i post pubblicati. Lo facciamo filtrando tutti i post che hanno una published_date impostata in passato:
command-line
Purtroppo, il post che abbiamo aggiunto dalla console Python non è ancora pubblicato. Possiamo modificarlo! In primo luogo ottenere un'istanza di un post che vogliamo pubblicare:
command-line
Ora pubblicalo con il nostro metodo publish!
command-line
Ora cerca di ottenere di nuovo l'elenco dei post pubblicati (premere il pulsante di freccia in su 3 volte e premere invio):
command-line
Ordinare gli oggetti
I QuerySet ti permettono anche di ordinare le liste di oggetti. Proviamo a ordinarli in base al campo created_date:
command-line
Possiamo anche invertire l'ordine aggiungendo - all'inizio:
command-line
QuerySet di concatenamento
Puoi anche combinare QuerySet concatenandole insieme:
command-line
È davvero potente e ti permette di scrivere query piuttosto complesse.
Fantastico! Ora sei pronta per la prossima parte! Per chiudere la shell, digita questo:
command-line