Dal momento che Django è stato sviluppato in un ambiente di redazione veloce, è stato progettato per rendere i task più comuni dello sviluppo web veloci e semplici. Ecco un sommario informale di come scrivere una applicazione web database-driven usando Django.
\nIl fine di questo documento è fornirti abbastanza specifiche tecniche da comprendere come funziona Django ma non vuole essere un tutorial o un manuale – ma abbiamo entrambi! Quando sei pronto ad iniziare un progetto, puoi iniziare con il tutorial o esplorare la documentazione più dettagliata.
\nSeppure puoi usare Django senza un database, esso viene fornito di un “object-relational mapper’_ nel quale descrivi lo schema del tuo database in codice Python.
\nLa sintassi data-model offre molti ricchi modi di rappresentare i tuoi modelli – finora, ha risolto molti anni di problemi legati agli schemi dei database. Ecco un rapido esempio:
\nmysite/news/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\nPasso successivo, utilizza Django da linea di comando per creare le tabelle nel database automaticamente:
\nLinux / macOS
$ python manage.py makemigrations\n$ python manage.py migrate\nWindows
...\\> py manage.py makemigrations\n...\\> py manage.py migrate\nIl comando makemigrations scorre tutti i modelli disponibili e crea migrazioni per tutte le tabelle che ancora non esistono. migrate lancia tutte le migrazioni e crea le tabelle nel tuo database, fornendo allo stesso tempo come opzione un controllo dello schema molto più ricco.
With that, you’ve got a free, and rich, Python API\nto access your data. The API is created on the fly, no code generation\nnecessary:
\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()\nUna volta che i modelli sono definiti, Django può creare una automaticamente una interfaccia amministrativa professionale e production-ready – un sito web che permette agli utenti autenticati di aggiungere, cambiare e cancellare oggetti. L’unico step richiesto è quello di registrare il tuo modello nel sito di amministrazione:
\nmysite/news/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)\nmysite/news/admin.pyfrom django.contrib import admin\n\nfrom . import models\n\nadmin.site.register(models.Article)\nLa filosofia qui è che il tuo sito viene modificato da uno staff, un cliente o magari proprio da te – e tu non vuoi dover avere a che fare con la creazione dell’interfaccia di backend solo per gestire il contenuto.
\nUn classico modus operandi nella creazione delle app Django è creare i modelli e avere il pannello di amministratore online il prima possibile, in modo che lo staff o i clienti possano iniziare a inserire i dati. Dopo di che è possibile iniziare a sviluppare come presentare quei dati agli utenti.
\nUno schema di URL pulito ed elegante è un dettaglio importante in una applicazione web di qualità elevata. Django incoraggia un design delle URL gradevole e non aggiunge parti non necessarie come .php o .asp.
Per pianificare le URL di un app, crea un modulo Python chiamato a URLconf. Una tabella di contenuti della tua app, contiene una corrispondenza tra il pattern URL e le funzioni di callback Python. URLconfs è utile anche per disaccoppiare le URL dal codice Python.
\nEcco come dovrebbe essere un URLconf per l’esempio precedente Reporter/Article:
mysite/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]\nIl codice qui sopra mappa i percorsi URL a funzioni Python («views»). Le stringhe dei percorsi usano dei segnaposto per «catturare» valori dagli URL. Quando un utente visita una pagina, Django scorre tutti i percorsi, nell’ordine in cui sono definiti, e si ferma al primo che corrisponde al percorso richiesto. (Se nessuno di essi corrisponde, Django chiama una view «speciale» con un errore 404.) Questo procedimento è molto veloce, perché i percorsi sono compilati in espressioni regolari al momento del caricamento.
\nUna volta che c’è corrispondenza con il pattern della URL, Django chiama la view corrispondente, il quale è una funzione Python. A ogni view viene passato un oggetto request - che contiene i metadati della richiesta - e i valori catturati nel pattern URL.
\nPer esempio, se un utente richiedesse la URL «/articles/2005/05/39323/», Django chiamerebbe la funzione news.views.article_detail(request, year=2005, month=5, pk=39323).
Ogni view è responsabile nel fare una di queste due cose: Ritornare un’istanza della classe HttpResponse che contiene il contenuto della pagina richiesta, o lancia un’eccezione come Http404. Il resto dipende da te.
Genericamente, una view riceve dati in base ai parametri passati, carica e renderizza il template con i dati ricevuti.\nEcco una view di esempio per year_archive sopra citata:
mysite/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)\nQuesto esempio usa Django’s template system, il quale ha una serie di potenti caratteristiche, ma prova a rimanere abbastanza semplice per un uso per i non-programmatori.
\nIl codice precedente carica il template news/year_archive.html.
Django ha un percorso di ricerca dei template, il quale ti permette di ridurre la ridondanza nei vari template. Nella tua configurazione di Django, specifica una lista di cartelle da controllare tramite la configurazione :setting:`DIRS per la ricerca dei template. Se un template non esiste nella prima cartella, controlla la seconda e così via.
\nDiciamo che news/year_archive.html sia stato trovato. Ecco come potrebbe essere:
mysite/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 %}\nLe variabili sono delimitate da doppie parentesi graffe. {{ article.headline }} significa «Mostra il valore dell’attributo headline dell’articolo.» Ma i punti non sono usati sono per accedere a un attributo. Possono essere usati anche per accedere a una chiave di un dizionario, un indice o una chiamata a una funzione.
Nota che {{ article.pub_date|date:"F j, Y" }} usa una «pipe» (il carattere «|») in stile Unix . Questo è un filtro del template ed è un modo per filtrare il valore di una variabile. In questo caso, il filtro data formatta un oggetto Python di tipo datetime nel formato dato (come si trova nella funzione data di PHP).
Puoi concatenare tutti i filtri che desideri. Puoi scrivere filtri di template personalizzati. Puoi scrivere tag di template personalizzati, che eseguono codice Python personalizzato dietro le quinte.
\nInfine, Django usa il concetto di «template inheritance». Questo è ciò che fa {% extends "base.html" %}. Significa «Prima carica il template chiamato “base”, nel quale sono definiti un mucchio di blocchi, e riempi i blocchi con quelli seguenti.» In breve, questo permette di ridurre drasticamente la ridondanza nei template: ogni template deve definire solo ciò che è unico per quel template.
Ecco come dovrebbe essere il template «base.html», compreso l’uso di: static files:
\nmysite/templates/base.html{% load static %}\n<html>\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>\nSemplicemente, definisce la grafica generale del sito (con il logo), e fornisce dei «buchi» da riempire da parte dei template figli. Questo significa che il sito può essere ridisegnato modificando un unico file – il template di base.
\nTi permette anche di creare versione multiple del sito, con template di base differenti mentre riutilizzi i template figlio. I creatori di Django hanno utilizzato questa tecnica per creare versioni per dispositivi mobile soprendentemente diversi giusto creando un nuovo base template.
\nNon sei costretto ad utilizzare il linguaggio di template di Django se ne preferisci un altro.\nAnche se il linguaggio di template di Django è particolarmente ben integrato con i modelli di Django, nessuno ti obbliga ad utilizzarlo. A questo proposito, non sei obbligato ad utilizzare nemmeno il Django database API. Puoi utilizzare qualsiasi livello di astrazione per i database, puoi leggere file XML, puoi leggere file sul disco, o qualsiasi cosa tu voglia.\nQualsiasi pezzo di Django (models, views, templates) lavorano indipendentemente dagli altri pezzi.
\nQuesta è stata solo una breve panoramica sulle funzionalità di Django. Maggiori funzionalità :
\nUn framework per la cache che si integra con memcached o altri backend.
Un framework per la syndication che ti permette di creare feed RSS e Atom scrivendo una piccola classe Python.
Più attraenti funzionalità di amministrazione generate automaticamente – questa panoramica ha appena scalfito la superficie.
I prossimi passi per te sono scaricare Django, leggere the tutorial e unirti alla` comunità`_. Grazie per il tuo interesse!
\n